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/6c/37/be88f1b285b888878c7aa3191bf640aec332c13b2dd6546b9cda335cc280
14 DISTFILE[1]= boto3-1.28.79-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.28.79.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:2523: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 will end 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 02ce7dcad2d3b054cd99e7ca6df7a708e016a31b1c98b46d8df3b3891070c121 135794 boto3-1.28.79-py3-none-any.whl