referencer-py

Generate a markdown reference from your public API docstrings and adds it to your readme.

Features

• Uses pydoc-markdown under the hood

Installation

The package uses semantic versioning. It means that major versions could include breaking changes.

$ pip install referencer

Documentation

referencer package README.md --in-place

Reference

cli

cli(package, document, **options)

Command-line interface

generate_document

generate_document(package, document, package_pattern='from \\.(\\w+) import (\\w+)', document_section='## Reference')

Generate document

generate_reference

generate_reference(package, package_pattern='from \\.(\\w+) import (\\w+)')

Generate reference

Contributing

virtualenv .python -ppython3.7
source .python/bin/activate
make install
make test

Changelog

v0.1

• Initial version