Heroku.py 技术文档

1. 安装指南

要安装 heroku.py，请使用以下命令：

$ pip install heroku

请注意，不建议使用以下命令：

$ easy_install heroku

因为 pip 是比 easy_install 更好的工具。

2. 项目使用说明

heroku.py 是一个用于 Heroku API 的 Python 包装器。Heroku REST API 允许 Heroku 用户管理他们的账户、应用程序、插件以及其他与 Heroku 相关的方面。通过这个包装器，您可以轻松地从您的应用程序中利用 Heroku 平台。

以下是基本的使用说明：

登录

使用您的密码登录：

import heroku
cloud = heroku.from_pass('[e-mail]', 'your_password')

或者使用您的 API 密钥：

cloud = heroku.from_key('YOUR_API_KEY')

应用程序交互

获取您的应用程序列表：

cloud.apps

选择一个应用程序进行操作：

app = cloud.apps['your_app_name']

水平扩展

获取并调整进程：

app.processes['web'].scale(3)

访问日志

打印最后两条日志：

print app.logs(num=2)

或者实时打印日志：

for line in app.logs(tail=True):
    print line

更改应用配置

修改配置：

app.config['DEBUG'] = 1

查看发布历史

获取发布历史：

app.releases

创建新应用

创建一个新应用：

cloud.apps.add('myapp')

删除应用

完全删除应用：

app.destroy()

3. 项目API使用文档

heroku.py 使用 Requests 库来处理网络请求，支持所有自定义会话。

例如，进行高级日志记录以便于调试：

import sys
import requests
from heroku.api import Heroku

my_config = {'verbose': sys.stderr}
session = requests.session(config=my_config)
cloud = Heroku(session=session)
cloud.authenticate(cloud.request_key('[e-mail]', 'your_password'))

4. 项目安装方式

请参考本文档的 "安装指南" 部分。