摘要：詳細(xì)信息可以看下這個(gè)問題先在說下我的部署方式使用部署配置文件啟動(dòng)方式總結(jié)試用了下，把之前的一個(gè)聊天機(jī)器人從改成了。預(yù)告下一篇將介紹如何使用一步一步創(chuàng)建一個(gè)聊天機(jī)器人。

Sanic 是一個(gè)和類Flask 的基于Python3.5+的web框架，它編寫的代碼速度特別快。
除了像Flask 以外，Sanic 還支持以異步請(qǐng)求的方式處理請(qǐng)求。這意味著你可以使用新的 async/await 語(yǔ)法，編寫非阻塞的快速的代碼。

關(guān)于 asyncio 包的介紹，請(qǐng)參考之前的一篇文章 python并發(fā)2：使用asyncio處理并發(fā)

Github 地址 是 https://github.com/channelcat/sanic，感興趣的可以去貢獻(xiàn)代碼。

既然它說速度特別快，我們先看下官方提供的 基準(zhǔn)測(cè)試結(jié)果。

這個(gè)測(cè)試的程序運(yùn)行在 AWS 實(shí)例上，系統(tǒng)是Ubuntu，只使用了一個(gè)進(jìn)程。

Sanic 的開發(fā)者說他們的靈感來自于這篇文章 uvloop: Blazing fast Python networking。

那我們就有必要看下uvloop是個(gè)什么庫(kù)。

uvloop 是 asyncio 默認(rèn)事件循環(huán)的替代品，實(shí)現(xiàn)的功能完整，切即插即用。uvloop是用CPython 寫的，建于libuv之上。
uvloop 可以使 asyncio 更快。事實(shí)上，它至少比 nodejs、gevent 和其他 Python 異步框架要快兩倍 ?；?uvloop 的 asyncio 的速度幾乎接近了 Go 程序的速度。

uvloop 還只能在 *nix 平臺(tái) 和 Python3.5+以上版本使用。
使用pip安裝：

pip install uvloop

在 asyncio 代碼中使用uvloop 也很簡(jiǎn)單：

import asyncio
import uvloop
asyncio.set_event_loop_policy(uvloop.EventLoopPolicy())

這得代碼使得對(duì)任何asyncio.get_event_loop() 的調(diào)用都將返回一個(gè)uvloop實(shí)例。

詳細(xì)的uvloop 介紹可以看下原文：uvloop: Blazing fast Python networking。

uvloop的github地址是https://github.com/MagicStack/uvloop。

現(xiàn)在我們開始學(xué)習(xí)Sanic：

pip install sanic

from sanic import Sanic
from sanic.response import text

app = Sanic(__name__)

@app.route("/")
async def test(request):
    return text("Hello world!")

app.run(host="0.0.0.0", port=8000, debug=True)

運(yùn)行代碼： python main.py, 現(xiàn)在打開瀏覽器訪問 http://0.0.0.0:8000，你會(huì)看到 hello world!。

如果你熟悉Flask，你會(huì)發(fā)現(xiàn)，這個(gè)語(yǔ)法簡(jiǎn)直和Flask一模一樣。

路由用于把一個(gè)函數(shù)綁定到一個(gè) URL。下面是一些基本的例子：

@app.route("/")
def index():
    return text("Index Page")

@app.route("/hello")
def hello():
    return text("Hello World")

當(dāng)然，你還可以動(dòng)態(tài)的變化URL的某些部分，還可以為一個(gè)函數(shù)指定多個(gè)規(guī)則。

通過把 URL 的一部分標(biāo)記為 就可以在 URL 中添加變量。標(biāo)記的 部分會(huì)作為關(guān)鍵字參數(shù)傳遞給函數(shù)。通過使用 ，可以 選擇性的加上一個(gè)轉(zhuǎn)換器，為變量指定特定的類型，如果傳入的類型錯(cuò)誤，Sanic會(huì)拋出NotFound異常。請(qǐng)看下面的例子:

from sanic.response import text

@app.route("/tag/")
async def tag_handler(request, tag):
    return text("Tag - {}".format(tag))

@app.route("/number/")
async def integer_handler(request, integer_arg):
    return text("Integer - {}".format(integer_arg))

@app.route("/number/")
async def number_handler(request, number_arg):
    return text("Number - {}".format(number_arg))

@app.route("/person/")
async def person_handler(request, name):
    return text("Person - {}".format(name))

@app.route("/folder/")
async def folder_handler(request, folder_id):
    return text("Folder - {}".format(folder_id))

默認(rèn)情況下，我們定義的URL只支持GET 請(qǐng)求，@app.route裝飾器提供了一個(gè)可選參數(shù)methods，這個(gè)參數(shù)允許傳入所有HTTP 方法。
例如：

from sanic.response import text

@app.route("/post", methods=["POST"])
async def post_handler(request):
    return text("POST request - {}".format(request.json))

@app.route("/get", methods=["GET"])
async def get_handler(request):
    return text("GET request - {}".format(request.args))

