simplepydoc 0.1.0

Simple Python documentation generator - parse code, generate markdown

PyDocGen 🐍

Automatically generate simple markdown documentation from Python codebases.

What It Does

PyDocGen parses Python files and generates clean markdown documentation showing:

• Classes with their methods and docstrings
• Functions with arguments and docstrings
• Simple, readable API documentation

Installation

From PyPI (Recommended)

pip install simplepydoc

From Source (Development)

# Clone the repository
git clone https://github.com/msodiq19/llm-docgen.git
cd llm-docgen

# Install with Poetry
poetry install

Usage

# If installed from PyPI
simplepydoc generate --repo ./src/myproject --output ./docs

# If running from source with Poetry
poetry run simplepydoc generate --repo ./src/myproject --output ./docs

# Example: Generate docs for PyDocGen itself
simplepydoc generate --repo ./src/llm_docgen --output ./docs

This creates docs/API.md with documentation extracted from your Python code.

Example Output

Given this Python code:

class Calculator:
    """A simple calculator."""

    def add(self, a, b):
        """Add two numbers."""
        return a + b

def helper():
    """A helper function."""
    pass

PyDocGen generates:

# myproject API Documentation

## Classes

### Class: `Calculator`

A simple calculator.

**Methods:**

- **`add`**: Add two numbers.

## Functions

### `helper()`

A helper function.

Current Scope (MVP)

• ✅ Python files only
• ✅ Parses classes, methods, and functions
• ✅ Extracts docstrings
• ✅ Generates markdown output
• ❌ No template customization (simple, opinionated format)
• ❌ No notebook support
• ❌ No remote repository cloning (use local paths)

Development

# Run tests
poetry run pytest

# Run with coverage
poetry run pytest --cov=src

# Run the CLI during development
poetry run simplepydoc generate --repo ./src/llm_docgen --output ./docs

# Format code
poetry run black src tests

# Lint
poetry run flake8 src tests

Contributing

See CONTRIBUTING.md for development guidelines.

License

MIT - see LICENSE for details.