|new 7.0.0||Jan 11, 2022|
|6.3.0||Dec 7, 2021|
|6.2.0||Dec 2, 2021|
|6.1.2||Nov 3, 2021|
|6.1.1||Oct 28, 2021|
#422 in Command line utilities
107 downloads per month
Extremely simple (memory stable) S3 client that supports get, put, head, list, and sync.
esthri 6.3.0 Simple S3 file transfer utility. USAGE: esthri <SUBCOMMAND> FLAGS: -h, --help Prints help information -V, --version Prints version information SUBCOMMANDS: abort Manually abort a multipart upload etag Compute and print the S3 ETag of the file get Download an object from S3 head-object Retreive the ETag for a remote object help Prints this message or the help of the given subcommand(s) list-objects List remote objects in S3 put Upload an object to S3 serve Launch an HTTP server attached to the specified bucket sync Sync a directory with S3
The esthri CLI tool additionally provides a AWS CLI compatibility mode where it
is able to handle
sync operations with an identical CLI interface as
aws s3 tool. Currently, only the basic case is implemented for these
commands and only some optional arguments are handled.
To use, the esthri binary must either be:
- Named or hard-linked as
- Run with the
ESTHRI_AWS_COMPAT_MODEenvironment variable set
In this mode, esthri will attempt to transparently invoke the real
aws tool if
it encounters a command it cannot handle. For this to work, the path to the real
aws tool should be put in an environment variable named
ETHRI_AWS_PATH=/usr/bin/aws. If this environment variable is not
specified then esthri will default to invoking
aws.real as the
$ ln -s /usr/local/bin/aws /usr/local/bin/aws.real $ ESTHRI_AWS_COMPAT_MODE=1 esthri s3 help # prints the S3 help text, as generated by the aws command
esthri can transparently compress files such that they are compressed within S3
but not on the local filesystem. To enable, either set the
ESTHRI_AWS_COMPAT_MODE_COMPRESSION environment variable or use the
--transparent-compression CLI option. For example:
ESTHRI_AWS_COMPAT_MODE=1 esthri s3 sync mydirectory/ s3://esthri-test/myfiles/ --transparent-compression # syncs as normal, however files in S3 are gzipped ESTHRI_AWS_COMPAT_MODE=1 esthri s3 sync s3://esthri-test/myfiles/ mynewdirectory/ --transparent-compression # syncs and decompresses files as they are synced down. mydirectory and mynewdirectory will now contain the same files
esthri makes use of S3 metadata to do this transparent compression, storing the esthri version number in the metadata of files it has compressed. For this reason, the decompression will only work for files that esthri has compressed itself.
To perform a release, run
cargo release <release-level> -x.
Copyright (C) 2021 Swift Navigation Inc. Contact: Swift Navigation <firstname.lastname@example.org> This source is subject to the license found in the file 'LICENSE' which must be be distributed together with this source. All other rights reserved. THIS CODE AND INFORMATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A PARTICULAR PURPOSE.