Data

Tools

Indexes

Applications

Experiments

Open Source Science

boto3

Boto3, an AWS SDK for Python

https://github.com/boto/boto3

Science Score: 36.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • ○
    CITATION.cff file
  • ✓
    codemeta.json file
    Found codemeta.json file
  • ✓
    .zenodo.json file
    Found .zenodo.json file
  • ○
    DOI references
  • ○
    Academic publication links
  • ✓
    Committers with academic emails
    1 of 161 committers (0.6%) from academic institutions
  • ○
    Institutional organization owner
  • ○
    JOSS paper metadata
  • ○
    Scientific vocabulary similarity
    Low similarity (14.7%) to scientific vocabulary

Keywords

aws aws-sdk cloud cloud-management python

Keywords from Contributors

aws-cli fuzzing asyncio http-client closember property-based-testing distributed unit-testing autopep8 data-mining
Last synced: 6 months ago · JSON representation

Repository

Boto3, an AWS SDK for Python

Basic Info
Statistics
  • Stars: 9,515
  • Watchers: 233
  • Forks: 1,924
  • Open Issues: 185
  • Releases: 14
Topics
aws aws-sdk cloud cloud-management python
Created over 11 years ago · Last pushed 6 months ago
Metadata Files
Readme Changelog Contributing License Code of conduct Security Notice

README.rst 

===============================
Boto3 - The AWS SDK for Python
===============================

|Version| |Python| |License|

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.

Boto3 is maintained and published by `Amazon Web Services`_.

Boto (pronounced boh-toh) was named after the fresh water dolphin native to the Amazon river. The name was chosen by the author of the original Boto library, Mitch Garnaat, as a reference to the company.

Notices
-------

On 2025-04-22, support for Python 3.8 ended for Boto3. This follows the
Python Software Foundation `end of support `__
for the runtime which occurred on 2024-10-07.
For more information, see this `blog post `__.

.. _boto: https://docs.pythonboto.org/
.. _`doc site`: https://boto3.amazonaws.com/v1/documentation/api/latest/index.html
.. _`Amazon Web Services`: https://aws.amazon.com/what-is-aws/
.. |Python| image:: https://img.shields.io/pypi/pyversions/boto3.svg?style=flat
    :target: https://pypi.python.org/pypi/boto3/
    :alt: Python Versions
.. |Version| image:: http://img.shields.io/pypi/v/boto3.svg?style=flat
    :target: https://pypi.python.org/pypi/boto3/
    :alt: Package Version
.. |License| image:: http://img.shields.io/pypi/l/boto3.svg?style=flat
    :target: https://github.com/boto/boto3/blob/develop/LICENSE
    :alt: License

Getting Started
---------------
Assuming that you have a supported version of Python installed, you can first
set up your environment with:

.. code-block:: sh

    $ python -m venv .venv
    ...
    $ . .venv/bin/activate

Then, you can install boto3 from PyPI with:

.. code-block:: sh

    $ python -m pip install boto3

or install from source with:

.. code-block:: sh

    $ git clone https://github.com/boto/boto3.git
    $ cd boto3
    $ python -m pip install -r requirements.txt
    $ python -m pip install -e .


Using Boto3
~~~~~~~~~~~~~~
After installing boto3

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

.. code-block:: ini

    [default]
    aws_access_key_id = YOUR_KEY
    aws_secret_access_key = YOUR_SECRET

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

.. code-block:: ini

   [default]
   region=us-east-1

Other credential configuration methods can be found `here `__

Then, from a Python interpreter:

.. code-block:: python

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

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
``pytest`` options. Note that this requires that you have all supported
versions of Python installed, otherwise you must pass ``-e`` or run the
``pytest`` command directly:

.. code-block:: sh

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

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

.. code-block:: sh

    $ pytest tests/unit


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:

* Ask a question on `Stack Overflow `__ and tag it with `boto3 `__
* Open a support ticket with `AWS Support `__
* If it turns out that you may have found a bug, please `open an issue `__


Contributing
------------

We value feedback and contributions from our community. Whether it's a bug report, new feature, correction, or additional documentation, we welcome your issues and pull requests. Please read through this `CONTRIBUTING `__ document before submitting any issues or pull requests to ensure we have all the necessary information to effectively respond to your contribution.


Maintenance and Support for SDK Major Versions
----------------------------------------------

Boto3 was made generally available on 06/22/2015 and is currently in the full support phase of the availability life cycle.

For information about maintenance and support for SDK major versions and their underlying dependencies, see the following in the AWS SDKs and Tools Shared Configuration and Credentials Reference Guide:

