bucket_D9/python-boto3

   1 # Buildsheet autogenerated by ravenadm tool -- Do not edit.
   2
   3 NAMEBASE=               python-boto3
   4 VERSION=                1.28.19
   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/51/85/48dc639c57cb1a25b1f7b3022d2ab982fd97156715cb11f50102cb5c551f
  14 DISTFILE[1]=            boto3-1.28.19-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.28.19.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:2523: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 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].
  64
  65     :alt: Python Versions
  66     :alt: Package Version
  67     :alt: License
  68
  69 Getting Started
  70 ---------------
  71 Assuming that you have a supported version of Python installed, you can
  72 first
  73 set up your environment with:
  74
  75 .. code-block:: sh
  76
  77     $ python -m venv .venv
  78     ...
  79     $ . .venv/bin/activate
  80
  81 Then, you can install boto3 from PyPI with:
  82
  83 .. code-block:: sh
  84
  85     $ python -m pip install boto3
  86
  87 or install from source with:
  88
  89 .. code-block:: sh
  90
  91     $ git clone https://github.com/boto/boto3.git
  92     $ cd boto3
  93     $ python -m pip install -r requirements.txt
  94     $ python -m pip install -e .
  95
  96 Using Boto3
  97 ~~~~~~~~~~~~~~
  98 After installing boto3
  99
 100 Next, set up credentials (in e.g. ``~/.aws/credentials``):
 101
 102 .. code-block:: ini
 103
 104     [default]
 105     aws_access_key_id = YOUR_KEY
 106     aws_secret_access_key = YOUR_SECRET
 107
 108 Then, set up a default region (in e.g. ``~/.aws/config``):
 109
 110 .. code-block:: ini
 111
 112    [default]
 113    region=us-east-1
 114
 115 Other credentials configuration method can be found [here]
 116
 117 Then, from a Python interpreter:
 118
 119 .. code-block:: python
 120
 121     >>> import boto3
 122     >>> s3 = boto3.resource('s3')
 123     >>> for bucket in s3.buckets.all():
 124             print(bucket.name)
 125
 126 Running Tests
 127 ~~~~~~~~~~~~~
 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
 130 your own
 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:
 134
 135 .. code-block:: sh
 136
 137     $ tox
 138     $ tox -- unit/test_session.py
 139
 140
 141 [FILE:109:distinfo]
 142 1bae3e6222c7272af44ab4dc456fc4cb7d2d7044489b7a4a08f9cd0fbad6d213       135752 boto3-1.28.19-py3-none-any.whl
 143