Skip to main content

s3url is a simple command line utility for generating time-sensitive, sharable urls for private s3 files.

### Examples

Generate a signed URL valid for 24 hours to download file/to/share.txt from the bucket named my-bucket:

$ s3url my-bucket/file/to/share.txt

Also accepts s3:// style URIs:

$ s3url s3://my-bucket/file/to/share.txt

Or http(s):// URIs (with the bucket as the subdomain or in the path):

$ s3url http://s3.amazonaws.com/my-bucket/file/to/share.txt $ s3url https://my-bucket.s3.amazonaws.com/file/to/share.txt

Specify the time until expiration (1 hour and 30 minutes from now):

$ s3url -e 1h30m my-bucket/file/to/share.txt

AWS credentials are loaded from environment variables by default. Export the variables AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY. To specify them at the command line, use:

$ s3url -k YourAccessKeyId:YourSecretAccessKey my-bucket/file/to/share.txt

### Installation

$ pip install s3url

### License

Copyright © 2014 Ford Hurley <ford.hurley@gmail.com>

This work is free. You can redistribute it and/or modify it under the terms of the Do What The Fuck You Want To Public License, Version 2, as published by Sam Hocevar. See the COPYING file for more details.

[![PyPI version](http://img.shields.io/pypi/v/s3url.svg)](https://pypi.python.org/pypi/s3url)

![Build status](https://www.codeship.io/projects/eafe1020-a532-0131-51d0-3e9695abd440/status)

Release files for s3url 0.1.6

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for s3url 0.1.6
File Size Uploaded
s3url-0.1.6.tar.gz 4.3 kB Details

Release files / s3url-0.1.6.tar.gz

Download URL s3url-0.1.6.tar.gz
Size 4.3 kB
Tags Source
SHA-256 checksum
How to use checksums
5d6aa0792da53bafd39250a0c0d3c5cd9fedaa625122c31c0134a21445e97b95
BLAKE2b-256 checksum
How to use checksums
97d09c38b8769b1b526fb35e1c663b2482f10d789f864230c8a96057d0da63f6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release history Release notifications | RSS feed

This release

0.1.6 This release

1 release file

0.1.5

1 release file

0.1.4

1 release file

0.1.3

1 release file

0.1.2

1 release file

0.1.1

1 release file

0.1.0

1 release file

0.0.1

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page