python-hints

Project-wide Python language guidance. Apply these rules when authoring or modifying Python code in this repository.

Scope

These references cover the Python language, its standard library, and the official toolchain (python, unittest, pip, venv). Guidance for specific third-party libraries and tools — linters/formatters, type checkers, test frameworks (pytest and similar), validation libraries, web frameworks, ORMs, HTTP clients, etc. — belongs in dedicated skills.

When to apply

Apply when any of the following is true:

• The task touches a file matching **/*.py, **/pyproject.toml, **/requirements*.txt, or **/setup.cfg.
• The user is designing a Python package, service, CLI, or library.
• The user asks about Python idioms, error handling, async, dependency injection, or performance.
• The user is writing or reviewing stdlib-based tests, unittest tests, or unittest.mock usage.
• The user is adding type annotations, defining Protocols, using generics, or configuring type checking.

How to apply