一个用于自动记录GraphQL模式的Sphinx扩展。
项目描述
一个用于自动记录GraphQL模式的Sphinx扩展。
入门
以下步骤将指导您如何将autogqlschema添加到现有的Sphinx项目中。有关如何设置Sphinx项目的说明,请参阅Sphinx的入门文档。
安装
autogqlschema可以通过pip安装
pip install autogqlschema
接下来,将autogqlschema添加到Sphinx项目中的extensions列表中的conf.py。
extensions.append("autogqlschema")
使用方法
模式文档是通过使用autogqlschema指令从GraphQL模式文件生成的。
在以下示例中,文档是从以下文件结构生成的。
myrepo
├── doc
│ ├── conf.py
│ └── index.rst
└── src
└── mypackage
├── schema
│ ├── __init__.py
│ ├── 01_schema.graphql
│ └── 02_books.graphql
└── __init__.py
可以使用以下reStructuredText生成此模式
.. autogqlschema::
:root-dir: ../src/mypackage/schema
:source-files: *.graphql
或者
.. autogqlschema::
:root-dir: ../src/mypackage/schema
:source-files: 01_schema.graphql, 02_books.graphql
有关更详细的使用说明,请参阅文档: https://autogqlschema.readthedocs.io/en/latest/
贡献
运行测试
测试是通过tox执行的。
tox
代码风格
代码使用black进行格式化。
您可以使用black的检查模式检查您的格式
tox -e format
您还可以让black为您格式化更改
tox -e format -- src/ tests/
发行说明
发行说明通过towncrier管理。在创建拉取请求时,您需要创建一个新闻片段来记录您的更改
tox -e release_notes -- create --help
版本控制
许可证
本项目采用MIT许可证。有关详细信息,请参阅LICENSE.rst文件。
项目详情
下载文件
下载适合您平台的文件。如果您不确定选择哪个,请了解有关安装包的更多信息。
源代码分布
autogqlschema-0.2.0.tar.gz (9.5 kB 查看哈希值)
构建分布
autogqlschema-0.2.0-py3-none-any.whl (13.0 kB 查看哈希值)
关闭
autogqlschema-0.2.0.tar.gz的哈希值
算法 | 哈希摘要 | |
---|---|---|
SHA256 | 8f527535586c2178e83eb48f11072718e4ca45e6fb66c09dd6272b9a9607e751 |
|
MD5 | 4e70933ff618f23e96ca968ba29ab75d |
|
BLAKE2b-256 | 53e1dffa1ae063c7093fff6bab5ef73c4d1e05da9fb64d40bb9cdd1839a2f341 |
关闭
autogqlschema-0.2.0-py3-none-any.whl的哈希值
算法 | 哈希摘要 | |
---|---|---|
SHA256 | 813fb13fa2befc7c90b6037fa64bbe8b80d367844dbff201865e704d060196a4 |
|
MD5 | 28fb314fab829ac6e087af2fa8717527 |
|
BLAKE2b-256 | b66fc3fb3355bf78aeef6a288f8eda93739c2ef2dc8cb6dfc4c0f5690889429a |