1 # Buildsheet autogenerated by ravenadm tool -- Do not edit.
7 SDESC[v11]= AWS SDK for Python (3.11)
8 SDESC[v12]= AWS SDK for Python (3.12)
9 HOMEPAGE= https://github.com/boto/boto3
10 CONTACT= Python_Automaton[python@ironwolf.systems]
13 SITES[main]= PYPIWHL/a8/ec/5cf74e265bb3fc764cf475cd6208e4d189d4e7938c39f7e499894fa5054d
14 DISTFILE[1]= boto3-1.34.49-py3-none-any.whl:main
19 OPTIONS_AVAILABLE= PY311 PY312
20 OPTIONS_STANDARD= none
21 VOPTS[v11]= PY311=ON PY312=OFF
22 VOPTS[v12]= PY311=OFF PY312=ON
24 DISTNAME= boto3-1.34.49.dist-info
28 [PY311].RUN_DEPENDS_ON= python-botocore:single:v11
29 python-jmespath:single:v11
30 python-s3transfer:single:v11
31 [PY311].USES_ON= python:v11,wheel
33 [PY312].RUN_DEPENDS_ON= python-botocore:single:v12
34 python-jmespath:single:v12
35 python-s3transfer:single:v12
36 [PY312].USES_ON= python:v12,wheel
38 [FILE:2520:descriptions/desc.single]
39 ===============================
40 Boto3 - The AWS SDK for Python
41 ===============================
43 |Version| |Python| |License|
45 Boto3 is the Amazon Web Services (AWS) Software Development Kit (SDK) for
46 Python, which allows Python developers to write software that makes use
47 of services like Amazon S3 and Amazon EC2. You can find the latest, most
48 up to date, documentation at our `doc site`_, including a list of
49 services that are supported.
51 Boto3 is maintained and published by `Amazon Web Services`_.
53 Boto (pronounced boh-toh) was named after the fresh water dolphin native to
54 the Amazon river. The name was chosen by the author of the original Boto
55 library, Mitch Garnaat, as a reference to the company.
60 On 2023-12-13, support for Python 3.7 ended for Boto3. This follows the
61 Python Software Foundation [end of support]
62 for the runtime which occurred on 2023-06-27.
63 For more information, see this [blog post].
71 Assuming that you have a supported version of Python installed, you can
73 set up your environment with:
77 $ python -m venv .venv
79 $ . .venv/bin/activate
81 Then, you can install boto3 from PyPI with:
85 $ python -m pip install boto3
87 or install from source with:
91 $ git clone https://github.com/boto/boto3.git
93 $ python -m pip install -r requirements.txt
94 $ python -m pip install -e .
98 After installing boto3
100 Next, set up credentials (in e.g. ``~/.aws/credentials``):
105 aws_access_key_id = YOUR_KEY
106 aws_secret_access_key = YOUR_SECRET
108 Then, set up a default region (in e.g. ``~/.aws/config``):
115 Other credential configuration methods can be found [here]
117 Then, from a Python interpreter:
119 .. code-block:: python
122 >>> s3 = boto3.resource('s3')
123 >>> for bucket in s3.buckets.all():
128 You can run tests in all supported Python versions using tox. By default,
129 it will run all of the unit and functional tests, but you can also specify
131 pytest options. Note that this requires that you have all supported
132 versions of Python installed, otherwise you must pass ``-e or run the
133 pytest`` command directly:
138 $ tox -- unit/test_session.py
142 ce8d1de03024f52a1810e8d71ad4dba3a5b9bb48b35567191500e3432a9130b4 139323 boto3-1.34.49-py3-none-any.whl