用于python的aws sdk
boto3的Python项目详细描述
Boto3是用于 python,它允许python开发人员编写使用 像AmazonS3和AmazonEC2这样的服务。你可以找到最新的 最新的文档,包括 支持的服务。
快速启动
首先,安装库并设置默认区域:
$ pip install boto3
接下来,设置凭据(例如~/.aws/credentials):
[default]aws_access_key_id=YOUR_KEYaws_secret_access_key=YOUR_SECRET
然后,设置默认区域(例如~/.aws/config):
[default]region=us-east-1
然后,从python解释器:
>>>importboto3>>>s3=boto3.resource('s3')>>>forbucketins3.buckets.all():print(bucket.name)
开发
开始
假设您安装了python和virtualenv,请设置 环境并安装所需的依赖项,而不是 上面定义的pip install boto3:
$ git clone https://github.com/boto/boto3.git
$ cd boto3
$ virtualenv venv
...
$ . venv/bin/activate
$ pip install -r requirements.txt
$ pip install -e .
运行测试
您可以使用tox在所有受支持的python版本中运行测试。默认情况下, 它将运行所有的单元和功能测试,但是您也可以指定自己的 nosetests选项。请注意,这要求您 已安装python的版本,否则必须传递-e,或运行 nosetests直接命令:
$ tox $ tox -- unit/test_session.py $ tox -e py26,py33 -- integration/
您还可以使用默认的python版本运行单独的测试:
$ nosetests tests/unit
生成文档
狮身人面像是用来记录的。您可以使用 以下内容:
$ pip install -r requirements-docs.txt
$ cd docs
$ make html
获取帮助
我们使用github问题来跟踪bug和特性请求,并且 解决这些问题的带宽。请使用这些社区资源 帮助:
- 在Stack Overflow上提问并用boto3标记它
- 加入aws python社区聊天gitter
- 使用AWS Support
- 如果你发现了一个bug,请open an issue