module apibook.main
Generates markdown from Python docstrings.
Functions
def root_module(root) -> str
Get the root module name from a path.
Arguments:
root(str): the root path
Returns:
- the root module name
def path_to_module(root, file) -> str
Convert a path to a module name.
Arguments:
root(str): the parent directory of the filefile(str): the module name
Returns:
- the dotted module name
def fixup_reexports(root_module, docs) -> None
Inlines items that are reexported from other modules via 'all' lists.
Arguments:
root_module(str)docs(dict[str, Module])
def run(root_dir, output_dir, summary_output_template) -> None
Run the docstring generator.
Arguments:
root_dir(str)output_dir(str)summary_output_template(str | None)