pydoc-fork 3.1.13

Fork of cpython's pydoc module to do just html document generation

pydoc_fork

A fork of pydoc to optimize it for generating, on a build server, html documentation for a python library you wrote

Less ambitious than the very good pdoc3 and easier to use than Sphinx

Installation

Requires Python 3.6+, according to vermin

pip install pydoc_fork

# or virtual environment access
pipenv install pydoc_fork

# WARNING- installation by pipx will only allow for doc generation of the python standard library!
pipx install pydoc_fork

Usage

# Generate HTML for all modules and submodules from source code
> pydoc_fork my_module --output docs --document_internals

# Generate HTML for a module that is importable, e.g. sys
> pydoc_fork sys --output docs

Docs

• Motivation
• Prior Art
• TODO

pydoc_fork documented in several ways:

• pydoc_fork
• Pycco
• PyDoctor
• pdoc3
• mkdocstrings
• sphinx

Credits

Forked from python 3.10. https://github.com/python/cpython/blob/3.10/Lib/pydoc.py

That code is governed by this license https://github.com/python/cpython/blob/main/LICENSE

I picked a MIT license, but I'm no lawyer, the cpython license probably governs in any conflict.