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 file
  • file(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)