* `AWS SDKs and Tools Maintenance Policy `__
* `AWS SDKs and Tools Version Support Matrix `__


More Resources
--------------

* `NOTICE `__
* `Changelog `__
* `License `__

Owner

  • Name: the boto project
  • Login: boto
  • Kind: organization

GitHub Events

Total
  • Issues event: 368
  • Watch event: 497
  • Delete event: 24
  • Issue comment event: 912
  • Push event: 399
  • Pull request review comment event: 51
  • Pull request review event: 99
  • Pull request event: 110
  • Fork event: 88
  • Create event: 194
Last Year
  • Issues event: 368
  • Watch event: 497
  • Delete event: 24
  • Issue comment event: 912
  • Push event: 399
  • Pull request review comment event: 51
  • Pull request review event: 99
  • Pull request event: 110
  • Fork event: 88
  • Create event: 194

Committers

Last synced: 10 months ago

All Time
  • Total Commits: 4,563
  • Total Committers: 161
  • Avg Commits per committer: 28.342
  • Development Distribution Score (DDS): 0.321
Past Year
  • Commits: 544
  • Committers: 16
  • Avg Commits per committer: 34.0
  • Development Distribution Score (DDS): 0.119
Top Committers
Name Email Commits
aws-sdk-python-automation g****n@a****m 3,099
awstools a****r@a****m 386
Daniel G. Taylor d****r@g****m 218
kyleknap k****p@a****m 191
James Saryerwinnie js@j****m 123
Nate Prewitt n****t@g****m 85
JordonPhillips p****n@a****m 60
dependabot[bot] 4****] 27
jonathan343 4****3 18
AWS a****s@a****m 17
Ray Luo r****o@a****m 15
Steven Calwas s****s@a****m 14
Jordan Guymon j****d@g****m 14
sweta d****t@a****m 14
Eric Shepherd e****h@a****m 13
Tim Finnigan 8****n 13
Thomas Barton t****r@a****m 10
Kenneth Daily k****y 10
Jami Schwarzwalder j****r 9
Michael Dowling m****g@g****m 8
Michihito Shigemura i****e@g****m 8
John Carlyle s****n 7
Ryan F. 7****K 5
David Miller 4****3 5
John L 4****v 5
Jonas Neubert j****u@a****m 4
Alessandra Romero 2****o 4
Jon Dufresne j****e@g****m 4
swetashre 4****e 4
Jim Horng j****g@i****m 4
and 131 more...
Committer Domains (Top 20 + Academic)
amazon.com: 22 cleardata.com: 1 sgoel.org: 1 tomforb.es: 1 adamj.eu: 1 glitterfram.es: 1 mail.dcu.ie: 1 skillup.co: 1 cfpb.gov: 1 rpi.edu: 1 netcracker.com: 1 redhat.com: 1 github.com: 1 neoway.com.br: 1 kpfleming.us: 1 atlassian.com: 1 iress.com: 1 zetaweb.com: 1 archlinux.org: 1 syapse.com: 1

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 824
  • Total pull requests: 295
  • Average time to close issues: 6 months
  • Average time to close pull requests: 5 months
  • Total issue authors: 744
  • Total pull request authors: 77
  • Average comments per issue: 4.4
  • Average comments per pull request: 0.67
  • Merged pull requests: 189
  • Bot issues: 1
  • Bot pull requests: 58
Past Year
  • Issues: 225
  • Pull requests: 132
  • Average time to close issues: 15 days
  • Average time to close pull requests: 8 days
  • Issue authors: 205
  • Pull request authors: 26
  • Average comments per issue: 1.96
  • Average comments per pull request: 0.2
  • Merged pull requests: 89
  • Bot issues: 0
  • Bot pull requests: 36
View more stats
Top Authors
Issue Authors
  • mdavis-xyz (11)
  • corey-cole (7)
  • tim-finnigan (6)
  • ssmails (6)
  • SamStephens (6)
  • RyanFitzSimmonsAK (5)
  • DilLip-Chowdary-Codes (4)
  • austinmw (4)
  • hijaren (3)
  • andreas-lundgren-qlucore (3)
  • daveisfera (3)
  • hb2638 (3)
  • rittneje (3)
  • benkehoe (3)
  • ghost (2)
Pull Request Authors
  • dependabot[bot] (58)
  • nateprewitt (52)
  • jonathan343 (19)
  • tim-finnigan (12)
  • RyanFitzSimmonsAK (9)
  • dlm6693 (8)
  • hssyoo (8)
  • alexgromero (7)
  • shepazon (6)
  • SamRemis (6)
  • alikulka (6)
  • ubaskota (5)
  • jonemo (3)
  • adev-code (3)
  • Communcations (3)
