Skip to main content
Warning: You are using the test version of PyPI. This is a pre-production deployment of Warehouse. Changes made here affect the production instance of TestPyPI (
Help us improve Python packaging - Donate today!

Simple command line utility for uploading files to AWS S3, copying a public link to that file to the clipboard

Project Description

Simple command line utility for uploading files to Amazon Web Services (AWS) Simple Storage Service (S3) and copying a public link to that file to the clipboard.


`zsh pip install rural `


Once rural has been configured, it’s a simple command line interface.

`zsh $ rural myfile.pdf $ pbpaste `

rural also supports piped input, so long as it’s UTF-8 encodable.

`zsh $ < myfile.txt | rural -f myfile.txt $ pbpaste `

To show more information, you can use the –verbose flag.

`zsh $ rural -v -b my-other-bucket myfile2.pdf AWS Access Key ID:      LsUCBGhw7qZZLUmlmhvtX AWS Secret Access Key:  mKDbRLKUmhocgVepept6QRLDv6GkBkNG1AxOnr Bucket: my-other-bucket [========================================] 100% `

For other options, use the `--help` flag.


`rural` requires both an AWS access key ID and AWS secret access key that allow for access to a specified S3 bucket.

You can configure rural with environment variables `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY`, and `RURAL_BUCKET_NAME`. We recommend that you set these in your environment configuration files (e.g. `~/.zshrc`).

`zsh $ export AWS_ACCESS_KEY_ID=LsUCBGhw7qZZLUmlmhvtX $ export AWS_SECRET_ACCESS_KEY=mKDbRLKUmhocgVepept6QRLDv6GkBkNG1AxOnr $ export RURAL_BUCKET_NAME=my-s3-bucket $ rural myfile.pdf $ pbpaste `

Additionally, `rural` configuration can be overridden at runtime.

`zsh $ rural --aws-access-key-id=LsUCBGhw7qZZLUmlmhvtX \ > --aws-secret-access-key=mKDbRLKUmhocgVepept6QRLDv6GkBkNG1AxOnr \ > --bucket-name=my-s3-bucket \ > myfile.pdf $ pbpaste `


`rural` requires Python 2.6 or higher, and might not work on Windows.

Release History

Release History

This version
History Node


Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
rural-0.0.7-cp27-none-macosx_10_10_x86_64.whl (4.8 kB) Copy SHA256 Checksum SHA256 2.7 Wheel Sep 17, 2015
rural-0.0.7.macosx-10.10-x86_64.exe (66.2 kB) Copy SHA256 Checksum SHA256 any Windows Installer Sep 17, 2015
rural-0.0.7.macosx-10.10-x86_64.tar.gz (3.5 kB) Copy SHA256 Checksum SHA256 any Dumb Binary Sep 17, 2015 (4.6 kB) Copy SHA256 Checksum SHA256 Source Sep 17, 2015
rural-0.0.7.tar.gz (4.4 kB) Copy SHA256 Checksum SHA256 Source Sep 17, 2015

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting