botocore

The low-level, core functionality of boto3 and the AWS CLI.

https://github.com/boto/botocore

Science Score: 26.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
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (15.2%) to scientific vocabulary

Keywords from Contributors

cloud-management aws-sdk aws-cli unit-testing tensors yapf pre-commit-hook gofmt formatter aiohttp
Last synced: 10 months ago · JSON representation

Repository

The low-level, core functionality of boto3 and the AWS CLI.

Basic Info
  • Host: GitHub
  • Owner: boto
  • License: apache-2.0
  • Language: Python
  • Default Branch: develop
  • Homepage:
  • Size: 354 MB
Statistics
  • Stars: 1,577
  • Watchers: 69
  • Forks: 1,136
  • Open Issues: 171
  • Releases: 0
Created over 13 years ago · Last pushed 10 months ago
Metadata Files
Readme Changelog Contributing License Code of conduct Security Notice

README.rst

botocore
========

|Version| |Python| |License|

A low-level interface to a growing number of Amazon Web Services. The
botocore package is the foundation for the
`AWS CLI `__ as well as
`boto3 `__.

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

Notices
-------

On 2025-04-22, support for Python 3.8 ended for Botocore. 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 `__.

.. _`Amazon Web Services`: https://aws.amazon.com/what-is-aws/
.. |Python| image:: https://img.shields.io/pypi/pyversions/botocore.svg?style=flat
    :target: https://pypi.python.org/pypi/botocore/
    :alt: Python Versions
.. |Version| image:: http://img.shields.io/pypi/v/botocore.svg?style=flat
    :target: https://pypi.python.org/pypi/botocore/
    :alt: Package Version
.. |License| image:: http://img.shields.io/pypi/l/botocore.svg?style=flat
    :target: https://github.com/boto/botocore/blob/develop/LICENSE.txt
    :alt: License

Getting Started
---------------
Assuming that you have Python and ``virtualenv`` installed, set up your environment and install the required dependencies like this or you can install the library using ``pip``:

.. code-block:: sh

    $ git clone https://github.com/boto/botocore.git
    $ cd botocore
    $ python -m venv .venv
    ...
    $ source .venv/bin/activate
    $ python -m pip install -r requirements.txt
    $ python -m pip install -e .

.. code-block:: sh

    $ pip install botocore

Using Botocore
~~~~~~~~~~~~~~
After installing botocore

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 credentials configuration method can be found `here `__

Then, from a Python interpreter:

.. code-block:: python

    >>> import botocore.session
    >>> session = botocore.session.get_session()
    >>> client = session.create_client('ec2')
    >>> print(client.describe_instances())


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. Please note many of the same resources available for ``boto3`` are
applicable for ``botocore``:

* 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
----------------------------------------------

Botocore 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 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

Committers

Last synced: about 1 year ago

All Time
  • Total Commits: 8,616
  • Total Committers: 207
  • Avg Commits per committer: 41.623
  • Development Distribution Score (DDS): 0.529
Past Year
  • Commits: 816
  • Committers: 18
  • Avg Commits per committer: 45.333
  • Development Distribution Score (DDS): 0.156
Top Committers
Name Email Commits
aws-sdk-python-automation g****n@a****m 4,059
James Saryerwinnie js@j****m 1,059
awstools a****r@a****m 714
kyleknap k****p@a****m 461
AWS a****s@a****m 337
Mitch Garnaat m****h@g****m 283
JordonPhillips p****n@a****m 267
Jordan Guymon j****d@g****m 247
Nate Prewitt n****t@g****m 212
Ray Luo r****o@a****m 105
stealthycoin s****n 92
Daniel G. Taylor d****r@g****m 82
Michael Dowling m****g@g****m 43
Jonas Neubert j****u@a****m 38
dependabot[bot] 4****] 38
jonathan343 4****3 36
Kenneth Daily k****y@a****m 32
David Miller 4****3 32
Daniel Lindsley d****l@t****m 28
Zidaan Dutta z****a@a****m 26
SamRemis s****4@g****m 21
jcarlyl j****l@a****m 20
George Yoshida d****n@g****m 18
Donald Stufft d****d@s****o 15
sweta d****t@a****m 13
Illia Batozskyi i****z@a****m 12
Alessandra Romero 2****o 11
Steve Yoo h****o@a****m 10
Ujjwal 1****a 9
swetashre 4****e 8
and 177 more...

Issues and Pull Requests

Last synced: 10 months ago

All Time
  • Total issues: 301
  • Total pull requests: 732
  • Average time to close issues: 7 months
  • Average time to close pull requests: 5 months
  • Total issue authors: 283
  • Total pull request authors: 145
  • Average comments per issue: 4.9
  • Average comments per pull request: 1.24
  • Merged pull requests: 420
  • Bot issues: 0
  • Bot pull requests: 84
Past Year
  • Issues: 85
  • Pull requests: 368
  • Average time to close issues: 20 days
  • Average time to close pull requests: 8 days
  • Issue authors: 80
  • Pull request authors: 49
  • Average comments per issue: 1.91
  • Average comments per pull request: 0.66
  • Merged pull requests: 215
  • Bot issues: 0
  • Bot pull requests: 47
Top Authors
Issue Authors
  • benkehoe (4)
  • Veetaha (2)
  • vemel (2)
  • epicserve (2)
  • pcjedi (2)
  • MartinNowak (2)
  • jamesls (2)
  • bblommers (2)
  • tibbe (2)
  • acdha (2)
  • colinbjohnson (2)
  • HectorBst (2)
  • copumpkin (2)
  • kloczek (2)
  • rustyconover (2)
Pull Request Authors
  • nateprewitt (115)
  • dependabot[bot] (84)
  • SamRemis (66)
  • jonathan343 (51)
  • alexgromero (45)
  • ubaskota (28)
  • dlm6693 (25)
  • kdaily (25)
  • hssyoo (18)
  • jonemo (14)
  • arandito (13)
  • adev-code (11)
  • akx (8)
  • tim-finnigan (8)
  • aemous (7)
Top Labels
Issue Labels
bug (136) feature-request (105) p2 (76) p3 (70) needs-triage (68) response-requested (54) closed-for-staleness (41) s3 (27) service-api (21) documentation (20) third-party (18) duplicate (16) needs-review (15) closing-soon (12) credentials (11) dependencies (11) waiter (10) enhancement (10) investigating (9) configuration (9) guidance (7) potential-regression (6) p1 (6) sqs (5) sts (5) paginator (5) certs (4) endpoints (4) stubber (4) automation-exempt (4)
Pull Request Labels
dependencies (84) github_actions (47) python (11) needs-review (7) response-requested (6) pr/needs-review (5) automation-exempt (2) enhancement (2) feature-request (2) documentation (2) s3 (2)

Packages

  • Total packages: 24
  • Total downloads:
    • pypi 562,457,724 last-month
  • Total docker downloads: 5,354,748,349
  • Total dependent packages: 1,070
    (may contain duplicates)
  • Total dependent repositories: 61,250
    (may contain duplicates)
  • Total versions: 3,676
  • Total maintainers: 7
pypi.org: botocore

Low-level, data-driven core of boto 3.

  • Versions: 2,225
  • Dependent Packages: 979
  • Dependent Repositories: 60,835
  • Downloads: 562,457,705 Last month
  • Docker Downloads: 5,354,748,349
Rankings
Downloads: 0.0%
Docker downloads count: 0.0%
Dependent repos count: 0.0%
Dependent packages count: 0.0%
Average: 0.7%
Forks count: 1.7%
Stargazers count: 2.5%
Maintainers (2)
Last synced: over 1 year ago
alpine-v3.18: py3-botocore-pyc

Precompiled Python bytecode for py3-botocore

  • Versions: 1
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent repos count: 0.0%
Dependent packages count: 0.0%
Forks count: 1.8%
Average: 2.2%
Stargazers count: 6.9%
Maintainers (1)
Last synced: 10 months ago
alpine-v3.18: py3-botocore

The low-level, core functionality of Boto3

  • Versions: 1
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent repos count: 0.0%
Dependent packages count: 0.0%
Forks count: 1.8%
Average: 2.2%
Stargazers count: 6.9%
Maintainers (1)
Last synced: 10 months ago
alpine-v3.22: py3-botocore

The low-level, core functionality of Boto3

  • Versions: 1
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent repos count: 0.0%
Dependent packages count: 0.0%
Forks count: 2.0%
Average: 2.7%
Stargazers count: 9.0%
Maintainers (1)
Last synced: 10 months ago
alpine-v3.22: py3-botocore-pyc

Precompiled Python bytecode for py3-botocore

  • Versions: 1
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent repos count: 0.0%
Dependent packages count: 0.0%
Forks count: 2.0%
Average: 2.7%
Stargazers count: 9.0%
Maintainers (1)
Last synced: 10 months ago
alpine-v3.15: py3-botocore

The low-level, core functionality of Boto3

  • Versions: 1
  • Dependent Packages: 4
  • Dependent Repositories: 0
Rankings
Dependent repos count: 0.0%
Forks count: 1.6%
Average: 3.3%
Stargazers count: 5.0%
Dependent packages count: 6.5%
Maintainers (1)
Last synced: 10 months ago
alpine-v3.17: py3-botocore

The low-level, core functionality of Boto3

  • Versions: 1
  • Dependent Packages: 6
  • Dependent Repositories: 0
Rankings
Dependent repos count: 0.0%
Forks count: 1.7%
Average: 3.5%
Dependent packages count: 5.7%
Stargazers count: 6.8%
Maintainers (1)
Last synced: 10 months ago
alpine-v3.13: py3-botocore

The low-level, core functionality of Boto3

  • Versions: 1
  • Dependent Packages: 1
  • Dependent Repositories: 0
Rankings
Dependent repos count: 0.0%
Forks count: 1.6%
Average: 3.9%
Stargazers count: 4.6%
Dependent packages count: 9.4%
Maintainers (1)
Last synced: 10 months ago
alpine-edge: py3-botocore

The low-level, core functionality of Boto3

  • Versions: 47
  • Dependent Packages: 1
  • Dependent Repositories: 0
Rankings
Dependent repos count: 0.0%
Forks count: 1.7%
Average: 4.0%
Dependent packages count: 6.0%
Stargazers count: 8.4%
Maintainers (1)
Last synced: 10 months ago
spack.io: py-botocore

Low-level, data-driven core of boto 3.

  • Versions: 26
  • Dependent Packages: 7
  • Dependent Repositories: 0
Rankings
Dependent repos count: 0.0%
Forks count: 2.7%
Average: 4.4%
Stargazers count: 6.6%
Dependent packages count: 8.4%
Maintainers (1)
Last synced: 10 months ago
conda-forge.org: botocore

Provides the core functionality of Boto3, the AWS SDK for Python

  • Versions: 1,143
  • Dependent Packages: 54
  • Dependent Repositories: 207
Rankings
Dependent packages count: 1.4%
Dependent repos count: 2.3%
Forks count: 4.8%
Average: 4.9%
Stargazers count: 11.2%
Last synced: 10 months ago
alpine-edge: py3-botocore-pyc

Precompiled Python bytecode for py3-botocore

  • Versions: 32
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent repos count: 0.0%
Forks count: 1.8%
Average: 6.2%
Stargazers count: 8.5%
Dependent packages count: 14.4%
Maintainers (1)
Last synced: 10 months ago
alpine-v3.16: py3-botocore

The low-level, core functionality of Boto3

  • Versions: 1
  • Dependent Packages: 3
  • Dependent Repositories: 0
Rankings
Dependent repos count: 0.0%
Forks count: 1.5%
Stargazers count: 5.3%
Average: 6.4%
Dependent packages count: 18.7%
Maintainers (1)
Last synced: 10 months ago
alpine-v3.12: py3-botocore

The low-level, core functionality of Boto3

  • Versions: 1
  • Dependent Packages: 3
  • Dependent Repositories: 0
Rankings
Dependent repos count: 0.0%
Forks count: 1.6%
Stargazers count: 4.1%
Average: 6.8%
Dependent packages count: 21.5%
Maintainers (1)
Last synced: 10 months ago
alpine-v3.14: py3-botocore

The low-level, core functionality of Boto3

  • Versions: 1
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent repos count: 0.0%
Forks count: 1.6%
Stargazers count: 4.7%
Average: 7.0%
Dependent packages count: 21.7%
Maintainers (1)
Last synced: 10 months ago
pypi.org: botocoree

Low-level, data-driven core of boto 3.

  • Versions: 1
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Forks count: 1.2%
Stargazers count: 1.7%
Dependent packages count: 5.7%
Average: 9.9%
Dependent repos count: 30.9%
Maintainers (1)
Last synced: over 1 year ago
anaconda.org: botocore

Provides the core functionality of Boto3, the AWS SDK for Python

  • Versions: 184
  • Dependent Packages: 12
  • Dependent Repositories: 207
Rankings
Dependent packages count: 3.2%
Forks count: 11.1%
Average: 12.2%
Dependent repos count: 13.4%
Stargazers count: 21.1%
Last synced: 10 months ago
pypi.org: botocore-meiqia

Low-level, data-driven core of boto 3.

  • Versions: 2
  • Dependent Packages: 0
  • Dependent Repositories: 1
  • Downloads: 19 Last month
Rankings
Forks count: 1.3%
Stargazers count: 1.8%
Dependent packages count: 7.3%
Average: 17.0%
Dependent repos count: 22.1%
Downloads: 52.7%
Maintainers (1)
Last synced: 10 months ago
alpine-v3.20: py3-botocore

The low-level, core functionality of Boto3

  • Versions: 1
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent repos count: 0.0%
Dependent packages count: 0.0%
Average: 100%
Maintainers (1)
Last synced: 10 months ago
alpine-v3.19: py3-botocore-pyc

Precompiled Python bytecode for py3-botocore

  • Versions: 1
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent repos count: 0.0%
Dependent packages count: 0.0%
Average: 100%
Last synced: 10 months ago
alpine-v3.19: py3-botocore

The low-level, core functionality of Boto3

  • Versions: 1
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent repos count: 0.0%
Dependent packages count: 0.0%
Average: 100%
Last synced: 10 months ago
alpine-v3.21: py3-botocore-pyc

Precompiled Python bytecode for py3-botocore

  • Versions: 1
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent repos count: 0.0%
Dependent packages count: 0.0%
Average: 100%
Maintainers (1)
Last synced: 10 months ago
alpine-v3.20: py3-botocore-pyc

Precompiled Python bytecode for py3-botocore

  • Versions: 1
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent repos count: 0.0%
Dependent packages count: 0.0%
Average: 100%
Maintainers (1)
Last synced: 10 months ago
alpine-v3.21: py3-botocore

The low-level, core functionality of Boto3

  • Versions: 1
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent repos count: 0.0%
Dependent packages count: 0.0%
Average: 100%
Maintainers (1)
Last synced: 10 months ago

Dependencies

.github/workflows/closed-issue-message.yml actions
  • aws-actions/closed-issue-message v1 composite
.github/workflows/lint.yml actions
  • actions/checkout v3 composite
  • actions/setup-python v4 composite
  • pre-commit/action v3.0.0 composite
.github/workflows/run-crt-test.yml actions
  • actions/checkout v3 composite
  • actions/setup-python v4 composite
.github/workflows/run-tests.yml actions
  • actions/checkout v3 composite
  • actions/setup-python v4 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
  • behave ==1.2.5 development
  • colorama ==0.4.5 development
  • coverage ==5.5 development
  • execnet ==1.9.0 development
  • importlib-metadata ==4.12.0 development
  • iniconfig ==1.1.1 development
  • jsonschema ==2.5.1 development
  • packaging ==21.3 development
  • parse ==1.19.0 development
  • parse-type ==0.6.0 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
  • pytest-forked ==1.4.0 development
  • pytest-xdist ==2.4.0 development
  • six ==1.16.0 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
  • behave ==1.2.5 development
  • colorama >0.3.0 development
  • coverage ==5.5 development
  • jsonschema ==2.5.1 development
  • pytest ==7.1.2 development
  • pytest-cov ==2.12.1 development
  • pytest-xdist ==2.4.0 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