Skip to main content

The AWS SDK for Python

Project description

Build Status Code Coverage Read the docs Version Python versions

Boto is the Amazon Web Services (AWS) Software Development Kit (SDK) for Python, which allows Python developers to write software that makes use of services like Amazon S3 and Amazon EC2. You can find the latest, most up to date, documentation at Read the Docs, including a list of services that are supported.

Boto 3 is in developer preview. This means that until a 1.0 release occurs, some of the interfaces may change based on your feedback. Once a 1.0 release happens, we guarantee backwards compatibility for all future 1.x.x releases. Try out Boto 3 and give us feedback today!

Quick Start

First, install the library and set a default region:

$ pip install boto3

Next, set up credentials (in e.g. ~/.aws/credentials):

[default]
aws_access_key_id = YOUR_KEY
aws_secret_access_key = YOUR_SECRET

Then, set up a default region (in e.g. ~/.aws/config):

[default]
region=us-east-1

Then, from a Python interpreter:

>>> import boto3
>>> s3 = boto3.resource('s3')
>>> for bucket in s3.buckets.all():
        print(bucket.name)

Development

Getting Started

Assuming that you have Python and virtualenv installed, set up your environment and install the required dependencies like this instead of the pip install boto3 defined above:

$ git clone https://github.com/boto/boto3.git
$ cd boto3
$ virtualenv venv
...
$ . venv/bin/activate
$ pip install -r requirements.txt
$ pip install -e .

Running Tests

You can run tests in all supported Python versions using tox. Be default, it will run all of the unit tests, but you can also specify your own nosetests options. Note that this requires that you have all supported versions of Python installed, otherwise you must pass -e or run the nosetests command directly:

$ tox
$ tox tests/unit/test_session.py
$ tox -e py26,py33 tests/integration

You can also run individual tests with your default Python version:

$ nosetests tests/unit

Generating Documentation

Sphinx is used for documentation. You can generate HTML locally with the following:

$ pip install sphinx sphinx_rtd_theme
$ cd docs
$ make html

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.

Source Distribution

boto3-0.0.18.tar.gz (61.7 kB view details)

Uploaded Source

Built Distribution

boto3-0.0.18-py2.py3-none-any.whl (84.8 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file boto3-0.0.18.tar.gz.

File metadata

  • Download URL: boto3-0.0.18.tar.gz
  • Upload date:
  • Size: 61.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for boto3-0.0.18.tar.gz
Algorithm Hash digest
SHA256 3d58758bb4993d33b5a738546705971f49696386b924d681f70ffe763b64032b
MD5 7a74538df9cb98bd2795653c12f68a9a
BLAKE2b-256 795d52d77eab833e6a98287b9397c53c72b8f578247ff6803cfe5319e5832631

See more details on using hashes here.

File details

Details for the file boto3-0.0.18-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for boto3-0.0.18-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 6f4da8722025120c89480826a862711c6100a5fdd1b883ccc50aa450ca44cde8
MD5 b54f6a7542db890127a0975202ac269b
BLAKE2b-256 f7ff059f9dadacb02b07349e34b3e6f35e5f6e7ad7e0ae76814a532ac17eea19

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page