也可以簡(jiǎn)寫為：

from sanic.response import text

@app.post("/post")
async def post_handler(request):
    return text("POST request - {}".format(request.json))

@app.get("/get")
async def get_handler(request):
    return text("GET request - {}".format(request.args))

除了@app.route裝飾器，Sanic 還提供了 add_route 方法。

@app.route 只是包裝了 add_route方法。

from sanic.response import text

# Define the handler functions
async def handler1(request):
    return text("OK")

async def handler2(request, name):
    return text("Folder - {}".format(name))

async def person_handler2(request, name):
    return text("Person - {}".format(name))

# Add each handler function as a route
app.add_route(handler1, "/test")
app.add_route(handler2, "/folder/")
app.add_route(person_handler2, "/person/", methods=["GET"])

如果可以匹配URL，那么Sanic可以生成URL嗎？當(dāng)然可以，url_for() 函數(shù)就是用于構(gòu)建指定函數(shù)的URL的。它把函數(shù)名稱作為第一個(gè)參數(shù)，其余參數(shù)對(duì)應(yīng)URL中的變量，例如：

@app.route("/")
async def index(request):
    # generate a URL for the endpoint `post_handler`
    url = app.url_for("post_handler", post_id=5)
    # the URL is `/posts/5`, redirect to it
    return redirect(url)


@app.route("/posts/")
async def post_handler(request, post_id):
    return text("Post - {}".format(post_id))

未定義變量會(huì)作為URL的查詢參數(shù)：

url = app.url_for("post_handler", post_id=5, arg_one="one", arg_two="two")
# /posts/5?arg_one=one&arg_two=two

# 支持多值參數(shù)
url = app.url_for("post_handler", post_id=5, arg_one=["one", "two"])
# /posts/5?arg_one=one&arg_one=two

Sanic也提供了和Flask 類似的 Blueprint。
Blueprint有以下用途：

把一個(gè)應(yīng)用分解為一套藍(lán)圖。這是針對(duì)大型應(yīng)用的理想方案：一個(gè)項(xiàng)目可以實(shí)例化一個(gè) 應(yīng)用，初始化多個(gè)擴(kuò)展，并注冊(cè)許多藍(lán)圖。

在一個(gè)應(yīng)用的 URL 前綴和（或）子域上注冊(cè)一個(gè)藍(lán)圖。 URL 前綴和（或）子域的參數(shù) 成為藍(lán)圖中所有視圖的通用視圖參數(shù)（缺省情況下）。

使用不同的 URL 規(guī)則在應(yīng)用中多次注冊(cè)藍(lán)圖。

通過藍(lán)圖提供模板過濾器、靜態(tài)文件、模板和其他工具。藍(lán)圖不必執(zhí)行應(yīng)用或視圖 函數(shù)。

from sanic import Sanic
from sanic.response import json
from sanic import Blueprint

bp = Blueprint("my_blueprint")

@bp.route("/")
async def bp_root(request):
    return json({"my": "blueprint"})
    
app = Sanic(__name__)
app.blueprint(bp)

app.run(host="0.0.0.0", port=8000, debug=True)

Sanic 使用 app.blueprint() 方法注冊(cè)blueprint。

@bp.middleware
async def print_on_request(request):
    print("I am a spy")

@bp.middleware("request")
async def halt_request(request):
    return text("I halted the request")

@bp.middleware("response")
async def halt_response(request, response):
    return text("I halted the response")

@bp.exception(NotFound)
def ignore_404s(request, exception):
    return text("Yep, I totally found the page: {}".format(request.url))

第一個(gè)參數(shù)指向當(dāng)前的Python包
第二個(gè)參數(shù)是靜態(tài)文件的目錄

bp.static("/folder/to/serve", "/web/path")

如果要?jiǎng)?chuàng)建頁(yè)面鏈接，可以和通常一樣使用 url_for() 函數(shù)，只是要把藍(lán)圖名稱作為端點(diǎn)的前綴，并且用一個(gè)點(diǎn)（ . ）來 分隔:

@blueprint_v1.route("/")
async def root(request):
    url = app.url_for("v1.post_handler", post_id=5) # --> "/v1/post/5"
    return redirect(url)


@blueprint_v1.route("/post/")
async def post_handler(request, post_id):
    return text("Post {} in Blueprint V1".format(post_id))

對(duì)于web 應(yīng)用來說對(duì)客戶端向服務(wù)器發(fā)送的數(shù)據(jù)做出相應(yīng)很重要，在Sanic中由傳入的參數(shù) request來提供請(qǐng)求信息。

為什么不像Flask 一樣提供一個(gè)全局變量 request？
Flask 是同步請(qǐng)求，每次請(qǐng)求都有一個(gè)獨(dú)立的新線程來處理，這個(gè)線程中也只處理這一個(gè)請(qǐng)求。而Sanic是基于協(xié)程的處理方式，一個(gè)線程可以同時(shí)處理幾個(gè)、幾十個(gè)甚至幾百個(gè)請(qǐng)求，把request作為全局變量顯然會(huì)比較難以處理。

