Skip to content

DocuPython Documentation Generator

Generate documentation from special

Docu Documentation

Docu is a documentation generator for Python code that extracts documentation from special #/ comment lines. It provides a straightforward way to document your Python code while keeping the documentation close to the code it describes.

Key Features

  • Extract Documentation from Comments: Docu extracts documentation from special #/ comment lines in your Python code
  • Multiple Output Formats: Generate documentation in markdown or HTML formats
  • Template System: Customize the output using different HTML templates
  • Support for Multiple Doc Styles: Parse documentation in Google, NumPy, or Sphinx styles
  • AST-based Analysis: Accurately extracts function signatures, types, and return values

Quick Example

python
#/ MyClass - A simple example class
class MyClass:
    #/ Initialize the class with a name
    def __init__(self, name: str):
        self.name = name

    #/ Return a greeting using the name
    def greet(self) -> str:
        return f"Hello, {self.name}!"

Generate documentation with:

bash
python -m docu example.py --format html --output-dir docs