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 |