Litefs 文档

Litefs 是一个轻量级的 Python Web 框架，提供高性能的 HTTP 服务器、现代路由系统、WSGI 支持、中间件系统、缓存管理等功能。

核心功能:

进阶指南:

静态文件路由

测试文档:

开发规范:

API 文档:

API 参考
- litefs

其他资源:

功能特性

高性能 HTTP 服务器（支持 epoll、greenlet 和 asyncio）
现代路由系统（装饰器风格、方法链风格）
静态文件路由（支持子路径、MIME 类型检测、安全防护）
WSGI 1.0 兼容（PEP 3333）
ASGI 3.0 兼容
支持 Gunicorn、uWSGI、Waitress 等 WSGI 服务器
支持 Uvicorn、Daphne、Hypercorn 等 ASGI 服务器
Mako 模板引擎支持
会话管理（Memory、Redis、Database、Memcache 后端）
多级缓存系统（Memory + Tree cache + Redis）
中间件系统（日志、安全、CORS 等）
认证授权系统（JWT、OAuth2 社交登录、角色权限管理）
WebSocket 支持（实时通信、房间管理、心跳检测）
Celery 任务队列集成（异步任务、定时任务）
OpenAPI/Swagger 文档自动生成
开发调试工具（请求检查、SQL 日志、性能分析）
健康检查系统
Prometheus 监控（请求指标、连接池状态、缓存命中率）
Alembic 数据库迁移（版本化 schema 管理）
邮件发送（SMTP、TLS/SSL、Mako 模板、附件、Celery 异步投递）
国际化（gettext 翻译表、请求级 locale 协商、模板翻译函数）
性能回归门禁（基线阈值固化，自动比对 RPS 与 P99）
依赖安全审计（pip-audit 定期扫描，CI 报告归档）
文件监控和热重载
Python 3.8+ 支持（v0.14.0 起收敛至 3.10+，详见 Litefs 版本演进路线（0.10.0 → 1.0.0））

快速开始

安装

pip install litefs

或从源码安装：

git clone https://github.com/leafcoder/litefs.git
cd litefs
pip install -r requirements.txt
python setup.py install

基本使用

使用现代路由系统：

from litefs.core import Litefs
from litefs.routing import get, post

app = Litefs(
    host='0.0.0.0',
    port=8080,
    debug=True
)

@get('/', name='index')
def index_handler(request):
    return 'Hello, World!'

@get('/user/{id}', name='user_detail')
def user_detail_handler(request, id):
    return f'User ID: {id}'

@post('/login', name='login')
def login_handler(request):
    username = request.data.get('username')
    password = request.data.get('password')
    return {'status': 'success', 'username': username}

app.run()

或使用方法链风格：

from litefs.core import Litefs

app = Litefs()

def index_handler(request):
    return 'Hello, World!'

def user_detail_handler(request, id):
    return f'User ID: {id}'

app.add_get('/', index_handler, name='index')
app.add_get('/user/{id}', user_detail_handler, name='user_detail')

app.run()

静态文件路由

from litefs.core import Litefs

app = Litefs()

app.add_static('/static', './static', name='static')

app.run()

访问静态文件：

详细的说明请参考路由系统和静态文件路由。

WSGI 部署

创建 wsgi.py：

from litefs.core import Litefs
from litefs.routing import get

app = Litefs()

@get('/', name='index')
def index_handler(request):
    return 'Hello, World!'

application = app.wsgi()

使用 Gunicorn 部署：

gunicorn -w 4 -b :8000 wsgi:application

使用 uWSGI 部署：

uwsgi --http :8000 --wsgi-file wsgi.py

使用 Waitress 部署（Windows）：

waitress-serve --port=8000 wsgi:application

详细的部署说明请参考 WSGI 部署。