Skip to content

Commit

Permalink
refactor!: remove sphinx plugin (#29)
Browse files Browse the repository at this point in the history
The plugin was not generic and in fact very opinionated on the
structure of the generated output.
  • Loading branch information
P403n1x87 authored Dec 8, 2023
1 parent 8862de6 commit 11581fc
Show file tree
Hide file tree
Showing 7 changed files with 0 additions and 352 deletions.
21 changes: 0 additions & 21 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -89,27 +89,6 @@ to use it, either install the library with the `mypy` extra or ensure that
the `mypy` configuration.


## Sphinx Plugin

The library comes with a Sphinx plugin at `envier.sphinx` to allow generating
documentation from the configuration spec class directly. It exposes the
``envier`` directive that takes a mandatory argument, the configuration spec
class in the form `module:class`; additionally, the options `heading` and
`recursive` can be used to control whether to add heading and whether to
recursively get help information from nested configuration spec classes
respectively. By default, the plugin will display the table heading and will not
recurse over nested configuration spec classes.

Here is an example for a configuration class `GlobalConfig` located in the
`myapp.config` module. We omit the table header and recurse over nested
configuration.

~~~ rst
.. envier:: myapp.config:GlobalConfig
:heading: false
:recursive: true
~~~

## Roadmap

- Add support for environment files.
Expand Down
97 changes: 0 additions & 97 deletions envier/sphinx.py

This file was deleted.

14 changes: 0 additions & 14 deletions tests/conftest.py

This file was deleted.

142 changes: 0 additions & 142 deletions tests/sphinx/test-root/_build/index.html

This file was deleted.

53 changes: 0 additions & 53 deletions tests/sphinx/test-root/conf.py

This file was deleted.

6 changes: 0 additions & 6 deletions tests/sphinx/test-root/index.rst

This file was deleted.

19 changes: 0 additions & 19 deletions tests/test_sphinx.py

This file was deleted.

0 comments on commit 11581fc

Please sign in to comment.