/ccat

stream objects from S3 to STDOUT

Primary LanguageGoMIT LicenseMIT

Build Status

cloud cat

Inspired by the cat Unix command, cloud cat (ccat) can stream one or more objects from the Amazon Web Services (AWS) Simple Storage Service (S3) and print the results to STDOUT.

Because cloud cat streams the objects, not downloads, you can work with large objects in S3 as if they're local without having to worry about the amount of space you have on your local disk.

CLI Usage

NAME:
   ccat - cloud cat

 Stream objects from S3 to STDOUT

USAGE:
   ccat s3://your-bucket/your-key https://s3-us-west-2.amazonaws.com/your-bucket/your-other-key

GLOBAL OPTIONS:
   --profile value, -p value  AWS Profile to use when creating clients
   --help, -h                 show this help message
   --verbose                  log verbosely to stderr

Examples

Print an object to STDOUT

ccat s3://your-bucket/your-key.json

Print an object with an S3 URL to STDOUT

ccat https://s3-us-west-2.amazonaws.com/your-bucket/your-key.json

Print multiple objects to STDOUT

ccat s3://your-bucket/your-key.json s3://your-bucket/your-other-key.json

Print a gzipped object to STDOUT

ccat s3://your-bucket/your-key.json.gz | zcat

Print all objects under a prefix to STDOUT

ccat s3://your-bucket/your-prefix/