# Python Coding Standards

Comprehensive Python coding standards and best practices for AI-assisted development.

## Overview

This module provides detailed guidelines for writing clean, maintainable, and Pythonic code following PEP 8 and modern Python best practices.

## Key Benefits

- **Type Safety**: Comprehensive type hints usage with modern syntax (PEP 484, 585, 604)
- **Error Handling**: Proper exception handling patterns
- **Code Quality**: PEP 8 compliance and best practices
- **Modern Python**: Python 3.10+ features and patterns
- **Mypy Integration**: Static type checking configuration

## Installation

```bash
augx link coding-standards/python
```

## Contents

### Rules

- **naming-conventions.md** - PEP 8 naming standards (snake_case, UPPER_SNAKE_CASE, PascalCase, _private)
- **type-hints.md** - Modern type hints (PEP 484, 585, 604) with list[str], str | None, mypy
- **error-handling.md** - Exception handling patterns
- **best-practices.md** - General Python best practices
- **code-organization.md** - Import organization (stdlib, third-party, local), class structure, module layout
- **async-patterns.md** - Async/await patterns with asyncio
- **documentation.md** - Docstring standards and documentation best practices
- **testing.md** - pytest testing framework, fixtures, parametrization, mocking, coverage
- **tooling.md** - Black (formatter), mypy (type checker), Ruff (linter), pre-commit hooks, CI/CD

### Examples

- **best-practices.py** - Comprehensive Python code examples demonstrating naming conventions, type hints, error handling, async patterns, dataclasses, enums, and modern Python features

## Character Count

~116,868 characters

## Version

1.1.0

