diff --git a/.readthedocs.yaml b/.readthedocs.yaml new file mode 100644 index 00000000..95420fe8 --- /dev/null +++ b/.readthedocs.yaml @@ -0,0 +1,32 @@ +# .readthedocs.yaml +# Read the Docs configuration file +# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details + +# Required +version: 2 + +# Set the version of Python and other tools you might need +build: + os: ubuntu-22.04 + tools: + python: "3.7" + # You can also specify other tool versions: + # nodejs: "19" + # rust: "1.64" + # golang: "1.19" + +# Build documentation in the docs/ directory with Sphinx +sphinx: + configuration: docs/conf.py + +# If using Sphinx, optionally build your docs in additional formats such as PDF +formats: [] +# - pdf + +# Optionally declare the Python requirements required to build your docs +python: + install: + - method: pip + path: . + extra_requirements: + - docs diff --git a/constraints.txt b/constraints.txt index dfc54574..42c8b145 100644 --- a/constraints.txt +++ b/constraints.txt @@ -5,9 +5,3 @@ flake8==5.0.2 objgraph==3.5.0 pytest==6.2.5 pytest-cov==3.0.0 - -# Documentation building. -Jinja2==2.7.3 -Pygments==1.6 -Sphinx==1.2.2 -docutils==0.12 diff --git a/docs/conf.py b/docs/conf.py index fb1d598a..17b3ff49 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -42,6 +42,7 @@ def __getattr__(self, name): "sphinx.ext.autodoc", "sphinx.ext.doctest", "sphinx.ext.viewcode", + "sphinx_autodoc_typehints", ] # Add any paths that contain templates here, relative to this directory. diff --git a/setup.cfg b/setup.cfg index 2f29292e..63d3ac65 100644 --- a/setup.cfg +++ b/setup.cfg @@ -71,6 +71,7 @@ sasl = docs = Sphinx>=1.2.2 + sphinx-autodoc-typehints>=1 typing = mypy>=0.991