Lamoom Python Project Guide

# Lamoom Python Project Guide

## Build/Test/Lint Commands
- Install deps: `poetry install`
- Run all tests: `poetry run pytest --cache-clear -vv tests`
- Run specific test: `poetry run pytest tests/path/to/test_file.py::test_function_name -v`
- Run with coverage: `make test`
- Format code: `make format` (runs black, isort, flake8, mypy)
- Individual formatting:
  - Black: `make make-black`
  - isort: `make make-isort`
  - Flake8: `make flake8`
  - Autopep8: `make autopep8`

## Code Style Guidelines
- Python 3.9+ compatible code
- Type hints required for all functions and methods
- Classes: PascalCase with descriptive names
- Functions/Variables: snake_case
- Constants: UPPERCASE_WITH_UNDERSCORES
- Imports organization with isort:
  1. Standard library imports
  2. Third-party imports
  3. Local application imports
- Error handling: Use specific exception types