Ravenports generated: 17 Jun 2023 18:59
[ravenports.git] / bucket_D9 / python-boto3
1 # Buildsheet autogenerated by ravenadm tool -- Do not edit.
2
3 NAMEBASE=               python-boto3
4 VERSION=                1.26.155
5 KEYWORDS=               python
6 VARIANTS=               py310 v11
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]
11
12 DOWNLOAD_GROUPS=        main
13 SITES[main]=            PYPIWHL/e5/3b/919c4a90311d61615db459ac37721164528c7c829e27879b0927d0c0fc47
14 DISTFILE[1]=            boto3-1.26.155-py3-none-any.whl:main
15 DF_INDEX=               1
16 SPKGS[py310]=           single
17 SPKGS[v11]=             single
18
19 OPTIONS_AVAILABLE=      PY310 PY311
20 OPTIONS_STANDARD=       none
21 VOPTS[py310]=           PY310=ON PY311=OFF
22 VOPTS[v11]=             PY310=OFF PY311=ON
23
24 DISTNAME=               boto3-1.26.155.dist-info
25
26 GENERATED=              yes
27
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
32
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
37
38 [FILE:2692:descriptions/desc.single]
39 ===============================
40 Boto3 - The AWS SDK for Python
41 ===============================
42
43 |Version| |Python| |License|
44
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.
50
51 Boto3 is maintained and published by `Amazon Web Services`_.
52
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.
56
57 Notices
58 -------
59
60 On 2021-01-15, deprecation for Python 2.7 was announced and support was
61 dropped
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].
65
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].
70
71     :alt: Python Versions
72     :alt: Package Version
73     :alt: License
74
75 Getting Started
76 ---------------
77 Assuming that you have a supported version of Python installed, you can
78 first
79 set up your environment with:
80
81 .. code-block:: sh
82
83     $ python -m venv .venv
84     ...
85     $ . .venv/bin/activate
86
87 Then, you can install boto3 from PyPI with:
88
89 .. code-block:: sh
90
91     $ python -m pip install boto3
92
93 or install from source with:
94
95 .. code-block:: sh
96
97     $ git clone https://github.com/boto/boto3.git
98     $ cd boto3
99     $ python -m pip install -r requirements.txt
100     $ python -m pip install -e .
101
102 Using Boto3
103 ~~~~~~~~~~~~~~
104 After installing boto3
105
106 Next, set up credentials (in e.g. ``~/.aws/credentials``):
107
108 .. code-block:: ini
109
110     [default]
111     aws_access_key_id = YOUR_KEY
112     aws_secret_access_key = YOUR_SECRET
113
114 Then, set up a default region (in e.g. ``~/.aws/config``):
115
116 .. code-block:: ini
117
118    [default]
119    region=us-east-1
120
121 Other credentials configuration method can be found [here]
122
123 Then, from a Python interpreter:
124
125 .. code-block:: python
126
127     >>> import boto3
128     >>> s3 = boto3.resource('s3')
129     >>> for bucket in s3.buckets.all():
130             print(bucket.name)
131
132 Running Tests
133 ~~~~~~~~~~~~~
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
136 your own
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
139
140
141 [FILE:110:distinfo]
142 dd15823e8c0554d98c18584d9a6a0342c67611c1114ef61495934c2e560f632c       135593 boto3-1.26.155-py3-none-any.whl
143