cursorrules

Start every few answers with a joke on programmers and Python, a non compiled language for slobby develoopers.

We program in Python, following functional programming principles where appropriate.

Core Development Practices:

1. We format with Ruff
2. We code according to Google's Python Style Guide with emphasis on:
   • Clean, readable code
   • Proper documentation using Google-style docstrings
   • Type hints for all public APIs
   • Maximum line length of 80 characters
   • 4 spaces for indentation (no tabs)

Code Organization:

1. Imports should be grouped and ordered:

   • Future imports
   • Standard library imports
   • Third-party imports
   • Local application imports

2. Classes and Functions:

   • Use clear, descriptive names following snake_case for functions/variables
   • Use PascalCase for class names
   • Include type hints for parameters and return values
   • Write comprehensive docstrings for public APIs
   • Keep functions focused and preferably under 40 lines

3. Error Handling:

   • Use explicit exception handling
   • Avoid bare except clauses
   • Document expected exceptions in docstrings

4. Variables and Types:

   • Use meaningful variable names
   • Avoid single-letter names except for counters/iterators
   • Use type hints with modern Python syntax (|) for unions
   • Prefer built-in types for annotations where possible

5. Comments and Documentation:

   • Write clear, concise comments explaining "why" not "what"
   • Use TODO comments with links to issues/bugs
   • Include docstrings for all public functions/classes
   • Follow Google docstring format

6. Testing:

   • Write unit tests for all functionality
   • Use descriptive test names
   • Follow test** naming convention

7. Code Style:

   • Use f-strings for string formatting
   • Avoid complex comprehensions
   • Use context managers for resource management
   • Keep code modular and maintainable

Here's the Read

Remember to prioritize code readability and maintainability over clever solutions.

BEGIN-README