SAE Python development server - experimental

All Rights Reserved 2011

SAE Python Team

目前支持的服务包括：mysql, taskqueue, memcache, storage, mail。

大部分的服务直接运行dev_server.py进行调试就可以了，部分服务需要做一些配置。

注意： 本工具仅为应用开发便利之用，对sae python环境的模拟并不完整。

Install

--------------

sudo python setup.py install

基本使用

------------

使用svn检出app代码之后，建立以数字为标识的发布目录，切换到发布目录:

$ pwd

/home/jaime/source/blackfire/1

编辑index.wsgi和config.yaml:

$ vi 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! reloading test3']

application = sae.create_wsgi_app(app)

$ vi config.yaml

---

name: blackfire

version: 1

...

运行dev_server.py:

$ dev_server.py

MySQL config not found: app.py

Start development server on http://localhost:8080/

访问 http://localhost:8080 端口就可以看到Hello, world!了。

使用MySQL服务

----------------

配置好MySQL本地开发server，使用 `--mysql` 参数运行dev_server.py。

$ dev_server.py --mysql=user:password@host:port

现在你可以在应用代码中像在SAE线上环境一样使用MySQL服务了。dev_server.py默认使用

名为 `app_应用名` 的数据库。

使用storage服务

---------------

使用 `--storage-path` 参数运行dev_server.py。

$ dev_server.py --storage-path=/path/to/local/storage/data

本地的storage服务使用以下的目录结构来模拟线上的storage。

storage-path/

domain1/

key1

key2

domain2/

domain3/

--storage-path配置的路径下每个子文件夹会映射为storage中的一个domain，而每个子文

件夹下的文件映射为domain下的一个key，其内容为对应key的数据。

.. note:

为方便调试，dev_server自带的sae.storage在某个domain不存在的情况下会自动创建

该domain。线上环境中的domain需要在sae后台面板中手动创建。

使用pylibmc

--------------

dev_server自带了一个dummy pylibmc，所以无须安装pylibmc就可以直接使用memcache服务

了。该模块将所有的数据存贮在内存中，dev_server.py进程结束时，所有的数据都会丢失

。

使用kvdb

----------------

kvdb默认数据存在内存中，dev_server.py进程结束时，数据会全部丢失，如果需要保存数据，

请使用如下命令行启动dev_server.py

$ dev_server.py --kvdb-file=/path/to/kvdb/local/file