跳转到主要内容

API文档、验证、模拟和客户端。

项目描述

API Star

🛠 Web API工具包。 🛠

Build Status codecov Package version


社区: 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 许可证下的代码。
在英国布莱顿设计和建造。

API Star

项目详情


发布历史 发布通知 | RSS 源

下载文件

下载适用于您平台的文件。如果您不确定该选择哪个,请了解更多关于 安装包 的信息。

源分布

apistar-0.7.2.tar.gz (3.3 MB 查看哈希值)

由以下支持