WSGI

2017-05-09

博文 WSGI 简介对 WSGI 说的很清楚：

WSGI的全称是Web Server Gateway Interface，翻译过来就是Web服务器网关接口。具体的来说，WSGI 是一个规范，定义了 Web 服务器如何与 Python 应用程序进行交互，使得使用 Python 写的 Web 应用程序可以和 Web 服务器对接起来。

上边已经说的很清楚，WSGI 就是用来规范 Web 服务器（如 Apache）如何与 Python 应用程序（如 Django）进行交互的。这个很重要，因为一般来说，服务器（程序）只有一个（专门处理 HTTP 请求），但应用程序却种类繁多，不可能让服务器为了某个应用程序而开发一套跟其交互的方案；而通过规范（类似 TCP/IP 协议），却能够让服务器与采用同样规范的应用程序连接起来，而不用单独考虑应用程序的特殊性。

上边提到的博客已经讲的非常好了，所以本文更多的是对 WSGI 的实践。另外一个要参考的资料是 Python 官方针对 WSGI 的提案 PEP 3333。这个方案对 WSGI 的各种细节参数都说明的非常详细，一定要仔细看。

WSGI 工作原理

根据前边提到的，WSGI 涉及到两个角色：服务器（称为 Server 或 Gateway）与应用程序（称为 Application 或 Framework）。服务器接收客户端的请求，然后根据请求调用相应的应用程序，应用程序处理完之后返回结果给服务器，服务器（经处理）再将结果返回给客户端。具体地，应用程序向服务端提供一个可调用的对象（callable object，函数或类，是应用程序的入口），该对象（入口）接收服务端传入的两个参数（environ 和 start_response）；服务端通过调用该对象（入口），从而实现对该应用程序的调用，如下图所示：

more >>

展开全文 >>

项目模板之 Cookiecutter

2017-05-08

平常看到的每个 OpenStack 项目都有比较类似的项目结构，如 Nova 的项目结构：

$ tree -L 1 nova
nova
├── api-guide
├── api-ref
├── babel.cfg*
├── bindep.txt
├── contrib
├── CONTRIBUTING.rst*
├── devstack
├── doc*
├── etc
├── HACKING.rst*
├── LICENSE*
├── MAINTAINERS
├── nova
├── nova.egg-info
├── plugins
├── README.rst*
├── releasenotes
├── requirements.txt*
├── run_tests.sh
├── setup.cfg*
├── setup.py*
├── test-requirements.txt*
├── tests-py3.txt
├── tools
└── tox.ini*

11 directories, 14 files

要生成类似这样的项目，我们可以使用 Python 的 Cookiecutter 包。Github 介绍其为一个用于生成项目（不局限于 Python 项目）模板的命令行工具。下边我们来看下怎么用该工具来生成 OpenStack 项目模板。

more >>

展开全文 >>

插件动态加载之 Stevedore

2017-05-07

最近在学习 OpenStack 源码时，发现有些模块（如 Ceilometer）使用了动态插件加载包 Stevedore，感觉有必要记录一下。

本文的例子基本摘录自博文 Sora–OpenStack 基础库 stevedore 试用总结，并在其基础上添加一些额外的东西（如 Stevedore Extention）。

项目结构如下：

sora
├── scheduler               # 插件（可以有多个）
│   ├── base.py
│   ├── __init__.py
│   ├── memory.py
│   └── simple.py
├── setup.py
└── tests
    ├── test-ori-usage.py   # 原始使用库方式（import ...）
    ├── test.py             # 测试 Stevedore （DriverManager）
    └── test-extension.py   # 测试 Stevedore 扩展（ExtensionManager）

2 directory, 8 files

插件编写

这里的插件名为 scheduler（可以有多个）。设计 API 的一个好的实践就是定义一个抽象类作为基类（这也是 Stevedore 官方样例的做法）：

# sora/scheduler/base.py
import abc
import six


@six.add_metaclass(abc.ABCMeta)
class Scheduler(object):

    @abc.abstractmethod
    def scheduler(self, data):
        pass

more >>

展开全文 >>

协程和并发课程【部分八~九】

2017-05-01

此文紧接上文协程和并发课程【部分五~七】。

第八部分：栈引起的问题

Trampolining

当程序涉及协程时，我们不能调用使用了 yield （可以挂起）的子函数。yield 语句只能在最上层挂起协程。例如在以下例子中，foo() 函数并不会因为调用了可以被挂起的 bar() 函数就能够被挂起：

def bar():
    yield

def foo():
    bar()

去除这个限制的方法之一就是无栈 Python。具体的实现技巧叫 Trampolining，中文译名跳床。这中文译名怪怪的，我们还是叫 Tramplining 吧。例如，下边就是利用了该技巧的简单例子：

# trampoline.py
#
# A simple of example of trampoling between coroutines

# A subroutine
def add(x, y):
    yield x + y


# A function that calls a subroutine
def main():
    r = yield add(2, 2)
    print r
    yield


def run():
    m = main()
    # An example of a "trampoline"
    sub = m.send(None)
    result = sub.send(None)
    m.send(result)


run()