Top Labels
Issue Labels
bug (359) response-requested (231) p2 (203) needs-triage (198) closed-for-staleness (181) p3 (177) feature-request (176) documentation (162) s3 (114) service-api (107) closing-soon (56) investigating (38) guidance (32) dynamodb (31) resources (29) ec2 (26) needs-review (22) pagination (21) question (12) lambda (12) bedrock (12) third-party (12) iam (11) duplicate (11) sqs (11) potential-regression (10) glue (10) bedrock-runtime (9) api-documentation (9) sts (8)
Pull Request Labels
dependencies (58) github_actions (35) python (10) documentation (8) needs-review (6) resources (5) enhancement (3) pr/needs-review (3) s3 (2) bug (2) cloudwatch (2) waiters (2) dynamodb (2) needs-discussion (1) closing-soon (1) closed-for-staleness (1)

Packages

  • Total packages: 14
  • Total downloads:
    • pypi 1,303,648,612 last-month
  • Total docker downloads: 4,411,338,477
  • Total dependent packages: 4,123
    (may contain duplicates)
  • Total dependent repositories: 81,068
    (may contain duplicates)
  • Total versions: 3,129
  • Total maintainers: 4
pypi.org: boto3

The AWS SDK for Python

  • Versions: 1,827
  • Dependent Packages: 3,938
  • Dependent Repositories: 80,369
  • Downloads: 1,303,648,575 Last month
  • Docker Downloads: 4,411,338,477
Rankings
Downloads: 0.0%
Dependent packages count: 0.0%
Docker downloads count: 0.0%
Dependent repos count: 0.0%
Average: 0.2%
Stargazers count: 0.6%
Forks count: 0.6%
Maintainers (1)
aws
Last synced: about 1 year ago
conda-forge.org: boto3

Boto3 makes it easy to integrate you Python application, library or script with AWS services. It allows Python developers to write softare that makes use of services like Amazon S3 and Amazon EC2.

  • Versions: 1,122
  • Dependent Packages: 166
  • Dependent Repositories: 349
Rankings
Dependent packages count: 0.4%
Dependent repos count: 1.6%
Average: 2.1%
Forks count: 3.1%
Stargazers count: 3.4%
Last synced: 6 months ago
spack.io: py-boto3

The AWS SDK for Python.

  • Versions: 19
  • Dependent Packages: 9
  • Dependent Repositories: 0
Rankings
Dependent repos count: 0.0%
Stargazers count: 1.2%
Forks count: 2.0%
Average: 2.7%
Dependent packages count: 7.6%
Maintainers (1)
adamjstewart
Last synced: about 1 year ago
anaconda.org: boto3

Boto3 makes it easy to integrate you Python application, library or script with AWS services. It allows Python developers to write softare that makes use of services like Amazon S3 and Amazon EC2.

  • Versions: 141
  • Dependent Packages: 10
  • Dependent Repositories: 349
Rankings
Dependent packages count: 7.0%
Forks count: 8.2%
Average: 8.4%
Stargazers count: 9.2%
Dependent repos count: 9.4%
Last synced: 6 months ago
pypi.org: botoo

The AWS SDK for Python

  • Versions: 2
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Stargazers count: 0.3%
Forks count: 0.4%
Dependent packages count: 5.7%
Average: 9.3%
Dependent repos count: 30.9%
Maintainers (1)
CyberResearch1
Last synced: about 1 year ago
pypi.org: botoa3

The AWS SDK for Python

  • Versions: 2
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Stargazers count: 0.3%
Forks count: 0.4%
Dependent packages count: 5.7%
Average: 9.3%
Dependent repos count: 30.9%
Last synced: about 1 year ago
pypi.org: botoa

The AWS SDK for Python

  • Versions: 2
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Stargazers count: 0.3%
Forks count: 0.4%
Dependent packages count: 5.7%
Average: 9.3%
Dependent repos count: 30.9%
Maintainers (1)
CyberResearch1
Last synced: about 1 year ago
pypi.org: b3oto3

The AWS SDK for Python

  • Versions: 2
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Stargazers count: 0.3%
Forks count: 0.4%
Dependent packages count: 5.7%
Average: 9.3%
Dependent repos count: 30.9%
Last synced: 6 months ago
pypi.org: botoo3

