---

name: python-guidelines description: Python coding guidelines and best practices

Python Guidelines

Style

• Follow PEP 8
• Use Black formatter
• Max line length: 88

Naming

Copy# Variables/functions: snake_case
user_name = "John"
def get_user(): pass

# Classes: PascalCase
class UserService: pass

# Constants: SCREAMING_SNAKE_CASE
MAX_RETRIES = 3

Best Practices

• Use type hints
• Use dataclasses
• Handle exceptions explicitly
• Use pathlib for paths

File Structure

Copysrc/
  models/
  services/
  utils/
tests/

Testing

• Use pytest
• Test files in tests/
• Use fixtures