-
Notifications
You must be signed in to change notification settings - Fork 7
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
docs: document all public symbols (#13)
* docs: initial docs * docs: document all public symbols * chore: silence ruff for docs copyright configuration * chore: remove autogenerated source
- Loading branch information
1 parent
173fa6b
commit 954b5e1
Showing
14 changed files
with
893 additions
and
62 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,73 @@ | ||
from sphinx.domains.python import PythonDomain | ||
|
||
# Configuration file for the Sphinx documentation builder. | ||
# | ||
# For the full list of built-in configuration values, see the documentation: | ||
# https://www.sphinx-doc.org/en/master/usage/configuration.html | ||
|
||
# -- Project information ----------------------------------------------------- | ||
# https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information | ||
|
||
project = "algokit-utils" | ||
copyright = "2023, Algorand Foundation" # noqa: A001 | ||
author = "Algorand Foundation" | ||
release = "1.0" | ||
|
||
# -- General configuration --------------------------------------------------- | ||
# https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration | ||
|
||
extensions = [ | ||
"sphinx.ext.githubpages", | ||
"sphinx.ext.intersphinx", | ||
"myst_parser", | ||
"autodoc2", | ||
] | ||
templates_path = ["_templates"] | ||
exclude_patterns = [] | ||
intersphinx_mapping = { | ||
"python": ("https://docs.python.org/3", None), | ||
"algosdk": ("https://py-algorand-sdk.readthedocs.io/en/latest", None), | ||
"pyteal": ("https://pyteal.readthedocs.io/en/stable/", None), | ||
} | ||
# allows type aliases to be used as type references | ||
PythonDomain.object_types["data"].roles = ("data", "class", "obj") | ||
|
||
|
||
# -- Options for HTML output ------------------------------------------------- | ||
# https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output | ||
|
||
html_theme = "sphinx_rtd_theme" | ||
html_static_path = ["_static"] | ||
|
||
|
||
# -- Options for myst --- | ||
myst_enable_extensions = [ | ||
"colon_fence", | ||
"fieldlist", | ||
] | ||
|
||
|
||
# -- Options for autodoc2 --- | ||
autodoc2_packages = [ | ||
{ | ||
"path": "../../src/algokit_utils", | ||
# "auto_mode": False, | ||
}, | ||
] | ||
autodoc2_skip_module_regexes = [r"algokit_utils\..*"] | ||
autodoc2_module_all_regexes = [ | ||
r"algokit_utils", | ||
] | ||
autodoc2_docstring_parser_regexes = [ | ||
# this will render all docstrings as Markdown | ||
(r".*", "myst"), | ||
] | ||
autodoc2_hidden_objects = [ | ||
"undoc", # undocumented objects | ||
"dunder", # double-underscore methods, e.g. __str__ | ||
"private", # single-underscore methods, e.g. _private | ||
"inherited", | ||
] | ||
autodoc2_render_plugin = "myst" | ||
autodoc2_sort_names = True | ||
autodoc2_index_template = None |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,17 @@ | ||
# Welcome to algokit-utils's documentation! | ||
|
||
```{toctree} | ||
--- | ||
maxdepth: 2 | ||
caption: Contents | ||
--- | ||
usage | ||
apidocs/algokit_utils/algokit_utils | ||
``` | ||
|
||
# Indices and tables | ||
|
||
* {ref}`genindex` | ||
* {ref}`modindex` | ||
* {ref}`search` |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,17 @@ | ||
# Usage | ||
|
||
## Installation | ||
|
||
To use algokit-utils, first install it using pip: | ||
|
||
```{code-block} console | ||
(.venv) $ pip install algokit-utils | ||
``` | ||
|
||
or alternatively add it to an existing poetry project | ||
|
||
```{code-block} console | ||
(.venv) $ poetry add algokit-utils | ||
``` |
Large diffs are not rendered by default.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.
954b5e1
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Coverage Report