How ctrondlp/pyguitest-recorder works
pyguitest-recorder captures desktop input, resolves interactions to accessible GUI targets where possible, converts observations into canonical events, and generates standalone pyguitest scripts. Users can also save recordings and regenerate scripts later. The graph reflects README capabilities and indexed source references; several implementation details are unsampled, so only documented or indexed relationships are connected.
Main entry points: recorder.py Recording lifecycle · cli.py CLI modes · x11.py X11 capture · win32.py Windows capture
Components 19
Command and settings
- CLI modes
src/pyguitest_recorder/cli.py - Settings
src/pyguitest_recorder/config/settings.py - Platform detection
src/pyguitest_recorder/platforms.py
Input capture
- Recording lifecycle
src/pyguitest_recorder/recorder.py - X11 capture
src/pyguitest_recorder/backends/x11.py - Windows capture
src/pyguitest_recorder/backends/win32.py - macOS capture
src/pyguitest_recorder/backends/macos.py - Raw event interface
src/pyguitest_recorder/backends/base.py - Stop-key recognition
src/pyguitest_recorder/stopkey.py
Event interpretation
- Window and element resolver
src/pyguitest_recorder/windows/resolver.py - Event normalization
src/pyguitest_recorder/analyzer/normalize.py - Wait inference
src/pyguitest_recorder/analyzer/sync.py
Recording and generation
- Canonical events
src/pyguitest_recorder/model/events.py - Recording model
src/pyguitest_recorder/model/recording.py - Python generator
src/pyguitest_recorder/generator/python.py - Generated test script
Other components
- Recorder user
- Desktop activity
- pyguitest runtime
Connections 25
- Recorder user → CLI modes: starts or configures
README.md - CLI modes → Settings: loads settings
src/pyguitest_recorder/cli.py - CLI modes → Platform detection: checks platform
src/pyguitest_recorder/cli.py - CLI modes → Recording lifecycle: starts recording
src/pyguitest_recorder/cli.py - Desktop activity → X11 capture: provides input
README.md - Desktop activity → Windows capture: provides input
README.md - Desktop activity → macOS capture: provides input
README.md - Recording lifecycle → X11 capture: selects capture backend
src/pyguitest_recorder/recorder.py - Recording lifecycle → Windows capture: selects capture backend
src/pyguitest_recorder/recorder.py - Recording lifecycle → macOS capture: selects capture backend
src/pyguitest_recorder/recorder.py - X11 capture → Raw event interface: produces raw events
src/pyguitest_recorder/backends/x11.py - Windows capture → Raw event interface: produces raw events
src/pyguitest_recorder/backends/win32.py - macOS capture → Raw event interface: produces raw events
src/pyguitest_recorder/backends/macos.py - Recording lifecycle → Stop-key recognition: recognizes stop chord
src/pyguitest_recorder/recorder.py - Recording lifecycle → Window and element resolver: resolves context
src/pyguitest_recorder/recorder.py - Window and element resolver → pyguitest runtime: queries GUI session
src/pyguitest_recorder/windows/resolver.py - Recording lifecycle → Event normalization: normalizes captured events
src/pyguitest_recorder/recorder.py - Event normalization → Canonical events: creates canonical events
src/pyguitest_recorder/analyzer/normalize.py - Recording lifecycle → Recording model: adds normalized events
- Canonical events → Recording model: stored as recording events
src/pyguitest_recorder/model/recording.py - CLI modes → Wait inference: infers waits for generation
src/pyguitest_recorder/cli.py - CLI modes → Python generator: generates or regenerates
src/pyguitest_recorder/cli.py - Python generator → Generated test script: renders Python source
README.md - Generated test script → pyguitest runtime: replays GUI test
README.md - Recorder user → Generated test script: runs generated test
README.md