Python Template Documentation

Welcome to the Python Template documentation. This is a modern Python project template with comprehensive tooling and best practices built-in.

🚀 Quick Start

  1. Clone the repository: git clone https://github.com/username/python-template.git
  2. Install uv: curl -LsSf https://astral.sh/uv/install.sh | sh
  3. Install dependencies: uv pip install -r pyproject.toml
  4. Run tests: make test
  5. Start developing!

✨ Features

Modern Tooling

Pre-configured with uv, ruff, pytest, and pydantic for a modern Python development experience.

Best Practices

Follows Python best practices with comprehensive coding standards and project structure.

GitHub Pages Ready

This documentation is hosted on GitHub Pages. Enable it in your repository settings!

AI-Friendly

Includes CLAUDE.md and llms/ directory with documentation optimized for AI assistants.

📁 Project Structure

./
├── docs/           # Documentation (GitHub Pages)
├── src/            # Application code
├── tests/          # Test files
├── logs/           # Implementation logs
├── llms/           # LLM-friendly documentation
├── Makefile        # Task automation
├── pyproject.toml  # Project configuration
├── Python.md       # Coding standards
└── CLAUDE.md       # AI instructions
        

🛠️ Available Commands

make dev            # Run linting and type checking
make test           # Run tests
make test-coverage  # Run tests with coverage
make type-coverage  # Check type annotation coverage
        

📚 Documentation

The llms/ directory contains comprehensive documentation for common Python tools and libraries:

🔧 Configuration

The project uses pyproject.toml for all tool configuration. Key sections include:

🤝 Contributing

Contributions are welcome! Please read the coding standards in Python.md before submitting pull requests.