1 # Buildsheet autogenerated by ravenadm tool -- Do not edit.
7 SDESC[py310]= AWS SDK for Python (3.10)
8 SDESC[v11]= AWS SDK for Python (3.11)
9 HOMEPAGE= https://github.com/boto/boto3
10 CONTACT= Python_Automaton[python@ironwolf.systems]
13 SITES[main]= PYPIWHL/f8/fd/ccca7ea099b619c6951c6140ce381a2622f7033a8ac5613fc41d62394259
14 DISTFILE[1]= boto3-1.26.142-py3-none-any.whl:main
19 OPTIONS_AVAILABLE= PY310 PY311
20 OPTIONS_STANDARD= none
21 VOPTS[py310]= PY310=ON PY311=OFF
22 VOPTS[v11]= PY310=OFF PY311=ON
24 DISTNAME= boto3-1.26.142.dist-info
28 [PY310].RUN_DEPENDS_ON= python-botocore:single:py310
29 python-jmespath:single:py310
30 python-s3transfer:single:py310
31 [PY310].USES_ON= python:py310,wheel
33 [PY311].RUN_DEPENDS_ON= python-botocore:single:v11
34 python-jmespath:single:v11
35 python-s3transfer:single:v11
36 [PY311].USES_ON= python:v11,wheel
38 [FILE:2692: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 2021-01-15, deprecation for Python 2.7 was announced and support was
62 on 2021-07-15. To avoid disruption, customers using Boto3 on Python 2.7 may
63 need to upgrade their version of Python or pin the version of Boto3. For
64 more information, see this [blog post].
66 On 2022-05-30, support for Python 3.6 was ended. This follows the
67 Python Software Foundation [end of support]
68 for the runtime which occurred on 2021-12-23.
69 For more information, see this [blog post].
77 Assuming that you have a supported version of Python installed, you can
79 set up your environment with:
83 $ python -m venv .venv
85 $ . .venv/bin/activate
87 Then, you can install boto3 from PyPI with:
91 $ python -m pip install boto3
93 or install from source with:
97 $ git clone https://github.com/boto/boto3.git
99 $ python -m pip install -r requirements.txt
100 $ python -m pip install -e .
104 After installing boto3
106 Next, set up credentials (in e.g. ``~/.aws/credentials``):
111 aws_access_key_id = YOUR_KEY
112 aws_secret_access_key = YOUR_SECRET
114 Then, set up a default region (in e.g. ``~/.aws/config``):
121 Other credentials configuration method can be found [here]
123 Then, from a Python interpreter:
125 .. code-block:: python
128 >>> s3 = boto3.resource('s3')
129 >>> for bucket in s3.buckets.all():
134 You can run tests in all supported Python versions using tox. By default,
135 it will run all of the unit and functional tests, but you can also specify
137 pytest options. Note that this requires that you have all supported
138 versions of Python installed, otherwise you must pass ``-e or run the
142 8b8ccbb42e5c4008086a187afee98f4a10d5d985892699b9e2f1e6c5b18a7754 135594 boto3-1.26.142-py3-none-any.whl