Copilot instructions

1---
2applyTo: "**/*.py"
3---
4 
5# Python Coding Style
6 
7> This file extends [common/coding-style.md](../common/coding-style.md) with Python specific content.
8 
9## Standards
10 
11- Follow **PEP 8** conventions
12- Use **type annotations** on all function signatures
13 
14## Immutability
15 
16Prefer immutable data structures:
17 
18```python
19from dataclasses import dataclass
20 
21@dataclass(frozen=True)
22class User:
23    name: str
24    email: str
25 
26from typing import NamedTuple
27 
28class Point(NamedTuple):
29    x: float
30    y: float
31```
32 
33## Formatting
34 
35- **black** for code formatting
36- **isort** for import sorting
37- **ruff** for linting
38 
39## Reference
40 
41See skill: `python-patterns` for comprehensive Python idioms and patterns.
42 
43 
44# Python Patterns
45 
46> This file extends [common/patterns.md](../common/patterns.md) with Python specific content.
47 
48## Protocol (Duck Typing)
49 
50```python
51from typing import Protocol
52 
53class Repository(Protocol):
54    def find_by_id(self, id: str) -> dict | None: ...
55    def save(self, entity: dict) -> dict: ...
56```
57 
58## Dataclasses as DTOs
59 
60```python
61from dataclasses import dataclass
62 
63@dataclass
64class CreateUserRequest:
65    name: str
66    email: str
67    age: int | None = None
68```
69 
70## Context Managers & Generators
71 
72- Use context managers (`with` statement) for resource management
73- Use generators for lazy evaluation and memory-efficient iteration
74 
75## Reference
76 
77See skill: `python-patterns` for comprehensive patterns including decorators, concurrency, and package organization.
78 
79 
80# Python Security
81 
82> This file extends [common/security.md](../common/security.md) with Python specific content.
83 
84## Secret Management
85 
86```python
87import os
88from dotenv import load_dotenv
89 
90load_dotenv()
91 
92api_key = os.environ["OPENAI_API_KEY"]  # Raises KeyError if missing
93```
94 
95## Security Scanning
96 
97- Use **bandit** for static security analysis:
98```bash
99  bandit -r src/
100```
101 
102## Reference
103 
104See skill: `django-security` for Django-specific security guidelines (if applicable).
105 
106 
107# Python Testing
108 
109> This file extends [common/testing.md](../common/testing.md) with Python specific content.
110 
111## Framework
112 
113Use **pytest** as the testing framework.
114 
115## Coverage
116 
117```bash
118pytest --cov=src --cov-report=term-missing
119```
120 
121## Test Organization
122 
123Use `pytest.mark` for test categorization:
124 
125```python
126import pytest
127 
128@pytest.mark.unit
129def test_calculate_total():
130    ...
131 
132@pytest.mark.integration
133def test_database_connection():
134    ...
135```
136 
137## Reference
138 
139See skill: `python-testing` for detailed pytest patterns and fixtures.