Metadata-Version: 2.1
Name: pdoc3
Version: 0.7.2
Summary: Auto-generate API documentation for Python projects.
Home-page: https://pdoc3.github.io/pdoc/
License: AGPL-3.0
Project-URL: Documentation, https://pdoc3.github.io/pdoc/doc/pdoc/
Project-URL: Source, https://github.com/pdoc3/pdoc/
Project-URL: Tracker, https://github.com/pdoc3/pdoc/issues
Platform: UNKNOWN
Classifier: Topic :: Documentation
Classifier: Topic :: Software Development :: Documentation
Classifier: Topic :: Utilities
Classifier: License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3 :: Only
Provides: pdoc
Obsoletes: pdoc
Requires-Python: >= 3.5
Description-Content-Type: text/markdown
Requires-Dist: mako
Requires-Dist: markdown (>=3.0)

[![](https://i.imgur.com/kQOtbBk.png)](https://pdoc3.github.io/pdoc/)

pdoc
====

[![Build Status](https://img.shields.io/travis/pdoc3/pdoc.svg?style=for-the-badge)](https://travis-ci.org/pdoc3/pdoc)
[![Code Coverage](https://img.shields.io/codecov/c/gh/pdoc3/pdoc.svg?style=for-the-badge)](https://codecov.io/gh/pdoc3/pdoc)
[![pdoc3 on PyPI](https://img.shields.io/pypi/v/pdoc3.svg?color=blue&style=for-the-badge)](https://pypi.org/project/pdoc3)

Auto-generate API documentation for Python projects.

[**Project website**](https://pdoc3.github.io/pdoc/)

[Documentation]

[Documentation]: https://pdoc3.github.io/pdoc/doc/pdoc/


Installation
------------

    $ pip install pdoc3


Usage
-----
Pdoc will accept a Python module file, package directory or an import path.

    $ pdoc your_project

See `pdoc --help` for more command-line switches and the [documentation]
for more usage examples.


Features
--------
* Simple usage. Generate sensible API (+ prose) documentation without any
  special configuration.
* Support for common docstrings formats (Markdown, numpydoc, Google-style docstrings),
  LaTeX math, and some reST directives.
* Support for PEP 484 type annotations.
* pdoc respects `__all__` when present.
* Inheritance used as applicable for inferring docstrings for class members.
* Support for documenting module, class, and instance variables by traversing ASTs.
* Automatic cross-linking of referenced identifiers in HTML and PDF.
* Overriding docstrings with special module-level `__pdoc__` dictionary.
* Built-in development web server for near-instant preview of rendered docstrings.

The above features are explained in more detail in pdoc's [documentation]
(which was generated with pdoc).


