apistellar是基于apistar的web构建工具,同时增强了apistar的功能,使用apistellar可以轻松构建适合生产环境的web项目。
apistellar部分设计灵感参考ruby on rails
除了apistar本身的特性以外,apistellar增加如下几点高级用法:
- CSM架构,将控制层,业务层,模型层完全分离,耦合性降至最低。
- 模板式定制各类模型,轻松扩展模型定义的模板类。
- 适配sphinx注释语法,使用构建命令一键生成api文档。
- 集成flask版的session实现。
- 自带一些event hook,轻松集成异常、session处理。
- 集成配置模块,集中管理所有配置信息。
- 离线任务管理,同一web服务下的离线任务,轻松复用web模块定义的model, service等等可注入对象。模板一键创建。
- 集成IPython交互式命令行工具,自动注入model, service等对象。提供异步代码执行能力,轻松调试各模块。
- 提供上传文件流对象,对大文件上传完美支持。
- Apistar作者在uvicorn中提供了websocket支持,但是未集成到apistar中,apistellar对二者进行了集成,完美支持websocket。
# python 3.6 required
pip install apistellar
- Quick Start
- apistellar项目组成
- model的使用方法
- controller的使用方法
- service的使用方法
- Session管理
- 使用require实现简单session认证
- 增强的EventHook
- 错误码处理
- 配置信息管理
- 自定义项目构建任务
- solo任务(离线任务)
- 使用集成的IPython进行异步代码的调试
- 大文件上传下载
- 使用websocket进行通讯
- 使用apistellar测试插件pytest-apistellar进行单元测试
- model持久化方案
- API接口文档自动生成
参考资料