Boto3 é o kit de desenvolvimento de software (SDK) da Amazon Web Services (AWS) para Python, que permite aos desenvolvedores Python escrever software que faz uso de serviços como Amazon S3 e Amazon EC2. Você pode encontrar a documentação mais recente e atualizada em nosso site de documentos, incluindo uma lista de serviços suportados.
Boto3 é mantido e publicado pela Amazon Web Services.
Boto (pronuncia-se boh-toh) recebeu o nome do golfinho de água doce nativo do rio Amazonas. O nome foi escolhido pelo autor da biblioteca original do Boto, Mitch Garnaat, como referência à empresa.
Em 13/12/2023, o suporte para Python 3.7 terminou para Boto3. Isso segue o fim do suporte da Python Software Foundation para o tempo de execução que ocorreu em 27/06/2023. Para obter mais informações, consulte esta postagem do blog.
Supondo que você tenha uma versão compatível do Python instalada, primeiro você pode configurar seu ambiente com:
$ python -m venv .venv
...
$ . .venv/bin/activateEntão, você pode instalar o boto3 do PyPI com:
$ python -m pip install boto3ou instale a partir da fonte com:
$ git clone https://github.com/boto/boto3.git
$ cd boto3
$ python -m pip install -r requirements.txt
$ python -m pip install -e .Depois de instalar o boto3
Em seguida, configure as credenciais (por exemplo, ~/.aws/credentials ):
[default]
aws_access_key_id = YOUR_KEY
aws_secret_access_key = YOUR_SECRET Em seguida, configure uma região padrão (por exemplo, ~/.aws/config ):
[default]
region =us-east-1Outros métodos de configuração de credenciais podem ser encontrados aqui
Então, de um interpretador Python:
>> > import boto3
>> > s3 = boto3 . resource ( 's3' )
>> > for bucket in s3 . buckets . all ():
print ( bucket . name ) Você pode executar testes em todas as versões suportadas do Python usando tox . Por padrão, ele executará todos os testes unitários e funcionais, mas você também pode especificar suas próprias opções pytest . Observe que isso requer que você tenha todas as versões suportadas do Python instaladas; caso contrário, você deve passar -e ou executar o comando pytest diretamente:
$ tox
$ tox -- unit/test_session.py
$ tox -e py26,py33 -- integration/Você também pode executar testes individuais com sua versão padrão do Python:
$ pytest tests/unitUsamos problemas do GitHub para rastrear bugs e solicitações de recursos e temos largura de banda limitada para resolvê-los. Use estes recursos da comunidade para obter ajuda:
Valorizamos o feedback e as contribuições da nossa comunidade. Seja um relatório de bug, um novo recurso, uma correção ou documentação adicional, seus problemas e solicitações de pull serão bem-vindos. Leia este documento de CONTRIBUIÇÃO antes de enviar quaisquer problemas ou pull requests para garantir que tenhamos todas as informações necessárias para responder de forma eficaz à sua contribuição.
O Boto3 foi disponibilizado ao público em 22/06/2015 e atualmente está na fase de suporte total do ciclo de vida de disponibilidade.
Para obter informações sobre manutenção e suporte para versões principais do SDK e suas dependências subjacentes, consulte o seguinte no AWS SDKs and Tools Shared Configuration and Credentials Reference Guide:
