cooper

Command line tools for AWS s3.

https://github.com/heuermh/cooper

Science Score: 44.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
    Found CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
  • Academic publication links
  • Academic email domains
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (8.0%) to scientific vocabulary

Keywords

cli command-line command-line-tool s3
Last synced: 4 months ago · JSON representation ·

Repository

Command line tools for AWS s3.

Basic Info
  • Host: GitHub
  • Owner: heuermh
  • License: apache-2.0
  • Language: Java
  • Default Branch: main
  • Homepage:
  • Size: 88.9 KB
Statistics
  • Stars: 0
  • Watchers: 2
  • Forks: 0
  • Open Issues: 3
  • Releases: 4
Topics
cli command-line command-line-tool s3
Created almost 2 years ago · Last pushed 5 months ago
Metadata Files
Readme Funding License Citation Codemeta

README.md

cooper

Command line tools for AWS s3.


cooper project logo

https://en.wikipedia.org/wiki/Cooper_(profession)

Motivation

Primarily a workaround for this issue:

Broken pipe error when piping "s3 ls" output to grep -q
https://github.com/aws/aws-cli/issues/5899

Hacking cooper

Install

  • JDK 17 or later, https://openjdk.java.net
  • Apache Maven 3.6.3 or later, https://maven.apache.org

To build ```bash $ mvn package

$ export PATH=$PATH:pwd/target/appassembler/bin ```

Using cooper

Usage

```bash $ coop --help USAGE coop [-hV] [COMMAND]

List s3 paths recursively with content sizes.

E.g. $ cat uris.txt | xargs coop ls $ coop ls s3://... | head -n 4 $ coop ls s3://... | grep -m 10 -e '...' $ coop ls s3://... | cut -f 2 | sort -n -r

OPTIONS -h, --help Show this help message and exit. -V, --version Print version information and exit.

COMMANDS ls, list List s3 paths recursively with content sizes. help Display help information about the specified command. generate-completion Generate bash/zsh completion script for coop. ```

At present the only command is ls/list ```bash $ coop ls --help

USAGE coop ls [-hV] [--anonymous] [--human-readable] [--reverse-columns] [--show-header] [--summarize] [--verbose] [--region=] ...

List s3 paths recursively with content sizes.

E.g. $ cat uris.txt | xargs coop ls $ coop ls s3://... | head -n 4 $ coop ls s3://... | grep -m 10 -e '...' $ coop ls s3://... | cut -f 2 | sort -n -r

PARAMETERS ... One or more s3 URIs.

OPTIONS --region= AWS region, default us-east-1. --anonymous Use anonymous AWS credentials. --human-readable Format content sizes in binary multi-byte units. --show-header Show column header row in output. --reverse-columns Reverse the order of output columns. --summarize Summarize counts and sizes per input URI. --verbose Show additional logging messages. -h, --help Show this help message and exit. -V, --version Print version information and exit. ```

Owner

  • Name: Michael L Heuer
  • Login: heuermh
  • Kind: user
  • Location: Minneapolis, MN USA
  • Company: Network.bio

Citation (CITATION.cff)

title: cooper
authors:
  - given-names: Michael
    family-names: Heuer
    orcid: https://orcid.org/0000-0002-9052-6000
cff-version: 1.2.0
message: If you use this software, please cite it using the metadata from this file.
type: software
abstract: Command line tools for AWS s3.
keywords:
  - cli
  - command-line
  - command-line-tool
  - s3
license: Apache-2.0
repository-code: https://github.com/heuermh/cooper
date-released: '2025-03-05'
version: '0.5'
doi: 10.5281/zenodo.14976258

CodeMeta (codemeta.json)

{
  "name": "cooper",
  "@context": "https://w3id.org/codemeta/3.0",
  "applicationCategory": "Data mining",
  "author": [
    {
      "familyName": "Heuer",
      "id": "https://orcid.org/0000-0002-9052-6000",
      "givenName": "Michael",
      "type": "Person"
    }
  ],
  "codeRepository": "https://github.com/heuermh/cooper",
  "dateCreated": "2024-02-26",
  "dateModified": "2025-10-13",
  "datePublished": "2024-06-24",
  "description": "Command line tools for AWS s3.",
  "developmentStatus": "active",
  "downloadUrl": "https://github.com/heuermh/cooper/releases/tag/cooper-0.2",
  "issueTracker": "https://github.com/heuermh/cooper/issues",
  "keywords": [
    "cli",
    "command-line",
    "command-line-tool",
    "s3"
  ],
  "license": "https://spdx.org/licenses/Apache-2.0",
  "programmingLanguage": [
    "Java"
  ],
  "schema:releaseNotes": "## What's Changed\r\n* refactor ls to separate command by @heuermh in https://github.com/heuermh/cooper/pull/10\r\n* Add summarize option to ls by @heuermh in https://github.com/heuermh/cooper/pull/13\r\n\r\n## New Contributors\r\n* @heuermh made their first contribution in https://github.com/heuermh/cooper/pull/10\r\n\r\n**Full Changelog**: https://github.com/heuermh/cooper/compare/cooper-0.1...cooper-0.2",
  "version": "0.7",
  "type": "SoftwareSourceCode",
  "identifier": "10.5281/zenodo.17336394"
}

GitHub Events

Total
  • Create event: 2
  • Issues event: 2
  • Release event: 1
  • Delete event: 1
  • Issue comment event: 1
  • Push event: 24
  • Pull request review event: 1
  • Pull request review comment event: 1
  • Pull request event: 1
Last Year
  • Create event: 2
  • Issues event: 2
  • Release event: 1
  • Delete event: 1
  • Issue comment event: 1
  • Push event: 24
  • Pull request review event: 1
  • Pull request review comment event: 1
  • Pull request event: 1

Issues and Pull Requests

Last synced: 9 months ago

All Time
  • Total issues: 15
  • Total pull requests: 5
  • Average time to close issues: 6 days
  • Average time to close pull requests: about 23 hours
  • Total issue authors: 2
  • Total pull request authors: 3
  • Average comments per issue: 0.67
  • Average comments per pull request: 0.0
  • Merged pull requests: 5
  • Bot issues: 2
  • Bot pull requests: 3
Past Year
  • Issues: 15
  • Pull requests: 5
  • Average time to close issues: 6 days
  • Average time to close pull requests: about 23 hours
  • Issue authors: 2
  • Pull request authors: 3
  • Average comments per issue: 0.67
  • Average comments per pull request: 0.0
  • Merged pull requests: 5
  • Bot issues: 2
  • Bot pull requests: 3
Top Authors
Issue Authors
  • heuermh (14)
  • codefair-app[bot] (1)
Pull Request Authors
  • heuermh (4)
  • codefair-io[bot] (2)
  • codefair-app[bot] (2)
Top Labels
Issue Labels
Pull Request Labels

Dependencies

.github/workflows/ci.yml actions
  • actions/cache v2 composite
  • actions/checkout v2 composite
  • actions/setup-java v2 composite
.github/workflows/deploy.yml actions
  • actions/cache v2 composite
  • actions/checkout v2 composite
  • actions/setup-java v2 composite
pom.xml maven
  • info.picocli:picocli 4.7.5 compile
  • org.slf4j:slf4j-simple 1.7.36
  • software.amazon.awssdk:s3