Skip to main content

The AWS SDK for Python

Project description

Build Status Version Gitter

Boto3 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 our doc site, including a list of services that are supported.

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. By default, it will run all of the unit and functional 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 -- unit/test_session.py
$ tox -e py26,py33 -- 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 -r requirements-docs.txt
$ cd docs
$ make html

Getting Help

We use GitHub issues for tracking bugs and feature requests and have limited bandwidth to address them. Please use these community resources for getting help:

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-1.12.25.tar.gz (97.8 kB view details)

Uploaded Source

Built Distribution

boto3-1.12.25-py2.py3-none-any.whl (128.6 kB view details)

Uploaded Python 2 Python 3

File details

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

File metadata

  • Download URL: boto3-1.12.25.tar.gz
  • Upload date:
  • Size: 97.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.8.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/40.5.0 requests-toolbelt/0.9.1 clint/0.5.1 CPython/2.7.12 Linux/4.14.165-103.209.amzn1.x86_64

File hashes

Hashes for boto3-1.12.25.tar.gz
Algorithm Hash digest
SHA256 8214f8b384c03c76b3940f7a9a8b7e1dc3d7e43b12029a17fb0e68f29fff4ac3
MD5 7ff12cace72bf7e81e20b2bb969893ac
BLAKE2b-256 5dde6b0b1706c162b1fce4382f6ed8d5cfebe2bd28b2ea3f0d91615f5d1cfaf3

See more details on using hashes here.

File details

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

File metadata

  • Download URL: boto3-1.12.25-py2.py3-none-any.whl
  • Upload date:
  • Size: 128.6 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.8.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/40.5.0 requests-toolbelt/0.9.1 clint/0.5.1 CPython/2.7.12 Linux/4.14.165-103.209.amzn1.x86_64

File hashes

Hashes for boto3-1.12.25-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 5089aada80f023d21a99b7c10b10f0befd223aeeb60266513f322ad6655b5623
MD5 a6b167c7ef6384d9985a6a9b4c2101de
BLAKE2b-256 bbdc7747cca8223bb62b8c2cc7aa65f860a9f0d454fbf8566e6da2d61e27fdcd

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