跳转到主要内容

一个用于自动记录GraphQL模式的Sphinx扩展。

项目描述

Documentation Github Build Status PyPI Version Supported Python Versions Formatted with Black

一个用于自动记录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

版本控制

我们使用SemVer进行版本管理。有关可用的版本,请参阅此存储库上的标签

许可证

本项目采用MIT许可证。有关详细信息,请参阅LICENSE.rst文件

项目详情


下载文件

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

源代码分布

autogqlschema-0.2.0.tar.gz (9.5 kB 查看哈希值)

上传时间: 源代码

构建分布

autogqlschema-0.2.0-py3-none-any.whl (13.0 kB 查看哈希值)

上传时间: Python 3

由以下支持