API文档、验证、模拟和客户端。
项目描述
    
🛠 Web API工具包。 🛠
社区: https://discuss.apistar.org 🤔 💭 🤓 💬 😎
文档: https://docs.apistar.com 📘
需求: Python 3.6+
API Star是一个用于处理OpenAPI或Swagger架构的工具包。它允许您
- 构建API文档,并提供可选的主题。
- 验证API架构文档,并提供上下文错误。
- 使用动态客户端库进行API请求。
您可以使用它来构建静态文档,将其集成到Web框架中,或将其用作与其他API交互的客户端库。
快速入门
安装API Star
$ pip3 install apistar
让我们看看这个工具包提供的部分功能...
我们将创建一个OpenAPI架构,schema.yaml
openapi: 3.0.0
info:
  title: Widget API
  version: '1.0'
  description: An example API for widgets
servers:
  - url: https://www.example.org/
paths:
  /widgets:
    get:
      summary: List all the widgets.
      operationId: listWidgets
      parameters:
      - in: query
        name: search
        description: Filter widgets by this search term.
        schema:
          type: string
我们还将创建一个配置文件 apistar.yml
schema:
  path: schema.yaml
  format: openapi
我们现在可以开始使用apistar命令行工具了。
我们可以验证我们的OpenAPI架构
$ apistar validate
✓ Valid OpenAPI schema.
或构建我们API的开发者文档
$ apistar docs --serve
✓ Documentation available at "http://127.0.0.1:8000/" (Ctrl+C to quit)
我们还可以向架构中引用的服务器发送API请求
$ apistar request listWidgets search=cogwheel
服务器去哪里了?
从版本0.6开始,API Star项目被定位为一个框架无关的API工具套件。计划是以一种既适用于独立工具,又适用于大量框架的方式构建此功能。
0.5 分支仍然可在 GitHub 上找到,您可以使用 pip install apistar==0.5.41 从 PyPI 安装。API Star 服务器任何进一步的开发可能需要基于该分支的分支,并由新的维护者进行。
如果您正在寻找一个基于 Python 的高性能异步框架,那么我反而推荐 Starlette。
API Star 是 BSD 许可证下的代码。
在英国布莱顿设计和建造。
    
项目详情
    
       关闭
    
      
        
    
    
  
apistar-0.7.2.tar.gz 的哈希值
| 算法 | 哈希摘要 | |
|---|---|---|
| SHA256 | 8da0d3f15748c8ed6e68914ba5b8f6dd5dff5afbe137950d07103575df0bce73 | |
| MD5 | bec6e066702370e5ab376624800e1926 | |
| BLAKE2b-256 | d60c3066b856f661bc58b16c1a2ff4eeed25dc4f0d4618871b3454066dad89e0 |