Boto3 est le kit de développement logiciel (SDK) Amazon Web Services (AWS) pour Python, qui permet aux développeurs Python d'écrire des logiciels utilisant des services tels qu'Amazon S3 et Amazon EC2. Vous pouvez trouver la documentation la plus récente et la plus à jour sur notre site de documentation, y compris une liste des services pris en charge.
Boto3 est maintenu et publié par Amazon Web Services.
Boto (prononcé boh-toh) doit son nom au dauphin d'eau douce originaire du fleuve Amazone. Le nom a été choisi par l'auteur de la bibliothèque Boto originale, Mitch Garnaat, en référence à l'entreprise.
Le 13/12/2023, la prise en charge de Python 3.7 a pris fin pour Boto3. Cela fait suite à la fin du support du runtime par Python Software Foundation qui a eu lieu le 2023-06-27. Pour plus d’informations, consultez cet article de blog.
En supposant qu'une version prise en charge de Python soit installée, vous pouvez d'abord configurer votre environnement avec :
$ python -m venv .venv
...
$ . .venv/bin/activateEnsuite, vous pouvez installer boto3 depuis PyPI avec :
$ python -m pip install boto3ou installez à partir des sources avec :
$ git clone https://github.com/boto/boto3.git
$ cd boto3
$ python -m pip install -r requirements.txt
$ python -m pip install -e .Après avoir installé boto3
Ensuite, configurez les informations d'identification (dans par exemple ~/.aws/credentials ) :
[default]
aws_access_key_id = YOUR_KEY
aws_secret_access_key = YOUR_SECRET Ensuite, configurez une région par défaut (par exemple ~/.aws/config ) :
[default]
region =us-east-1D'autres méthodes de configuration des informations d'identification peuvent être trouvées ici
Ensuite, depuis un interpréteur Python :
>> > import boto3
>> > s3 = boto3 . resource ( 's3' )
>> > for bucket in s3 . buckets . all ():
print ( bucket . name ) Vous pouvez exécuter des tests dans toutes les versions de Python prises en charge à l'aide de tox . Par défaut, il exécutera tous les tests unitaires et fonctionnels, mais vous pouvez également spécifier vos propres options pytest . Notez que cela nécessite que toutes les versions prises en charge de Python soient installées, sinon vous devez passer -e ou exécuter directement la commande pytest :
$ tox
$ tox -- unit/test_session.py
$ tox -e py26,py33 -- integration/Vous pouvez également exécuter des tests individuels avec votre version Python par défaut :
$ pytest tests/unitNous utilisons les problèmes GitHub pour suivre les bogues et les demandes de fonctionnalités et disposons d'une bande passante limitée pour les résoudre. Veuillez utiliser ces ressources communautaires pour obtenir de l'aide :
Nous apprécions les commentaires et les contributions de notre communauté. Qu'il s'agisse d'un rapport de bug, d'une nouvelle fonctionnalité, d'une correction ou d'une documentation supplémentaire, nous apprécions vos problèmes et vos demandes d'extraction. Veuillez lire ce document CONTRIBUANT avant de soumettre des problèmes ou des demandes de tirage pour vous assurer que nous disposons de toutes les informations nécessaires pour répondre efficacement à votre contribution.
Boto3 a été mis à la disposition générale le 22/06/2015 et est actuellement dans la phase de support complet du cycle de vie de disponibilité.
Pour plus d'informations sur la maintenance et la prise en charge des versions majeures du SDK et de leurs dépendances sous-jacentes, consultez les informations suivantes dans le Guide de référence de configuration et d'informations d'identification partagées des kits SDK et outils AWS :
