Python Coding Guidelines

Code Style (PEP 8)

• 4 spaces for indentation (never tabs)
• Max line length: 88 chars (Black default) or 79 (strict PEP 8)
• Two blank lines before top-level definitions, one within classes
• Imports: stdlib → third-party → local, alphabetized within groups
• Snake_case for functions/variables, PascalCase for classes, UPPER_CASE for constants

Before Committing

# Syntax check (always)
python -m py_compile *.py

# Run tests if present
python -m pytest tests/ -v 2>/dev/null || python -m unittest discover -v 2>/dev/null || echo "No tests found"