一个符合wsgi的rest微框架
prestans3的Python项目详细描述
Prestans是Python的符合wsgi的rest微框架。它关注的是代码结构和不可饶恕的有效数据。prestans通过设计模型、解析器和处理程序的具体范例来实现这一点。该框架的设计是为了与single page Web applications和本机移动客户端协同工作,但不限于此。PristAs与其他Python框架和middleware.愉快地共存,并提供API构建器:
- 类型层,允许您轻松定义API端点传递和接收的数据的规则
- 请求、响应和查询参数有效负载的解析器基础结构
- 中间件兼容的请求路由器,以支持有用的处理程序生命周期
- 请求和响应的基于http头的内容格式协商
- 辅助附加功能,用于将持久对象转换为已验证的rest响应
- 与现有认证和授权服务集成的能力
- 响应最小化,有效载荷大小最多减少30%
- 自我文档化api,由Sphinx理解(有关详细信息,请参阅我们的开发工具)
- API客户端代码生成(有限语言)
开发期间
普雷斯坦斯计划用两个不同的东西来运输:
- 服务器微框架,运行Prestans应用程序所需的一切
- 在开发过程中提供帮助但在生产中不必要的其他开发工具(称为设备)
设备允许API制造商生成:
- 静态重写映射,以便客户端解压缩缩小的响应。
- 基于服务器定义的客户端模型存根(用于有限数量的语言),用于使用响应和构造请求负载。
- 基于blueprint(api的自动发现属性)和在线注释的文档。
这些工具最初是内置在服务器发行版中的。从3.0开始,我们决定使这些工具独立,这样它们(连同它们的依赖项)就不会安装在生产环境中。
在使用prestans开发应用程序时,我们建议安装Apparatus for Prestans。
安装
我们建议通过pypi安装prestans:
$ pip install -U prestans3
在您的开发环境中,我们建议安装Prestans设备(这将安装适当版本的服务器框架和开发工具):
$ pip install -U prestans3-apparatus
在生产环境中不需要开发人员工具。安装开发工具将安装不必要的依赖项。
文档和帮助
- Comprehensive documentation,和它一起Sphinx source.
- Discussion mailing list和asecurity announcement mailing list.。也可以考虑阅读本指南how to ask questions the smart way.
- Issue tracker用于错误和功能请求。在提出问题之前,确保查阅了文档和讨论列表。