Responser 是一个基于 Python 3 的 Web 框架。具有以下特点：
- 使用异步请求处理和响应
- 简单易用
- 具有可扩展性
- 充分利用了 Python 3 的协程特性
一、路由
路由是 Web 应用程序的核心。它决定了应用程序如何响应不同的 URL 请求。在 Responser 中，可以通过定义路由表来实现路由。
示例：
from responder import API
api = API()
@api.route("/")
async def foo(req, resp):
resp.text = "Hello, World!"
在这个示例中，我们创建了一个 API 实例，并定义了一个路由表。当请求根 URL 时，Responser 将使用定义的处理程序 "foo" 来响应请求，该处理程序设置了响应的文本内容为 "Hello, World!"。
除此之外，Responser 还支持带参数的 URL。在路由表中，可以使用大括号来指定参数。
示例：
@api.route("/users/{username}")
async def user_profile(req, resp, *, username):
resp.text = f"User {username}"
在这个示例中，我们定义了一个带参数的路由，其参数名为 "username"。当请求 "/users/john" 时，Responser 将使用定义的处理程序 "user_profile" 来响应请求，该处理程序设置了响应的文本内容为 "User john"。
二、请求和响应
请求和响应是 Web 应用程序的基本组成部分。在 Responser 中，可以通过 Request 和 Response 对象来处理请求和响应。
示例：
@api.route("/")
async def echo_req(req, resp):
resp.media = req.media
在这个示例中，我们定义了一个处理程序 "echo_req"，它将请求的 media 内容直接返回为响应的 media 内容。
除此之外，在 Responser 中，还可以设置响应的状态码和头信息。
示例：
@api.route("/")
async def custom_resp(req, resp):
resp.status_code = 201
resp.headers["Custom-Header"] = "custom_value"
resp.media = {"message": "Custom response!"}
在这个示例中，我们定义了一个处理程序 "custom_resp"，它设置了响应的状态码为 201，设置了自定义响应头 "Custom-Header"，并设置响应的 media 内容为 {"message": "Custom response!"}。
三、中间件
中间件是在路由之前或之后执行的一系列处理程序。在 Responser 中，可以通过定义中间件来实现对请求和响应的统一处理。
示例：
async def middleware(req, resp, *, call_next):
print("Before request handler")
response = await call_next(req, resp)
response.headers["X-Middleware"] = "Done"
print("After request handler")
return response
api = API(middleware=[middleware])
@api.route("/")
async def hello(req, resp):
resp.text = "Hello, World!"
在这个示例中，我们定义了一个名为 "middleware" 的中间件，在请求处理程序之前和之后分别输出一行日志。在创建 API 实例时，将中间件传递给构造函数，并在路由表中定义了一个处理程序 "hello"。在运行时，当请求根 URL 时，Responser 将依次执行 "middleware"、"hello"，并在响应头中添加了自定义头 "X-Middleware"。
四、模板引擎
模板引擎是一种将数据和模板结合生成 HTML 或其他格式文本的工具。在 Responser 中，可以使用 Jinja2 模板引擎来生成 HTML。
示例：
import responder
from jinja2 import Template
api = responder.API()
@api.route("/{name}")
async def greet_person(req, resp, *, name):
template = Template("Hello {{ name }}!
")
html = template.render({"name": name})
resp.html = html
在这个示例中，我们引入了 Jinja2 模板引擎，并在路由表中定义了一个处理程序 "greet_person"。当请求 URL "/John" 时，Responser 将使用 Jinja2 渲染 HTML 模板 "Hello {{ name }}!"，并将变量 "name" 设置为 "John"。渲染完成后，Responser 将将生成的 HTML 作为响应的 html 内容返回。
五、WebSocket
WebSocket 是一种协议，它允许在客户端和服务器之间建立一个双向通信的通道。在 Responser 中，可以通过 WebSocket API 实现 WebSockets 通信。
示例：
@api.route("/ws")
async def websocket(req, ws):
await ws.accept()
while True:
message = await ws.receive_text()
await ws.send_text(f"You said: {message}")
在这个示例中，我们在路由表中定义了一个 WebSocket 处理程序 "websocket"，它接受 WebSockets 连接并在连接建立后不断地监听客户端发送的消息。当接收到消息时，处理程序将回复 "You said: {message}"。
六、静态文件
静态文件是网站所必需的不变文件，如图像、CSS、JavaScript 和字体等。在 Responser 中，可以通过在路由表中定义静态文件路由来提供静态文件。
示例：
import os
import responder
api = responder.API()
@api.route("/static/{filepath}")
async def server_static(req, resp, *, filepath):
static_path = "static"
file_path = os.path.join(static_path, filepath)
if os.path.exists(file_path):
resp.content_type = responder.models.CONTENT_TYPE.AUTO
resp.content = responder.static_file(file_path)
else:
resp.text = "File not found"
resp.status_code = 404
在这个示例中，我们定义了一个路由 "/static/{filepath}"，当请求该路由时，处理程序将在 "static" 目录下寻找文件。如果文件存在，则响应文件内容，并自动设置响应的 content_type。如果文件不存在，则返回 "File not found"。
七、总结
Responser 是一个基于 Python 3 的 Web 框架，具有简单易用、高效强大的特性。在 Responser 中，可以使用路由、请求、响应、中间件、模板引擎、WebSocket 和静态文件等功能来开发 Web 应用程序。