The AWS SDK for Python

  • Versions: 2
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Stargazers count: 0.3%
Forks count: 0.4%
Dependent packages count: 5.7%
Average: 9.3%
Dependent repos count: 30.9%
Maintainers (1)
CyberResearch1
Last synced: 6 months ago
pypi.org: bot3

The AWS SDK for Python

  • Versions: 2
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Stargazers count: 0.3%
Forks count: 0.4%
Dependent packages count: 5.7%
Average: 9.3%
Dependent repos count: 30.9%
Maintainers (1)
CyberResearch1
Last synced: about 1 year ago
pypi.org: boto33

The AWS SDK for Python

  • Versions: 2
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Stargazers count: 0.3%
Forks count: 0.4%
Dependent packages count: 5.7%
Average: 9.3%
Dependent repos count: 30.9%
Maintainers (1)
CyberResearch1
Last synced: about 1 year ago
pypi.org: bot3o

The AWS SDK for Python

  • Versions: 2
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Stargazers count: 0.3%
Forks count: 0.4%
Dependent packages count: 5.7%
Average: 9.3%
Dependent repos count: 30.9%
Last synced: about 1 year ago
pypi.org: botto3

The AWS SDK for Python

  • Versions: 2
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Downloads: 0
Rankings
Stargazers count: 0.3%
Forks count: 0.4%
Dependent packages count: 4.8%
Dependent repos count: 6.3%
Average: 12.6%
Downloads: 50.9%
Last synced: 6 months ago
pypi.org: boto3-meiqia

The AWS SDK for Python

  • Versions: 2
  • Dependent Packages: 0
  • Dependent Repositories: 1
  • Downloads: 37 Last month
Rankings
Stargazers count: 0.3%
Forks count: 0.4%
Dependent packages count: 7.3%
Average: 13.5%
Dependent repos count: 22.1%
Downloads: 37.5%
Maintainers (1)
meiqia
Last synced: 6 months ago

Dependencies

.github/workflows/closed-issue-message.yml actions
  • aws-actions/closed-issue-message v1 composite
.github/workflows/lint.yml actions
  • actions/checkout v2 composite
  • actions/setup-python v2 composite
  • pre-commit/action v2.0.0 composite
.github/workflows/run-tests.yml actions
  • actions/checkout v2 composite
  • actions/setup-python v2 composite
.github/workflows/stale_issue.yml actions
  • aws-actions/stale-issue-cleanup v4 composite
requirements-dev-lock.txt pypi
  • atomicwrites ==1.4.1 development
  • attrs ==21.4.0 development
  • colorama ==0.4.5 development
  • coverage ==5.5 development
  • importlib-metadata ==4.12.0 development
  • iniconfig ==1.1.1 development
  • packaging ==21.3 development
  • pluggy ==1.0.0 development
  • py ==1.11.0 development
  • pyparsing ==3.0.9 development
  • pytest ==7.1.2 development
  • pytest-cov ==2.12.1 development
  • toml ==0.10.2 development
  • tomli ==2.0.1 development
  • typing-extensions ==4.3.0 development
  • wheel ==0.38.1 development
  • zipp ==3.8.0 development
requirements-dev.txt pypi
  • atomicwrites >=1.0 development
  • colorama >0.3.0 development
  • coverage ==5.5 development
  • pytest ==7.1.2 development
  • pytest-cov ==2.12.1 development
  • wheel ==0.38.1 development
requirements-docs.txt pypi
  • Sphinx >=1.1.3,<=1.3.2
  • docutils >=0.10,<0.17
  • guzzle_sphinx_theme >=0.7.10,<0.8
  • jinja2 >=2.3,<3.0
  • markupsafe >=1.1,<2.0
.github/workflows/codeql.yml actions
  • actions/checkout 8ade135a41bc03ea155e62e844d188df1ea18608 composite
  • github/codeql-action/analyze cdcdbb579706841c47f7063dda365e292e5cad7a composite
  • github/codeql-action/autobuild cdcdbb579706841c47f7063dda365e292e5cad7a composite
  • github/codeql-action/init cdcdbb579706841c47f7063dda365e292e5cad7a composite
.github/workflows/fail-master-prs.yml actions
.github/workflows/handle-stale-discussions.yml actions
  • aws-github-ops/handle-stale-discussions a98e47e10f9a5d4ed08ffb27b7a19454302f9a43 composite
pyproject.toml pypi
requirements.txt pypi
setup.py pypi
.github/workflows/run-crt-test.yml actions
  • actions/checkout 8ade135a41bc03ea155e62e844d188df1ea18608 composite
  • actions/setup-python 0a5c61591373683505ea898e09a3ea4f39ef2b9c composite