Metadata-Version: 2.4
Name: docc
Version: 0.6.0
Summary: Python code documentation compiler
Home-page: https://github.com/SamWilsn/docc
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE.md
Requires-Dist: libcst<2,>=1.8.5
Requires-Dist: mistletoe<2,>=1.5.0
Requires-Dist: importlib-resources<7,>=6.0.1
Requires-Dist: tomli<3,>=2.3.0
Requires-Dist: rich<15,>=14.2.0
Requires-Dist: Jinja2<4,>=3.1.6
Requires-Dist: inflection<0.6,>=0.5.1
Requires-Dist: typing-extensions<5,>=4.15.0
Provides-Extra: lint
Requires-Dist: isort<8,>=7; extra == "lint"
Requires-Dist: pyre-check<0.10,>=0.9.25; extra == "lint"
Requires-Dist: types-setuptools>=68.1; extra == "lint"
Requires-Dist: black<26,>=25.9; extra == "lint"
Requires-Dist: flake8-spellcheck<0.29,>=0.28; extra == "lint"
Requires-Dist: flake8-docstrings<2,>=1.7; extra == "lint"
Requires-Dist: flake8-bugbear<26.0.0,>=25.10.21; extra == "lint"
Requires-Dist: flake8<8,>=7.3; extra == "lint"
Requires-Dist: pytest<9,>=8.4.2; extra == "lint"
Dynamic: license-file

docc
====

[![documentation badge][docs-badge]][docs]

The documentation compiler.

## Python Quickstart

### Installing

```bash
pip install docc
```

### Configuring

Add the following to your [`pyproject.toml`]:

```toml
[tool.docc.plugins."docc.python.discover"]
paths = [ "<path to Python source>" ]

[tool.docc.output]
path = "<where to put rendered documentation>"
```

### Building

Finally, to generate the documentation:

```bash
docc
```

[docs-badge]: https://github.com/SamWilsn/docc/actions/workflows/gh-pages.yaml/badge.svg?branch=master
[docs]: https://samwilsn.github.io/docc/
[`pyproject.toml`]: https://packaging.python.org/en/latest/specifications/declaring-project-metadata/#declaring-project-metadata
