SAE Python 开发者手册¶

目前SAE Python还处于测试阶段，欢迎使用。点此申请内测。

本文档，示例代码以及本地测试server下载：

git clone http://github.com/SAEPython/saepythondevguide.git

Contents:

Quick Start 快速指引¶

Hello, world!¶

创建新应用¶

登录SAE，进入我的首页，点击创建新应用，创建一个新的应用helloworld。

检出svn代码¶

执行下面的命令创建应用目录并检出svn代码。

jaime@westeros:~$ svn co https://svn.sinaapp.com/helloworld

创建index.wsgi¶

创建一个目录1作为默认版本，在此下面新建文件 index.wsgi 。

jaime@westeros:~$ cd helloworld
jaime@westeros:~/helloworld$ mkdir 1
jaime@westeros:~/helloworld$ cd 1
jaime@westeros:~/helloworld/1$ touch index.wsgi

编辑index.wsgi，内容如下：

import sae

def app(environ, start_response):
    status = '200 OK'
    response_headers = [('Content-type', 'text/plain')]
    start_response(status, response_headers)
    return ['Hello, world!']

application = sae.create_wsgi_app(app)

提交代码¶

jaime@westeros:~/helloworld$ svn add 1/
jaime@westeros:~/helloworld$ svn ci -m "initialize project"

访问应用¶

在浏览器中输入 http://helloworld.sinaapp.com ，就可以访问刚提交的应用了。

Note

svn的仓库地址为：http://svn.sinaapp.com/<your-application-name>，用户名和密码为sae的安全邮箱和安全密码。

使用web开发框架¶

Django¶

目前SAE Python使用的版本是 Django-1.2.7 , 请确保你安装的是这个版本。

建立一个新的Python应用，检出svn代码到本地目录，建立默认版本目录1并切换到此目录。

新建文件index.wsgi，内容如下

import os
import django.core.handlers.wsgi

import sae

os.environ['DJANGO_SETTINGS_MODULE'] = 'mysite.settings'

application = sae.create_wsgi_app(django.core.handlers.wsgi.WSGIHandler())

初始化django应用:

django-admin.py startproject mysite

最终目录结构如下:

jaime@westeros:~/pythondemo/1$ ls
index.wsgi  media  mysite  README
jaime@westeros:~/pythondemo/1$ ls media/
css  img  js
jaime@westeros:~/pythondemo/1$ ls mysite/
demo  __init__.py  manage.py  settings.py  urls.py  views.py

提交代码

访问 http://<your-application-name>.sinaapp.com ，就可看到Django的欢迎页面了。

Hello, Django!

在mysite/目录下新建一个views.py，内容如下

from django.http import HttpResponse

def hello(request):
    return HttpResponse("Hello, world! - Django")

修改urls.py，新增一条规则解析hello。

# Uncomment the next two lines to enable the admin:
# from django.contrib import admin
# admin.autodiscover()

