Allows head or tail of a file on s3 without downloading the whole file
Project description
mous3
A python utility that allows you to print a number of bytes from either the beginning or end of an object stored on AWS S3 without downloading the entire file.
Features
-
AWS Profile Support: Optionally specify an AWS profile to use for accessing the S3 bucket, making it easier to work with multiple AWS accounts or configurations.
-
Flexible Byte Range: Customize the number of bytes you want to read from the end of the object.
Requirements
- Python 3.6+
- Boto3
Installation
-
pip install mous3
-
Your AWS credentials will need to be stored in
~/.aws/credentials
or set as environment variables (AWS_ACCESS_KEY_ID
andAWS_SECRET_ACCESS_KEY
).
Usage
mous3 [-h] [--bytes BYTES] [--profile PROFILE] {direction} {bucket_name} {key}
Positional arguments:
direction
The direction to read from the object. Can be "head" or "tail".
bucket_name
The name of the S3 bucket.
key
The key of the object in the S3 bucket.
Optional arguments:
-h, --help show this help message and exit
--bytes BYTES Number of bytes to download. Default is 1000. You do not need to specify positive or negative, as this is determined by the "direction" argument.
--profile PROFILE The AWS profile to use. Optional.
Examples:
- To print the first 1000 bytes (head) of an object using the AWS profile named
myProfile
:mous3 head my-bucket example.log --profile myProfile
- To print the last 1000 bytes (tail) of an object named
example.log
in the bucketmy-bucket
:mous3 tail my-bucket example.log
- To print the last 200 bytes of the object:
mous3 tail my-bucket example.log --bytes 200
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.