Python Development Skill
Reference data for the Developer Hub, Python Specialist, and wxPython Specialist agents.
Python Version Quick Reference
Each version, with its key features and end of support (python.org, October 2026). 3.10 reached end of life on 1 October 2026.
| Version |
Key Features |
EOL |
| 3.10 |
match/case, X | Y unions, ParamSpec |
Oct 2026 (end of life) |
| 3.11 |
Exception groups, Self type, tomllib, faster CPython |
Oct 2027 |
| 3.12 |
Type parameter syntax def f[T](), @override, f-string nesting |
Oct 2028 |
| 3.13 |
Experimental free-threaded mode, improved error messages |
Oct 2029 |
| 3.14 |
Template strings (PEP 750), deferred evaluation of annotations (PEP 649), compression.zstd (PEP 784) |
Oct 2030 |
| 3.15 |
Explicit lazy imports (PEP 810), frozendict (PEP 814), UTF-8 default encoding (PEP 686) |
Oct 2031 |
pyproject.toml Skeleton
[build-system]
requires = ["hatchling"]
build-backend = "hatchling.build"
[project]
name = "my-app"
version = "1.0.0"
requires-python = ">=3.11"
dependencies = []
[project.optional-dependencies]
dev = ["pytest>=8.0", "ruff>=0.6", "mypy>=1.11"]
[project.scripts]
myapp = "my_app.__main__:main"
[tool.pytest.ini_options]
testpaths = ["tests"]
addopts = "-ra --strict-markers"
[tool.ruff]
target-version = "py311"
line-length = 100
[tool.ruff.lint]
select = ["E", "F", "W", "I", "N", "UP", "B", "SIM", "TC"] # flake8-type-checking is "TC" since ruff 0.8 (was "TCH")
[tool.mypy]
python_version = "3.11"
strict = true
PyInstaller Quick Reference
One-File Mode
exe = EXE(pyz, a.scripts, a.binaries, a.zipfiles, a.datas,
name='MyApp', console=False, icon='icon.ico')
One-Folder Mode
exe = EXE(pyz, a.scripts, exclude_binaries=True,
name='MyApp', console=False, icon='icon.ico')
coll = COLLECT(exe, a.binaries, a.zipfiles, a.datas, name='MyApp')
Common Hidden Imports
pkg_resources.extern
accessible_output2 (for a11y desktop apps)
keyring.backends (for credential storage)
platformdirs
httpx._transports / httpcore._backends
encodings (always needed)
wxPython Quick Reference
Sizer Cheat Sheet
Each sizer, with when to use.
| Sizer |
When to Use |
wx.BoxSizer(wx.VERTICAL) |
Stack items top-to-bottom |
wx.BoxSizer(wx.HORIZONTAL) |
Lay items left-to-right |
wx.GridBagSizer(vgap, hgap) |
Form layouts with labels + controls |
wx.FlexGridSizer(rows, cols, vgap, hgap) |
Even grid layouts |
wx.WrapSizer |
Flow layout that wraps |
wx.StaticBoxSizer(wx.VERTICAL, parent, "Label") |
Grouped controls with border |
Thread-Safe GUI Updates
# From worker thread:
wx.CallAfter(self.update_status, "Done")
wx.PostEvent(self, CustomEvent(data=result))
# NEVER do this from a worker thread:
self.status_bar.SetStatusText("Done") # CRASH or CORRUPTION
Standard IDs
Each standard ID, with its ID and purpose.
| ID |
Purpose |
wx.ID_OK |
OK button |
wx.ID_CANCEL |
Cancel button |
wx.ID_SAVE |
Save action |
wx.ID_OPEN |
Open action |
wx.ID_EXIT |
Exit / Quit |
wx.ID_HELP |
Help action |
wx.ID_NEW |
New document |
wx.ID_UNDO / wx.ID_REDO |
Undo / Redo |
Event Types
Each event, with its trigger.
| Event |
Trigger |
wx.EVT_BUTTON |
Button click |
wx.EVT_MENU |
Menu item selected |
wx.EVT_CLOSE |
Window close requested |
wx.EVT_SIZE |
Window resized |
wx.EVT_TIMER |
Timer fired |
wx.EVT_TEXT |
Text control content changed |
wx.EVT_LIST_ITEM_SELECTED |
List item selected |
wx.EVT_TREE_SEL_CHANGED |
Tree selection changed |
wx.EVT_UPDATE_UI |
UI state update check |
Common Pitfalls
Python
- Mutable default arguments:
def f(items=[]) shares the list across calls. Use None and create inside.
- Late binding closures:
lambda: x in a loop captures the variable, not the value. Use lambda x=x: x.
- Circular imports: Move imports inside functions, use
TYPE_CHECKING block, or restructure modules.
field() outside dataclass: field() is only valid inside @dataclass classes. Use plain type annotations elsewhere.
is vs ==: is checks identity, == checks equality. Use is only for None, True, False.
- String concatenation in loops: Use
"".join() or io.StringIO instead.
wxPython
- GUI from worker thread: Always use
wx.CallAfter() or wx.PostEvent().
- Missing
event.Skip(): Other handlers won't fire. Call event.Skip() unless you intentionally consume the event.
- Timer not stopped: Stop timers in
EVT_CLOSE handler to prevent callbacks after destruction.
- AUI not uninitialized: Call
_mgr.UnInit() in close handler.
- Dialog not destroyed: Use context managers (
with MyDialog(...) as dlg:) for automatic cleanup.
- Wrong parent for sizer items: All controls in a sizer must have the same parent panel.
- Absolute positioning: Never use
SetPosition() or SetSize() for layout. Always use sizers.
Cross-Platform Paths
from platformdirs import user_config_dir, user_data_dir, user_cache_dir
config = user_config_dir("MyApp", "MyCompany") # %APPDATA% / ~/Library/... / ~/.config/
data = user_data_dir("MyApp", "MyCompany")
cache = user_cache_dir("MyApp", "MyCompany")
Testing Quick Reference
# Run all tests
pytest
# Run specific test file
pytest tests/test_queue.py
# Run specific test
pytest tests/test_queue.py::test_submit_job -v
# With coverage
pytest --cov=mypackage --cov-report=term-missing
# Stop on first failure
pytest -x
# Show locals on failure
pytest -l
Logging Setup Template
import logging
def setup_logging(level: int = logging.INFO) -> None:
logging.basicConfig(
level=level,
format="%(asctime)s %(name)s %(levelname)s %(message)s",
datefmt="%Y-%m-%d %H:%M:%S",
)
# Quiet noisy libraries
logging.getLogger("httpx").setLevel(logging.WARNING)
logging.getLogger("httpcore").setLevel(logging.WARNING)
Desktop Accessibility Quick Reference
Platform API Summary
Each platform, with API, python binding and use for.
| Platform |
API |
Python Binding |
Use For |
| Windows |
UI Automation (UIA) |
comtypes, pywinauto |
Modern apps, NVDA/Narrator |
| Windows |
MSAA / IAccessible2 |
comtypes, pywinauto |
Legacy apps, JAWS |
| macOS |
NSAccessibility |
pyobjc |
VoiceOver |
wxPython Accessibility Essentials
# Name every control that lacks a visible label
# CORRECT: use StaticText immediately before the control in the sizer
label = wx.StaticText(panel, label="Scan progress:")
# ctrl = wx.Gauge(panel) -- add label to sizer right before ctrl
# WRONG: SetName() is ignored by screen readers
# ctrl.SetName("Scan progress") -- only affects FindWindowByName()
# Tab order follows sizer insertion order; override with:
ctrl2.MoveAfterInTabOrder(ctrl1)
# Keyboard shortcuts via accelerator table
accel = wx.AcceleratorTable([
(wx.ACCEL_CTRL, ord('S'), wx.ID_SAVE),
(wx.ACCEL_CTRL, ord('Q'), wx.ID_EXIT),
])
frame.SetAcceleratorTable(accel)
# Platform-correct button order in dialogs
sizer.Add(dialog.CreateStdDialogButtonSizer(wx.OK | wx.CANCEL))
Screen Reader Interaction Model
Screen readers expose controls as: Name + Role + Value + State
| Property |
wxPython Source |
Example |
| Name |
Preceding wx.StaticText, label= parameter, or SetToolTip() |
"Scan progress" |
| Role |
Widget type (automatic) |
button, text field, list |
| Value |
Widget content |
"75%", "Hello world" |
| State |
Widget flags |
focused, disabled, checked |
Desktop A11y Checklist
- Every control has a meaningful name (preceding
wx.StaticText for inputs, label= for buttons, SetToolTip() for image-only controls)
- Keyboard-only operation -- every action reachable via Tab/Enter/Space/arrows
- Focus visible -- never suppress focus indicators
- Tab order is logical (generally top-to-bottom, left-to-right)
- Color is not the sole information carrier
- High contrast mode supported (use system colors, not hardcoded)
- Dialogs use
CreateStdDialogButtonSizer() for platform-correct button order
- AUI panes are keyboard-navigable
Structured Audit Rule Sets
When audit mode is activated, agents use these structured detection rule sets:
| Rule Prefix |
Agent |
Scope |
Count |
| WX-A11Y-001..012 |
wxpython-specialist |
wxPython-specific patterns (StaticText labels, AcceleratorTable, mouse-only events, dialogs) |
12 rules |
| DTK-A11Y-001..012 |
desktop-a11y-specialist |
Platform-level API patterns (Name/Role/State/Value, focus, UIA/NSAccessibility) |
12 rules |
| TST-A11Y-001..010 |
desktop-a11y-testing-coach |
Test coverage gaps (automated tests, SR testing, keyboard plans, CI integration) |
10 rules |
Rule sets don't overlap -- WX covers wxPython widget patterns, DTK covers platform APIs, TST covers testing process gaps.
Agent Routing
For deeper expertise, the skill routes to these specialists:
desktop-a11y-specialist -- Platform API implementation, wx.Accessible, custom widget patterns (DTK-A11Y-* audit rules)
desktop-a11y-testing-coach -- NVDA/JAWS/Narrator testing, Accessibility Insights, automated UIA tests (TST-A11Y-* audit rules)
a11y-tool-builder -- Rule engine architecture, document parsers, severity scoring, report generators
1---2name: kb-python-development3description: "Reference data, not a reviewer. Python and wxPython development: packaging (PyInstaller/Nuitka), testing, desktop accessibility APIs, cross-platform paths, and framework patterns."4license: MIT5disable-model-invocation: true6user-invocable: false7metadata:8 source: https://skillmd.com/skills/community-access/kb-python-development9 tier: reference10 domain: cross-cutting11 output: none12 effort: low13 title: Python Development14---1516## Python Development Skill1718Reference data for the Developer Hub, Python Specialist, and wxPython Specialist agents.1920## Python Version Quick Reference2122Each version, with its key features and end of support (python.org, October 2026). 3.10 reached end of life on 1 October 2026.2324| Version | Key Features | EOL |25|---|---|---|26| 3.10 | `match/case`, `X \| Y` unions, `ParamSpec` | Oct 2026 (end of life) |27| 3.11 | Exception groups, `Self` type, `tomllib`, faster CPython | Oct 2027 |28| 3.12 | Type parameter syntax `def f[T]()`, `@override`, f-string nesting | Oct 2028 |29| 3.13 | Experimental free-threaded mode, improved error messages | Oct 2029 |30| 3.14 | Template strings (PEP 750), deferred evaluation of annotations (PEP 649), `compression.zstd` (PEP 784) | Oct 2030 |31| 3.15 | Explicit lazy imports (PEP 810), `frozendict` (PEP 814), UTF-8 default encoding (PEP 686) | Oct 2031 |3233## pyproject.toml Skeleton3435```toml36[build-system]37requires = ["hatchling"]38build-backend = "hatchling.build"3940[project]41name = "my-app"42version = "1.0.0"43requires-python = ">=3.11"44dependencies = []4546[project.optional-dependencies]47dev = ["pytest>=8.0", "ruff>=0.6", "mypy>=1.11"]4849[project.scripts]50myapp = "my_app.__main__:main"5152[tool.pytest.ini_options]53testpaths = ["tests"]54addopts = "-ra --strict-markers"5556[tool.ruff]57target-version = "py311"58line-length = 1005960[tool.ruff.lint]61select = ["E", "F", "W", "I", "N", "UP", "B", "SIM", "TC"] # flake8-type-checking is "TC" since ruff 0.8 (was "TCH")6263[tool.mypy]64python_version = "3.11"65strict = true66```6768## PyInstaller Quick Reference6970### One-File Mode7172```python73exe = EXE(pyz, a.scripts, a.binaries, a.zipfiles, a.datas,74 name='MyApp', console=False, icon='icon.ico')75```7677### One-Folder Mode7879```python80exe = EXE(pyz, a.scripts, exclude_binaries=True,81 name='MyApp', console=False, icon='icon.ico')82coll = COLLECT(exe, a.binaries, a.zipfiles, a.datas, name='MyApp')83```8485### Common Hidden Imports8687- `pkg_resources.extern`88- `accessible_output2` (for a11y desktop apps)89- `keyring.backends` (for credential storage)90- `platformdirs`91- `httpx._transports` / `httpcore._backends`92- `encodings` (always needed)9394## wxPython Quick Reference9596### Sizer Cheat Sheet9798Each sizer, with when to use.99100| Sizer | When to Use |101|---|---|102| `wx.BoxSizer(wx.VERTICAL)` | Stack items top-to-bottom |103| `wx.BoxSizer(wx.HORIZONTAL)` | Lay items left-to-right |104| `wx.GridBagSizer(vgap, hgap)` | Form layouts with labels + controls |105| `wx.FlexGridSizer(rows, cols, vgap, hgap)` | Even grid layouts |106| `wx.WrapSizer` | Flow layout that wraps |107| `wx.StaticBoxSizer(wx.VERTICAL, parent, "Label")` | Grouped controls with border |108109### Thread-Safe GUI Updates110111```python112# From worker thread:113wx.CallAfter(self.update_status, "Done")114wx.PostEvent(self, CustomEvent(data=result))115116# NEVER do this from a worker thread:117self.status_bar.SetStatusText("Done") # CRASH or CORRUPTION118```119120### Standard IDs121122Each standard ID, with its ID and purpose.123124| ID | Purpose |125|---|---|126| `wx.ID_OK` | OK button |127| `wx.ID_CANCEL` | Cancel button |128| `wx.ID_SAVE` | Save action |129| `wx.ID_OPEN` | Open action |130| `wx.ID_EXIT` | Exit / Quit |131| `wx.ID_HELP` | Help action |132| `wx.ID_NEW` | New document |133| `wx.ID_UNDO` / `wx.ID_REDO` | Undo / Redo |134135### Event Types136137Each event, with its trigger.138139| Event | Trigger |140|---|---|141| `wx.EVT_BUTTON` | Button click |142| `wx.EVT_MENU` | Menu item selected |143| `wx.EVT_CLOSE` | Window close requested |144| `wx.EVT_SIZE` | Window resized |145| `wx.EVT_TIMER` | Timer fired |146| `wx.EVT_TEXT` | Text control content changed |147| `wx.EVT_LIST_ITEM_SELECTED` | List item selected |148| `wx.EVT_TREE_SEL_CHANGED` | Tree selection changed |149| `wx.EVT_UPDATE_UI` | UI state update check |150151## Common Pitfalls152153### Python154155- **Mutable default arguments:** `def f(items=[])` shares the list across calls. Use `None` and create inside.156- **Late binding closures:** `lambda: x` in a loop captures the variable, not the value. Use `lambda x=x: x`.157- **Circular imports:** Move imports inside functions, use `TYPE_CHECKING` block, or restructure modules.158- **`field()` outside dataclass:** `field()` is only valid inside `@dataclass` classes. Use plain type annotations elsewhere.159- **`is` vs `==`:** `is` checks identity, `==` checks equality. Use `is` only for `None`, `True`, `False`.160- **String concatenation in loops:** Use `"".join()` or `io.StringIO` instead.161162### wxPython163164- **GUI from worker thread:** Always use `wx.CallAfter()` or `wx.PostEvent()`.165- **Missing `event.Skip()`:** Other handlers won't fire. Call `event.Skip()` unless you intentionally consume the event.166- **Timer not stopped:** Stop timers in `EVT_CLOSE` handler to prevent callbacks after destruction.167- **AUI not uninitialized:** Call `_mgr.UnInit()` in close handler.168- **Dialog not destroyed:** Use context managers (`with MyDialog(...) as dlg:`) for automatic cleanup.169- **Wrong parent for sizer items:** All controls in a sizer must have the same parent panel.170- **Absolute positioning:** Never use `SetPosition()` or `SetSize()` for layout. Always use sizers.171172## Cross-Platform Paths173174```python175from platformdirs import user_config_dir, user_data_dir, user_cache_dir176177config = user_config_dir("MyApp", "MyCompany") # %APPDATA% / ~/Library/... / ~/.config/178data = user_data_dir("MyApp", "MyCompany")179cache = user_cache_dir("MyApp", "MyCompany")180```181182## Testing Quick Reference183184```bash185# Run all tests186pytest187188# Run specific test file189pytest tests/test_queue.py190191# Run specific test192pytest tests/test_queue.py::test_submit_job -v193194# With coverage195pytest --cov=mypackage --cov-report=term-missing196197# Stop on first failure198pytest -x199200# Show locals on failure201pytest -l202```203204## Logging Setup Template205206```python207import logging208209def setup_logging(level: int = logging.INFO) -> None:210 logging.basicConfig(211 level=level,212 format="%(asctime)s %(name)s %(levelname)s %(message)s",213 datefmt="%Y-%m-%d %H:%M:%S",214 )215 # Quiet noisy libraries216 logging.getLogger("httpx").setLevel(logging.WARNING)217 logging.getLogger("httpcore").setLevel(logging.WARNING)218```219220## Desktop Accessibility Quick Reference221222### Platform API Summary223224Each platform, with API, python binding and use for.225226| Platform | API | Python Binding | Use For |227|---|---|---|---|228| Windows | UI Automation (UIA) | `comtypes`, `pywinauto` | Modern apps, NVDA/Narrator |229| Windows | MSAA / IAccessible2 | `comtypes`, `pywinauto` | Legacy apps, JAWS |230| macOS | NSAccessibility | `pyobjc` | VoiceOver |231232### wxPython Accessibility Essentials233234```python235# Name every control that lacks a visible label236# CORRECT: use StaticText immediately before the control in the sizer237label = wx.StaticText(panel, label="Scan progress:")238# ctrl = wx.Gauge(panel) -- add label to sizer right before ctrl239# WRONG: SetName() is ignored by screen readers240# ctrl.SetName("Scan progress") -- only affects FindWindowByName()241242# Tab order follows sizer insertion order; override with:243ctrl2.MoveAfterInTabOrder(ctrl1)244245# Keyboard shortcuts via accelerator table246accel = wx.AcceleratorTable([247 (wx.ACCEL_CTRL, ord('S'), wx.ID_SAVE),248 (wx.ACCEL_CTRL, ord('Q'), wx.ID_EXIT),249])250frame.SetAcceleratorTable(accel)251252# Platform-correct button order in dialogs253sizer.Add(dialog.CreateStdDialogButtonSizer(wx.OK | wx.CANCEL))254```255256### Screen Reader Interaction Model257258Screen readers expose controls as: **Name + Role + Value + State**259260| Property | wxPython Source | Example |261|---|---|---|262| Name | Preceding `wx.StaticText`, `label=` parameter, or `SetToolTip()` | "Scan progress" |263| Role | Widget type (automatic) | button, text field, list |264| Value | Widget content | "75%", "Hello world" |265| State | Widget flags | focused, disabled, checked |266267### Desktop A11y Checklist2682691. Every control has a meaningful name (preceding `wx.StaticText` for inputs, `label=` for buttons, `SetToolTip()` for image-only controls)2702. Keyboard-only operation -- every action reachable via Tab/Enter/Space/arrows2713. Focus visible -- never suppress focus indicators2724. Tab order is logical (generally top-to-bottom, left-to-right)2735. Color is not the sole information carrier2746. High contrast mode supported (use system colors, not hardcoded)2757. Dialogs use `CreateStdDialogButtonSizer()` for platform-correct button order2768. AUI panes are keyboard-navigable277278### Structured Audit Rule Sets279280When audit mode is activated, agents use these structured detection rule sets:281282| Rule Prefix | Agent | Scope | Count |283|---|---|---|---|284| WX-A11Y-001..012 | `wxpython-specialist` | wxPython-specific patterns (StaticText labels, AcceleratorTable, mouse-only events, dialogs) | 12 rules |285| DTK-A11Y-001..012 | `desktop-a11y-specialist` | Platform-level API patterns (Name/Role/State/Value, focus, UIA/NSAccessibility) | 12 rules |286| TST-A11Y-001..010 | `desktop-a11y-testing-coach` | Test coverage gaps (automated tests, SR testing, keyboard plans, CI integration) | 10 rules |287288Rule sets don't overlap -- WX covers wxPython widget patterns, DTK covers platform APIs, TST covers testing process gaps.289290### Agent Routing291292For deeper expertise, the skill routes to these specialists:293294- **`desktop-a11y-specialist`** -- Platform API implementation, wx.Accessible, custom widget patterns (DTK-A11Y-* audit rules)295- **`desktop-a11y-testing-coach`** -- NVDA/JAWS/Narrator testing, Accessibility Insights, automated UIA tests (TST-A11Y-* audit rules)296- **`a11y-tool-builder`** -- Rule engine architecture, document parsers, severity scoring, report generators