Request 對(duì)象常用參數(shù)有

from sanic.response import json

@app.route("/json")
def post_json(request):
    return json({ "received": True, "message": request.json })

?key1=value1&key2=value2 將轉(zhuǎn)變?yōu)?/p>

{"key1": ["value1"], "key2": ["value2"]}

?key1=value1&key2=value2 將轉(zhuǎn)變?yōu)?/p>

{"key1": "value1", "key2": "value2"}

其他參數(shù)還有:

file

ip

app

url

scheme

path

query_string

詳細(xì)信息參考文檔: Request Data

Sanic使用response 函數(shù)創(chuàng)建響應(yīng)對(duì)象。

文本 response.text("hello world")

html response.html("

hello world

json response.json({"hello": "world"})

file response.file("/srv/www/hello.txt")

streaming

from sanic import response

@app.route("/streaming")
async def index(request):
    async def streaming_fn(response):
        response.write("foo")
        response.write("bar")
    return response.stream(streaming_fn, content_type="text/plain")

redirect response.file("/json")

raw response.raw("raw data")

如果想修改響應(yīng)的headers可以傳入headers 參數(shù)

from sanic import response

@app.route("/json")
def handle_request(request):
    return response.json(
        {"message": "Hello world!"},
        headers={"X-Served-By": "sanic"},
        status=200
    )

應(yīng)用總是需要一定的配置的。根據(jù)應(yīng)用環(huán)境不同，會(huì)需要不同的配置。比如開關(guān)調(diào)試 模式、設(shè)置密鑰以及其他依賴于環(huán)境的東西。
Sanic 的設(shè)計(jì)思路是在應(yīng)用開始時(shí)載入配置。你可以在代碼中直接硬編碼寫入配置，也可以使用配置文件。

不管你使用何種方式載入配置，都可以使用 Sanic 的 config 屬性來操作配置的值。 Sanic 本身就使用這個(gè)對(duì)象來保存 一些配置，擴(kuò)展也可以使用這個(gè)對(duì)象保存配置。同時(shí)這也是你保存配置的地方。

config 實(shí)質(zhì)上是一個(gè)字典的子類，可以像字典一樣操作：

app = Sanic("myapp")
app.config.DB_NAME = "appdb"
app.config.DB_USER = "appuser"

也可以一次更新多個(gè)配置：

db_settings = {
    "DB_HOST": "localhost",
    "DB_NAME": "appdb",
    "DB_USER": "appuser"
}
app.config.update(db_settings)

import myapp.default_settings

app = Sanic("myapp")
app.config.from_object(myapp.default_settings)

這里是我寫的聊天機(jī)器人的真實(shí)配置示例：https://github.com/gusibi/momo/

如果把配置放在一個(gè)多帶帶的文件中會(huì)更有用。理想情況下配置文件應(yīng)當(dāng)放在應(yīng)用包的 外面。這樣可以在修改配置文件時(shí)不影響應(yīng)用的打包與分發(fā)
常見用法如下:

app = Sanic("myapp")
app.config.from_envvar("MYAPP_SETTINGS")

首先從 myapp.default_settings 模塊載入配置，然后根據(jù) MYAPP_SETTINGS 環(huán)境變量所指向的文件的內(nèi)容重載配置的值。在 啟動(dòng)服務(wù)器前，在 Linux 或 OS X 操作系統(tǒng)中，這個(gè)環(huán)境變量可以在終端中使用 export 命令來設(shè)置:

$ export MYAPP_SETTINGS=/path/to/config_file
$ python myapp.py

Sanic 項(xiàng)目還不是特別成熟，現(xiàn)在部署比較簡(jiǎn)陋。對(duì)Gunicorn的支持也不完善。
詳細(xì)信息可以 看下這個(gè)問題 Projects built with sanic?

先在說下我的部署方式

supervisord 配置文件： https://github.com/gusibi/momo/blob/master/supervisord.conf

啟動(dòng) 方式

supervisord -c supervisor.conf

試用了下Sanic，把之前的一個(gè)聊天機(jī)器人從Flask 改成了 Sanic。不得不說，如果你有Flask經(jīng)驗(yàn)，大致看一下Sanic文檔就可以直接上手了。
并且Sanic 的速度比Flask 快很多，只是Sanic配套的包還是太少，用于生產(chǎn)環(huán)境有一定的風(fēng)險(xiǎn)。

最后對(duì)聊天微信聊天機(jī)器人感興趣的可以看下https://github.com/gusibi/momo。

下一篇將介紹如何使用 Sanic 一步一步創(chuàng)建一個(gè) 聊天機(jī)器人。

uvloop: Blazing fast Python networking

Sanic Githu 地址

Sanic 文檔

最后，感謝女朋友支持。

魔魔是我們家巴哥的名字
貼一張魔魔的照片結(jié)束本篇文章。