urlpatterns = patterns('',
    ...
    (r'^$', 'mysite.views.hello),
    #(r'^admin/', include(admin.site.urls)),
)

提交代码，访问 http://<your-application-name>.sinaapp.com/ ，ok，熟悉的Hello，World!出现了。

因为django的WSGI Handler不会处理静态文件请求（静态文件是由manage.py来处理的），如果你需要使用django的admin模块，你需要从django安装目录复制admin 的media目录到应用目录下的/media目录中。

cp -rf django/contrib/admin/media/ <your-application-home>/media

如果你定义了自己的templates目录，admin应用的模板可能无法使用，需要将admin的系统模块添加到settings.py中:

TEMPLATE_DIRS = (
    # Put strings here, like "/home/html/django_templates" or "C:/www/django/templates".
    # Always use forward slashes, even on Windows.
    # Don't forget to use absolute paths, not relative paths.
+   '/usr/local/sae/python/lib/python2.6/site-packages/django/contrib/admin/templates/admin',
    os.path.join(PROJ_DIR, 'templates'),
)

FIXME: admin模块和自定义模块关系

Flask¶

index.wsgi

import sae

from myapp import app

application = sae.create_wsgi_app(app)

myapp.py

import MySQLdb
from flask import Flask, g, request

app = Flask(__name__)
app.debug = True

from sae.const import (MYSQL_HOST, MYSQL_HOST_S,
    MYSQL_PORT, MYSQL_USER, MYSQL_PASS, MYSQL_DB
)

@app.before_request
def before_request():
    appinfo = sae.core.Application()
    g.db = MySQLdb.connect(MYSQL_HOST, MYSQL_USER, MYSQL_PASS,
                           MYSQL_DB, port=int(MYSQL_PORT))

@app.teardown_request
def teardown_request(exception):
    if hasattr(g, 'db'): g.db.close()

@app.route('/')
def hello():
    return "Hello, world! - Flask"

@app.route('/demo', methods=['GET', 'POST'])
def greeting():
    html = ''

    if request.method == 'POST':
        c = g.db.cursor()
        c.execute("insert into demo(text) values(%s)", (request.form['text']))

    html += """
    <form action="" method="post">
        <div><textarea cols="40" name="text"></textarea></div>
        <div><input type="submit" /></div>
    </form>
    """
    c = g.db.cursor()
    c.execute('select * from demo')
    msgs = list(c.fetchall())
    msgs.reverse()
    for row in msgs:
        html +=  '<p>' + row[-1] + '</p>'

    return html

Bottle¶

index.wsgi

from bottle import Bottle, run

import sae

app = Bottle()

@app.route('/')
def hello():
    return "Hello, world! - Bottle"

application = sae.create_wsgi_app(app)

Tornado¶

Warning

Tornado目前只支持WSGI模式，异步等功能无法使用。

index.wsgi

import tornado.wsgi

import sae

class MainHandler(tornado.web.RequestHandler):
    def get(self):
        self.write("Hello, world! - Tornado")

app = tornado.wsgi.WSGIApplication([
    (r"/", MainHandler),
])

application = sae.create_wsgi_app(app)

Uliweb¶

Thanks to limodou At gmail.com

uliweb的安装¶

为搭建本地开发环境，你需要安装uliweb 0.0.1a7以上版本或svn中的版本，简单的安装可以是:

easy_install Uliweb

安装后在Python环境下就可以使用uliweb命令行工具了。

目前Uliweb支持Python 2.6和2.7版本。3.X还不支持。

Hello, Uliweb¶

让我们从最简单的Hello, Uliweb的开发开始。首先假设你已经有了sae的帐号.

创建一个新的应用，并且选择Python环境。
从svn环境中checkout一个本地目录
进入命令行，切換到svn目录下
创建Uliweb项目:
```
uliweb makeproject project
```
会在当前目录下创建一个 project 的目录。这个目录可以是其它名字，不过它是和后面要使用的 index.wsgi 对应的，所以建议不要修改。

创建 index.wsgi 文件，Uliweb提供了一个命令来做这事:

uliweb support sae

这样会在当前目录下创建一个 index.wsgi 的文件和 lib 目录。注意执行时是在svn的目录，即project的父目录中。

index.wsgi 的内容是:

import sae
import sys, os

path = os.path.dirname(os.path.abspath(__file__))
project_path = os.path.join(path, 'project')
sys.path.insert(0, project_path)
sys.path.insert(0, os.path.join(path, 'lib'))

from uliweb.manage import make_application
app = make_application(project_dir=project_path)

application = sae.create_wsgi_app(app)

其中 project 和 lib 都已经加入到 sys.path 中了。所以建议使用上面的路径，不然就要手工修改这个文件了。

然后就可以按正常的开发app的流程来创建app并写代码了，如:

cd project
uliweb makeapp simple_todo

这时一个最简单的Hello, Uliweb已经开发完毕了。

如果有静态文件，则需要放在版本目录下，Uliweb提供了命令可以提取安装的app的静态文件:
```
cd project
uliweb exportstatic ../static
```
如果有第三方源码包同时要上传到sae中怎么办，Uliweb提供了export命令可以导出已经安装的app或指定的模块的源码到指定目录下:
```
cd project
uliweb export -d ../lib #这样是导出全部安装的app
uliweb export -d ../lib module1 module2 #这样是导出指定的模块
```
为什么还需要导出安装的app，因为有些app不是放在uliweb.contrib中的，比如第三方的，所以需要导出后上传。但是因为export有可能导出已经内置于uliweb中的app，所以通常你可能还需要在 lib 目录下手工删除一些不需要的模块。
提交代码

访问 http://<你的应用名称>.sinaapp.com ，就可看到项目的页面了。

数据库配置¶

Uliweb中内置了一个对sae支持的app，还在不断完善中，目前可以方便使用sae提供的MySql 数据库。

然后修改 project/apps/settings.ini 在 GLOBAL/INSTALLED_APPS 最后添加:

[GLOBAL]
INSTALLED_APPS = [
...
'uliweb.contrib.sae'
]

然后为了支持每个请求建立数据库连接的方式，还需要添加一个Middleware在settings.ini中:

[MIDDLEWARES]
transaction = 'uliweb.orm.middle_transaction.TransactionMiddle'
db_connection = 'uliweb.contrib.sae.middle_sae_orm.DBConnectionMiddle'

其中第一行是事务支持的Middleware你也可以选择使用。

这样就配置好了。而相关的数据库表的创建维护因为sae不能使用命令行，所以要按sae的文档说明通过phpMyAdmin来导入。以后Uliweb会増加相应的维护页面来做这事。

web.py¶

index.wsgi

import os

import sae
import web
        
urls = (
    '/', 'Hello'
)

app_root = os.path.dirname(__file__)
templates_root = os.path.join(app_root, 'templates')
render = web.template.render(templates_root)

class Hello:        
    def GET(self):
        return render.hello()

app = web.application(urls, globals()).wsgifunc()

application = sae.create_wsgi_app(app)

Tip

以上所有的示例代码的完整版本可以在我们的github repo中获得。

https://github.com/SAEPython/saepythondevguide/tree/master/examples/

SAE Python环境¶

环境信息¶

SAE Python应用运行于沙箱环境之中，SAE会根据负载在后端的多个节点中选择一个来处理HTTP请求。 SAE Python支持标准WSGI应用。

命名规范:

应用目录

SAE上的每个应用可以同时运行多个版本，版本以数字为标示，默认版本为1。每个版本对应于应用svn根目录下以其版本号命名的一个目录，称为版本目录，应用的代码（index.wsgi等）必须放到版本目录里。

以应用longtalk为例，这个应用有6个版本：
```
jaime@westeros:~/longtalk$ ls
1  2  3  4  5  6
jaime@westeros:~/longtalk/1$ ls
index.wsgi myapp.py
```
应用默认版本代码所在的目录，称为应用目录。该目录会添加到Python runtime的 sys.path 中。该目录也为应用运行时的当前目录。

访问指定版本的应用： http://<version>.<application-name>.sinaapp.com

不推荐使用os.getcwd()来获取路径信息，建议使用__file__属性。

预装模块列表¶

名称支持的版本默认版本

django 1.2.7, 1.4 1.2.7

flask 0.7.2 0.7.2

flask-sqlalchemy 0.15 0.15

werkzeug 0.7.1 0.7.1

jinjia2 2.6 2.6

tornado 2.1.1 2.1.1

bottle 0.9.6 0.9.6

ulibweb 0.0.1a7 0.0.1a7

sqlalchemy 0.7.3 0.7.3

webpy 0.36 0.36

Flask-WTF 0.5.2 0.5.2

WTForms 0.6.3 0.6.3

PIL 1.1.7 1.1.7

MySQLdb 1.2.3 1.2.3

sinatpy 2.x-(2011-6-8) 2.x-(2011-6-8)

名称	支持的版本	默认版本
django	1.2.7, 1.4	1.2.7
flask	0.7.2	0.7.2
flask-sqlalchemy	0.15	0.15
werkzeug	0.7.1	0.7.1
jinjia2	2.6	2.6
tornado	2.1.1	2.1.1
bottle	0.9.6	0.9.6
ulibweb	0.0.1a7	0.0.1a7
sqlalchemy	0.7.3	0.7.3
webpy	0.36	0.36
Flask-WTF	0.5.2	0.5.2
WTForms	0.6.3	0.6.3
PIL	1.1.7	1.1.7
MySQLdb	1.2.3	1.2.3
sinatpy	2.x-(2011-6-8)	2.x-(2011-6-8)

Note

需要使用非默认版本可以在config.yaml中指定。

请求处理¶

静态目录

/media
/static
/favicon.ico

其他所有请求，都被路由到/index.wsgi:application，即应用根目录index.wsgi文件, 名为application的callable，暂不可修改。

application 使用下列方式创建

sae.create_wsgi_app(app)¶: 将标准wsgi应用封装为适宜在SAE上运行的应用

import sae

def app(environ, start_response):
    # Your app
    ...

application = sae.create_wsgi_app(app)

Python环境¶

Python runtime使用的是Python 2.6.7。

仅支持运行纯Python的应用，不能动态加载C扩展，即.so，.dll等格式的模块不能使用
进程，线程操作受限
除临时文件，应用自身所在目录外，不可访问本地文件系统。本地文件系统不可写入。

本地文件系统可以读取本应用目录，Python标准库下的内容，不支持写入。如需读写临时文件建议使用StringIO或者cStringIO来替代。

Python默认的模块搜索路径为：当前目录 > 系统目录。添加模块搜索目录的方法为：

import sys
sys.path.insert(0, your_custom_module_path)

注意：Python当前目录下的子目录只有包含__init__.py才会被Python认为是一个package，才可以直接import。

SAE设置了一些自定义的环境变量，这些环境变量可以通过os.environ这个dict获取。

APP_NAME：应用名。
APP_VERSION: 当前应用使用的版本号。
SERVER_SOFTWARE: 当前server的版本（目前为sae/1.0.testing）。可以使用这个环境变量来区分本地开发环境还是在线环境，本地开发环境未设置这个值。

日志系统¶

打印到stdout和stderr的内容会记录到应用的日志中心中，所以直接使用print语句或者logging模块来记录应用的日志就可以了。

日志内容在应用»日志中心» HTTP 中查看，类别为debug。

应用缓存¶

SAE Python会对应用导入的模块（包括index.wsgi）进行缓存，从而缩短请求响应时间，对于缓存了的应用，请求处理只是取出index.wsgi中application这个callable并调用。

应用程序配置¶

应用程序的配置文件为应用目录下的config.yaml文件。

使用第三方库
```
libraries:
- name: django
  version: "1.4"

- name: numpy
  version: "1.5.0"
```
name为第三方模块的名称，version为需要使用的版本，这两个字段为必填字段。
静态文件处理

静态文件夹
```
handlers:
- url: /static
  static_dir: static
```
url为URL的前缀，static_dir为静态文件所在的目录（相对于应用目录）。

Note

部分第三方库已经包含在默认搜索路径中，可以不在config.yaml中指定直接使用。
如果config.yaml中没有设置静态文件相关的handlers，系统会默认将/static，/media 为前缀的URL转发到应用目录下的static和media目录。
以上两条规则仅为兼容性考虑保留，不推荐使用，请在config.yaml明确配置。

可用服务列表¶

注意：MySQL, TaskQueue, Memcache, KVDB 服务需开启才能使用，请在前端管理界面服务管理中开启并初始化。

访问互联网¶

直接使用urllib, urllib2或者httplib模块访问网络资源即可。

MySQL¶

连接信息¶

获取mysql的连接信息。

import sae.const

sae.const.MYSQL_DB      # 数据库名
sae.const.MYSQL_USER    # 用户名
sae.const.MYSQL_PASS    # 密码
sae.const.MYSQL_HOST    # 主库域名（可读写）
sae.const.MYSQL_PORT    # 端口，类型为<type 'str'>，请根据框架要求自行转换为int
sae.const.MYSQL_HOST_S  # 从库域名（只读）

下面就可以跟平常一样使用MySQL服务了，SAE Python内置了MySQLdb模块，对于MySQLdb的使用，可以参考其官方文档。

注意： MySQL 连接超时时间为30s 。

数据库导入¶

创建数据表:

django-admin.py sqlall all-installed-app-names > some-file

开发可使用本地mysql数据库，在发布时将其导入到SAE线上数据库:

使用mysqldump或者phpMyAdmin等工具从本地数据库导出数据库。
进入SAE后台应用管理>服务管理>MySQL页面，初始化MySQL。
进入管理MySQL页面，选择导入，导入刚才导出的sql文件即可。

导入时如果出现下面的错误:

Error
SQL query:

--
-- Dumping data for table `***`
--
LOCK TABLES `***` WRITE ;


MySQL said:

#1044 - Access denied for user '****'@'10.67.15.%' to database 'app_***'

请把要导入的sql文件中，所有LOCK, UNLOCK语句全部删除并重试。

字符集问题¶

在管理界面创建数据表，默认字符集为utf8，也可设为其他编码。

如果你是在本地开发环境建立的数据表，请确保使用utf8。在管理界面导入本地数据库时，也可完成字符集的转换。

TaskQueue, Cron¶

什么是任务¶

出于安全性考虑，SAE不支持执行一段任意的代码程序。SAE的cron，和unix的cron意义不同，没有相关联的程序。

SAE的任务，实际上对应于一个URL地址。SAE worker节点每请求一次该URL，就算执行一次任务。真正的任务处理代码，是app中处理该URL的handler。

任务执行有两种方式: Taskqueue 动态执行任务, Cron 定时执行任务

任务的执行情况可以在日志中心>TaskQueue栏中查询。

Taskqueue¶

sae.taskqueue.add_task(queue_name, url, payload=None)¶

快速添加任务

queue_name: 任务队列的名称

url: 任务的url，如： /tasks/task_name

payload: 可选，如果payload存在且不为None，则该任务为一POST任务，payload会作为请求的POST的数据。

class sae.taskqueue.Task(url, payload=None, **kwargs)¶

Task类

url: 任务的url，如： /tasks/task_name

payload: 可选, 如果payload存在且不为None，则该任务为一POST任务，payload会作为请求的POST的数据。

delay: 可选，设置任务延迟执行的时间，单位为秒，最大可以为600秒。

prior: 可选，如果设置为True，则任务会被添加到任务队列的头部。

class sae.taskqueue.TaskQueue(name, auth_token=None)¶

TaskQueue类

name: 任务队列的名称。

auth_token: 可选, 一个包含两个元素的元组 (access_key, secretkey_key)。

add(task)¶

添加一个任务

task: 添加的任务，可以为单个Task任务，也可以是一个Task列表。

size()¶: 获取当前队列中还有多少未执行的任务。

Example:

添加一个任务。

from sae.taskqueue import Task, TaskQueue

queue = TaskQueue('queue_name')
queue.add(Task("/tasks/foo"))

添加一个POST任务。
```
queue.add(Task("/tasks/bar", "data"))
```

批量添加任务。

tasks = [Task("/tasks/update", user) for user in users]
queue.add(tasks)

快速添加任务。

from sae.taskqueue import add_task
add_task('queue_name', '/tasks/push', 'msg')

Note

任务的url现在已经改为相对的url，目前兼容绝对url，但是不推荐使用。任务默认使用GET方式请求，如果Task带有payload参数且不为None则使用POST方式请求。

Cron¶

Cron的配置文件为 config.yaml ，Cron的执行状态可在应用的管理界面服务管理>Cron 中查看。

添加Cron:

编辑config.yaml文件中，增加cron段，例如：
```
name: crontest
version: 1
cron:
  - description: cron_test
    url: /cron/make
    schedule: */5 * * * *
```
上面的示例添加了一个cron任务，该任务每5分钟执行`http://crontest.sinaapp.com/cron/make`一次。
删除cron:

删除config.yaml中对应的cron描述段即可就行。
语法字段含义
- url
  
  cron任务的url。例如 /relative/url/to/cron 。
- schedule
  
  任务描述，也就是何时执行这个cron，支持unix crontab语法。例如：
```
# 每天00：05分执行
5 0 * * *
# 每月1号的14：15分执行
15 14 1 * *
# 每个工作日的晚上10点执行
0 22 * * 1-5
# 每分钟执行一次
*/1 * * * *
```
  具体的语法规则可以参考man手册，man 5 crontab。
- description
  
  可选。任务的说明，默认为空。
- timezone
  
  可选。默认为Beijing，目前支持：Beijing, NewYork, London, Sydney, Moscow, Berlin
- login
  
  可选。http basic auth设置，格式：用户名@密码
- times
  
  可选。设置cron最大执行的次数，默认没有次数限制。

Warning

Cron使用POST方式请求URL。

什么是POST和GET？请见 http://en.wikipedia.org/wiki/HTTP#Request_methods

登录和CRSF¶

SAE任务处理节点只是简单的请求任务URL，对于除http basic auth之外的登录信息，一无所知，故务必确认你的URL 可以不用登录直接访问。

http basic auth虽然支持，但是不推荐使用。要保护任务URL不被外界访问，请使用IP白名单。

如果你在任务URL的POST处理程序中开启了CRSF，则会导致403认证失败错误。请在任务处理程序中关闭CRSF功能，涉及框架: Django, Flask等。

什么是CRSF？ http://en.wikipedia.org/wiki/Cross-site_request_forgery

如何保护任务URL¶

为保护cron，taskqueue对应的url，可在config.yaml配置允许访问的IP地址。

建议将所有taskqueue，cron的url都挂载到/backend/下面:

/backend/
/backend/taskqueue/
/backend/cron

SAE内部节点IP范围: 10.0.0.0/8，如下配置只允许SAE内部节点访问:

- hostaccess: if(path ~ "/backend/") allow "10.0.0.0/8"

请确保SAE内部节点在白名单内，否则将无法正常执行。

Cron和Taskqueue中使用weibo api¶

因为现在weibo api需要提供调用者的ip（合法的公网ip），sae默认提供的是http请求的client的ip，但是对于cron和taskqueue，由于是sae的内部请求，无法获取公网ip。所以需要用户手工设置一个。设置方法如下：

import os
os.environ['REMOTE_ADDR'] = 调用者公网ip

请务必将这段代码放在请求处理代码执行的必经路径上。比如在Flask中：:

@app.before_request
def before_request():
    import os
    os.environ['REMOTE_ADDR'] = 调用者公网ip

Cron 完整示例¶

每五分钟请求一次 /backend/cron/update URL

Flask URL 处理程序:

import pylibmc
import datetime

from appstack import app

mc = pylibmc.Client(['localhost'])

@app.route('/backend/cron/update', methods=['GET', 'POST'])
def update():
    update_time = mc.get('update_time')
    mc.set("update_time", str(datetime.datetime.now()))

    return update_time

config.yaml:

name: appstack
version: 4

cron:
- url: /backend/cron/update
  schedule: */5 * * * *

handle:
- hostaccess: if(path ~ "/backend/") allow "10.0.0.0/8"

原有的PHP文档¶

仅供参考

Taskqueue http://sae.sina.com.cn/?m=devcenter&catId=205

Cron http://sae.sina.com.cn/?m=devcenter&catId=195

AppConfig http://sae.sina.com.cn/?m=devcenter&catId=193

Mail¶

class sae.mail.EmailMessage(**kwargs)¶

EmailMessage类

参数同下面的initialize

initialize(**kwargs)¶

初始化邮件的内容。

to: 收件人列表，多个收件人之间用逗号隔开。

subject: 邮件的标题。

body/html: 邮件正文。如果内容为纯文本，使用body，如果是html则使用html。

smtp: smtp服务器的信息。是一个包含5个元素的tuple。 (smtp主机，smtp端口，用户名，密码，是否启用TLS）。

attachments: 可选。邮件的附件，必须为一个list，list里每个元素为一个 tuple，tuple的第一个元素为文件名，第二个元素为文件的内容。

send()¶: 提交邮件发送请求至后端服务器。

__setattr__(attr, value)¶: attr: 属性名。 value: 属性的值。

sae.mail.send_mail(to, subject, body, smtp, **kwargs)¶

快速发送邮件。

字段的意义同EmailMessage.initialize()。

Examle:

快速发送一份邮件

from sae.mail import send_mail

send_mail("katherine@vampire.com", "invite", "to tonight's party"
          ("smtp.vampire.com", 25, "damon@vampire.com", "password", False))

发送一封html格式的邮件

from sae.mail import EmailMessage

m = EmailMessage()
m.to = 'damon@vampire.com'
m.subject = 'Re: inivte'
m.html = '<b>my pleause!</b>'
m.smtp = ('smtp.vampire.com', 25, 'katherine@vampire.com', 'password', False)
m.send()

使用Gmail SMTP

import sae.mail

sae.mail.send_mail(to, subject, body,
        ('smtp.gmail.com', 587, from, passwd, True))

Memcache¶

请在前端管理界面启用Memcache服务。

SAE Python使用 http://sendapatch.se/projects/pylibmc/ 作为mc客户端。不同之处在于，创建Client时不用指定servers。

示例代码:

import pylibmc

mc = pylibmc.Client()

mc.set("foo", "bar")
value = mc.get("foo")

if not mc.get('key'):
    mc.set("key", "1")
mc.incr("key")

文档参考:

http://sendapatch.se/projects/pylibmc/

详细用法和 python-memcached 基本一样，可参考下面安装包中的 memcache.html 文件

http://ftp.tummy.com/pub/python-memcached/old-releases/python-memcached-1.48.tar.gz

Storage¶

Storage是SAE为开发者提供的分布式文件存储服务，用来存放用户的持久化存储的文件。

用户需要先在在线管理平台创建Domain，每一个domain下面包含了你上传的数据。

class sae.storage.Object(data, **kwargs)¶

Object类

data: Object的内容。

expires: 设置Object在浏览器客户端的过期时间，格式同Apache的Expires格式： http://httpd.apache.org/docs/2.0/mod/mod_expires.html

content_type: 设置Object的Conent-Type Header。

content_encoding: 设置Object的Cotent-Encoding Header。

class sae.storage.Client(accesskey=ACCESS_KEY, secretkey=SECRET_KEY, prefix=APP_NAME)¶

Client类

put(domain, key_name, object)¶: 将object存到某个domain中。返回object的public url。

get(domain, key_name)¶: 返回domain中名为key_name的对象。

stat(domain, key_name)¶: 返回domain中名为key_name的对象属性，返回值为一个dict。

delete(domain, key_name)¶: 删除domain中名为key_name的对象。

list(domain)¶: 返回domain中所有对象的列表。

list_domain():: 返回所有domain的列表。

url(domain, key_name)¶: 返回domain中key_name的对象的public url。

Example

import sae.storage

# 初始化一个Storage客户端。
s = sae.storage.Client()

# LIST所有的domain
s.list_domain()

# PUT object至某个domain下面，put操作返回object的public url。
ob = sae.storage.Object('pieces of data')
s.put('domain-name', 'object-name', ob)

# 设置object的属性
ob = sae.storage.Object('pieces of data',   \
  expires='A3600', content_type='text/html', content_encoding='gzip')
s.put('domain-name', 'object-name', ob)

# GET某个domain下的object
ob = s.get('domain-name', 'object-name')
data = ob.data

# 获取object的属性信息
ob = s.stat('domain-name', 'object-name')

# 获取object的public url
url = s.url('domain-name', 'object-name')

# DELETE一个object
s.delete('domain-name', 'object-name')

# LIST一个domain下所有的object
s.list('domain-name')

KVDB(TBD)¶

开启和关闭¶

http://sae.sina.com.cn/?m=kv

kvdb服务禁用后会清除所有数据，请谨慎操作。

sae.kvdb¶

class sae.kvdb.Error¶: 通用错误

class sae.kvdb.RouterError¶: 路由meta信息错误

class sae.kvdb.StatusError¶: kvdb状态不为OK

class sae.kvdb.KVClient(**kw)¶

KVDB客户端封装，基于python-memcached-1.48 memcache.Client，大多数method使用方法相同。如果不能成功创建KVClient，则抛出 sae.kvdb.Error 异常。

kw: 传递给memcache.Client的keyword参数

set(key, val, time=0, min_compress_len=0)¶

设置key的值为val，成功则返回True

time 该key的超时时间，请参阅memcached协议Storage commands: http://code.sixapart.com/svn/memcached/trunk/server/doc/protocol.txt

min_compress_len 启用zlib.compress压缩val的最小长度，如果val的长度大于此值则启用压缩，0表示不压缩。

add(key, val, time=0, min_compress_len=0)¶: 同set，但只在key不存在时起作用

replace(key, val, time=0, min_compress_len=0)¶: 同set，但只在key存在时起作用

delete(key, time=0)¶

删除key，成功返回1，失败返回0。

time 为后续多少秒内set/update操作会失败。

get(key)¶: 获取key的值，失败则返回None

get_info()¶

获取本应用kvdb统计数据，返回一个字典:

{
    'outbytes': 126,
    'total_size': 3,
    'inbytes': 180,
    'set_count': 60,
    'delete_count': 21,
    'total_count': 1,
    'get_count': 42
}

disconnect_all()¶: 关闭kvdb连接

示例代码¶

import sae.kvdb

kv = sae.kvdb.KVClient()

k = 'foo'
kv.set(k, 2)
kv.delete(k)

kv.add(k, 3)
kv.get(k)

kv.replace(k, 4)
kv.get(k)

print kv.get_info()

参考 http://sae.sina.com.cn/?m=devcenter&catId=199

第三方认证接入¶

新浪微博¶

使用weibopy

http://code.google.com/p/sinatpy/

已内置。对binder.py做了修改，使用urllib2替代httplib，代码在 https://gist.github.com/1357670

from flask import Flask, request, redirect, session
from weibopy import OAuthHandler, oauth, API

app = Flask(__name__)
app.debug = True
app.secret_key = 'test'

consumer_key = '199***'
consumer_secret = 'a1f8****'

def get_referer():
    return request.headers.get('HTTP_REFERER', '/')

def get_weibo_user():
    auth = OAuthHandler(consumer_key, consumer_secret)
    # Get currrent user access token from session
    access_token = session['oauth_access_token']
    auth.setToken(access_token.key, access_token.secret)
    api = API(auth)
    # Get info from weibo
    return api.me()

def login_ok(f):
    def login_wrapper(*args, **kw):
        if 'oauth_access_token' not in session:
            return redirect('/login')
        return f(*args, **kw)
    return login_wrapper

@app.route('/')
@login_ok
def hello():
    user = get_weibo_user()
    return "Hello, %s <img src=%s>" % (user.screen_name, user.profile_image_url)

@app.route('/login')
def login():
    session['login_ok_url'] = get_referer()
    callback = 'http://appstack.sinaapp.com/login_callback'

    auth = OAuthHandler(consumer_key, consumer_secret, callback)
    # Get request token and login url from the provider
    url = auth.get_authorization_url()
    session['oauth_request_token'] = auth.request_token
    # Redirect user to login
    return redirect(url)

@app.route('/login_callback')
def login_callback():
    # This is called by the provider when user has granted permission to your app
    verifier = request.args.get('oauth_verifier', None)
    auth = OAuthHandler(consumer_key, consumer_secret)
    request_token = session['oauth_request_token']
    del session['oauth_request_token']
    
    # Show the provider it's us really
    auth.set_request_token(request_token.key, request_token.secret)
    # Ask for a temporary access token
    session['oauth_access_token'] = auth.get_access_token(verifier)
    return redirect(session.get('login_ok_url', '/'))

@app.route('/logout')
def logout():
    del session['oauth_access_token']
    return redirect(get_referer())

请参阅 examples/weibo 。

使用sinaweibopy(推荐)

新浪微博API OAuth 2 Python客户端

http://open.weibo.com/wiki/SDK#Python_SDK

http://code.google.com/p/sinaweibopy/

中文分词¶

分词服务请求

SAE分词服务请求采用以下形式的HTTP网址：

http://segment.sae.sina.com.cn/urlclient.php?parameters

parameters为请求参数，多个参数之间使用&分割，以下列出了这些参数和其可能的值。

word_tag: 是否返回词性数据。0表示不返回，1表示返回，默认为0不返回。
encoding: 请求分词的文本的编码，可以为: GB18030、UTF-8、UCS-2，默认为UTF-8。

请求分词的文本以post的形式提交。

context: 请求分词的文本。目前限制文本大小最大为10KB。

分词服务响应

分词服务的响应数据为json格式，格式如下：

[
    {"word":"采莲","word_tag":"171","index":"1"},
    {"word":"赋","word_tag":"170","index":"2"}
]

响应数据为一个list，list中每个元素为一个dict，每个dict中包含以下数据：

index: 序列号，按在请求文本中的位置依次递增。
word: 单词
word_tag: 单词的词性，仅当输入parameters里word_tag为1时包含该项。

词性代码：

 POSTAG_ID_UNKNOW 未知
POSTAG_ID_A      形容词
POSTAG_ID_B      区别词
POSTAG_ID_C      连词
POSTAG_ID_C_N    体词连接
POSTAG_ID_C_Z    分句连接
POSTAG_ID_D      副词
POSTAG_ID_D_B    副词("不")
POSTAG_ID_D_M    副词("没")
POSTAG_ID_E      叹词
POSTAG_ID_F      方位词
POSTAG_ID_F_S    方位短语(处所词+方位词)
POSTAG_ID_F_N    方位短语(名词+方位词“地上”)
POSTAG_ID_F_V    方位短语(动词+方位词“取前”)
POSTAG_ID_F_Z    方位短语(动词+方位词“取前”)
POSTAG_ID_H      前接成分
POSTAG_ID_H_M    数词前缀(“数”---数十)
POSTAG_ID_H_T    时间词前缀(“公元”“明永乐”)
POSTAG_ID_H_NR   姓氏
POSTAG_ID_H_N    姓氏
POSTAG_ID_K      后接成分
POSTAG_ID_K_M    数词后缀(“来”--,十来个)
POSTAG_ID_K_T    时间词后缀(“初”“末”“时”)
POSTAG_ID_K_N    名词后缀(“们”)
POSTAG_ID_K_S    处所词后缀(“苑”“里”)
POSTAG_ID_K_Z    状态词后缀(“然”)
POSTAG_ID_K_NT   状态词后缀(“然”)
POSTAG_ID_K_NS   状态词后缀(“然”)
POSTAG_ID_M      数词
POSTAG_ID_N      名词
POSTAG_ID_N_RZ   人名(“毛泽东”)
POSTAG_ID_N_T    机构团体(“团”的声母为t，名词代码n和t并在一起。“公司”)
POSTAG_ID_N_TA   ....
POSTAG_ID_N_TZ   机构团体名("北大")
POSTAG_ID_N_Z    其他专名(“专”的声母的第1个字母为z，名词代码n和z并在一起。)
POSTAG_ID_NS     名处词
POSTAG_ID_NS_Z   地名(名处词专指：“中国”)
POSTAG_ID_N_M    n-m,数词开头的名词(三个学生)
POSTAG_ID_N_RB   n-rb,以区别词/代词开头的名词(该学校，该生)
POSTAG_ID_O      拟声词
POSTAG_ID_P      介词
POSTAG_ID_Q      量词
POSTAG_ID_Q_V    动量词(“趟”“遍”)
POSTAG_ID_Q_T    时间量词(“年”“月”“期”)
POSTAG_ID_Q_H    货币量词(“元”“美元”“英镑”)
POSTAG_ID_R      代词
POSTAG_ID_R_D    副词性代词(“怎么”)
POSTAG_ID_R_M    数词性代词(“多少”)
POSTAG_ID_R_N    名词性代词(“什么”“谁”)
POSTAG_ID_R_S    处所词性代词(“哪儿”)
POSTAG_ID_R_T    时间词性代词(“何时”)
POSTAG_ID_R_Z    谓词性代词(“怎么样”)
POSTAG_ID_R_B    区别词性代词(“某”“每”)
POSTAG_ID_S      处所词(取英语space的第1个字母。“东部”)
POSTAG_ID_S_Z    处所词(取英语space的第1个字母。“东部”)
POSTAG_ID_T      时间词(取英语time的第1个字母)
POSTAG_ID_T_Z    时间专指(“唐代”“西周”)
POSTAG_ID_U      助词
POSTAG_ID_U_N    定语助词(“的”)
POSTAG_ID_U_D    状语助词(“地”)
POSTAG_ID_U_C    补语助词(“得”)
POSTAG_ID_U_Z    谓词后助词(“了、着、过”)
POSTAG_ID_U_S    体词后助词(“等、等等”)
POSTAG_ID_U_SO   助词(“所”)
POSTAG_ID_W      标点符号
POSTAG_ID_W_D    顿号(“、”)
POSTAG_ID_W_SP   句号(“。”)
POSTAG_ID_W_S    分句尾标点(“，”“；”)
POSTAG_ID_W_L    搭配型标点左部
POSTAG_ID_W_R    搭配型标点右部(“》”“]”“）”)
POSTAG_ID_W_H    中缀型符号
POSTAG_ID_Y      语气词(取汉字“语”的声母。“吗”“吧”“啦”)
POSTAG_ID_V      及物动词(取英语动词verb的第一个字母。)
POSTAG_ID_V_O    不及物谓词(谓宾结构“剃头”)
POSTAG_ID_V_E    动补结构动词(“取出”“放到”)
POSTAG_ID_V_SH   动词“是”
POSTAG_ID_V_YO   动词“有”
POSTAG_ID_V_Q    趋向动词(“来”“去”“进来”)
POSTAG_ID_V_A    助动词(“应该”“能够”)
POSTAG_ID_Z      状态词(不及物动词,v-o、sp之外的不及物动词)
POSTAG_ID_X      语素字
POSTAG_ID_X_N    名词语素(“琥”)
POSTAG_ID_X_V    动词语素(“酹”)
POSTAG_ID_X_S    处所词语素(“中”“日”“美”)
POSTAG_ID_X_T    时间词语素(“唐”“宋”“元”)
POSTAG_ID_X_Z    状态词语素(“伟”“芳”)
POSTAG_ID_X_B    状态词语素(“伟”“芳”)
POSTAG_ID_SP     不及物谓词(主谓结构“腰酸”“头疼”)
POSTAG_ID_MQ     数量短语(“叁个”)
POSTAG_ID_RQ     代量短语(“这个”)
POSTAG_ID_AD     副形词(直接作状语的形容词)
POSTAG_ID_AN     名形词(具有名词功能的形容词)
POSTAG_ID_VD     副动词(直接作状语的动词)
POSTAG_ID_VN     名动词(指具有名词功能的动词)
POSTAG_ID_SPACE  空格

例：

chinese_text = """
这里填上需要分词的文本
"""

_SEGMENT_BASE_URL = 'http://segment.sae.sina.com.cn/urlclient.php'

payload = urllib.urlencode([('context', chinese_text),])
args = urllib.urlencode([('word_tag', 1), ('encoding', 'UTF-8'),])
url = _SEGMENT_BASE_URL + '?' + args
result = urllib2.urlopen(url, payload).read()

FAQ¶

怎么寻求帮助¶

关于SAE Python相关服务的问题可以在以下地方反馈：

关于Python编程的其它问题，推荐到 CPyUG邮件列表和 Python编程豆瓣小组寻求帮助。

如何调试¶

复杂程序建议您本地调试成功后，再上传运行。

SAE Python 版本为 2.6.7。如果你使用内置的第三方库版本，请注意使用同样的版本调试，如支持的Django为1.2.7。

如何捕获wsgi应用的异常，请参阅 http://www.python.org/dev/peps/pep-0333/

501 页面对应的常见处理办法，请检查:

使用dev_server查看是否有语法错误
模块是否正确安装
是否遵循WSGI规范，返回iterator
数据库设置是否正确，是否已在SAE管理界面启用MYSQL，是否已创建数据表，初始化
是否已经打开framework的debug功能

有的framework默认关闭了debug功能，如果程序有问题则只返回500 internal error，没有异常堆栈信息，这样调试起来很困难。在开发过程中，请确认框架的debug功能处于开启状态。

对于无法加载index.wsgi，index.wsgi中没有application callable等等严重错误，SAE Python会直接在浏览器中打印出异常，其余应用没有捕获的异常会打印到应用的日志中，如果需要SAE Python将所有应用未捕获的异常打印到浏览器，请按如下创建application。

Note

在header已经发出的情况下，异常在浏览器中可能显示不出来，请查看日志。

Python新手？入门教程¶

笨办法学Python, Learn Python The Hard Way

作者: Zed Shaw, 译者: wangdingwei82@gmail.com

http://readthedocs.org/docs/learn-python-the-hard-way-zh_cn-translation/en/latest/index.html
Python 2.6.7 官方教程

http://docs.python.org/release/2.6.7/tutorial/index.html
Python模块索引

http://docs.python.org/release/2.6.7/modindex.html

没有我要使用的包，怎么办？¶

Don’t panic. See howto-use-sae-python-with-virtualenv

关于svn的问题¶

Warning

不要使用svn cp，mv，目前还不支持这两个操作。

http://sae.sina.com.cn/?m=devcenter&catId=211

大文件，文件数多上传 http://www.douban.com/group/topic/23353500/

bug 静态目录不支持多级？ http://www.douban.com/group/topic/23692928/

建议遇到奇怪svn错误，可以：

重新在本地新建目录，检出干净的svn
或者先保存代码，然后删除该版本，重新导入

你也许需要新建一个版本，默认版本无法删除。

WTF！ MySQL gone away¶

MySQL连接超时时间为30s，所以你需要在代码中检查是否超时，是否需要重连。

【bug？】我用tornado db连接出现了mysql gone away... http://www.douban.com/group/topic/23673391/

mysql中创建表的问题 http://www.douban.com/group/topic/23689631/

flask-sqlalchemy 如何在每次请求时重新连接数据库 http://www.douban.com/group/topic/24103570/

资费说明¶

http://sae.sina.com.cn/?m=devcenter&catId=155

如何区分本地开发环境和线上环境？¶

一个可靠的方法:

if 'SERVER_SOFTWARE' in os.environ:
    # SAE
else:
    # Local

反馈¶

SAE Python 小组 http://www.douban.com/group/373262/

SAE Python Developer's Guide 1.1testing documentation

SAE Python 开发者手册¶

Quick Start 快速指引¶

Hello, world!¶

创建新应用¶

检出svn代码¶

创建index.wsgi¶

提交代码¶

访问应用¶

使用web开发框架¶

Django¶

Flask¶

Bottle¶

Tornado¶

Uliweb¶

uliweb的安装¶

Hello, Uliweb¶

数据库配置¶

web.py¶

SAE Python环境¶

环境信息¶

预装模块列表¶

请求处理¶

Python环境¶

日志系统¶

应用缓存¶

应用程序配置¶

可用服务列表¶

访问互联网¶

MySQL¶

连接信息¶

数据库导入¶

字符集问题¶

TaskQueue, Cron¶

什么是任务¶

Taskqueue¶

Cron¶

登录和CRSF¶

如何保护任务URL¶

Cron和Taskqueue中使用weibo api¶

Cron 完整示例¶

原有的PHP文档¶

Mail¶

Memcache¶

Storage¶

KVDB(TBD)¶

开启和关闭¶

sae.kvdb¶

示例代码¶

第三方认证接入¶

新浪微博¶

中文分词¶

相关工具¶

使用dev_server进行调试¶

Install¶

基本使用¶

使用MySQL服务¶

使用storage服务¶

使用pylibmc¶

使用virtualenv管理依赖关系¶

使用saecloud部署应用¶

安装¶

导出已有应用代码¶

部署新代码¶

saecloud和git workflow¶

可用插件¶

SAE Python Shell¶

FAQ¶

怎么寻求帮助¶

如何调试¶

Python新手？入门教程¶

没有我要使用的包，怎么办？¶

关于svn的问题¶

WTF！ MySQL gone away¶

资费说明¶

如何区分本地开发环境和线上环境？¶

反馈¶