How djsaunders1997/uv-wingman works
UV Wingman is a VS Code extension for managing uv projects. Users invoke commands or status-bar actions to initialize projects, create and activate environments, sync or edit dependencies, and run scripts; these actions build shell-specific commands and send them to the integrated terminal. The extension also manages Python interpreter selection and presents dependency links, version hints, and an interactive graph. The graph reflects sampled call sites and README capabilities; unsampled command-registration details and some UI wiring are not inferred beyond documented behavior.
Main entry points: extension.js Extension activation · commands.js Project commands · dependencyGraphPanel.js Dependency graph panel · statusBarItems.js Status bar
Components 18
Extension UI
- Extension activation
src/extension.js - Status bar
src/statusBarItems.js
Project management
- Project commands
src/commands.js - Shell commands
src/terminalCommands.js - Interpreter management
src/interpreter.js
Dependency insights
- PyPI document links
src/documentLinks.js - Version hints
src/codeLens.js - Dependency graph panel
src/dependencyGraphPanel.js - Graph construction
src/dependencyGraph.js - Graph visualization
media/dependencyGraph.html
Shared services
- Extension settings
src/config.js - Workspace and terminal utilities
src/utils.js - TOML dependency parsing
src/tomlParser.js
Other components
- VS Code user
- Integrated terminal
- PyPI
- uv CLI
- Python interpreter setting
Connections 27
- VS Code user → Extension activation: uses extension
README.md - Extension activation → Project commands: registers commands
src/extension.js - Extension activation → Status bar: initializes status
src/extension.js - Extension activation → PyPI document links: registers links
src/extension.js - Extension activation → Version hints: registers hints
src/extension.js - Project commands → Shell commands: builds commands
src/commands.js - Project commands → Workspace and terminal utilities: sends terminal text
src/commands.js - Project commands → Interpreter management: sets interpreter
src/commands.js - Project commands → Status bar: updates display
src/commands.js - Shell commands → Extension settings: reads env name
src/terminalCommands.js - Shell commands → Integrated terminal: provides shell commands
- Workspace and terminal utilities → Integrated terminal: sends command
src/utils.js - Interpreter management → Extension settings: reads env name
src/interpreter.js - Interpreter management → Python interpreter setting: updates setting
src/interpreter.js - Status bar → Extension settings: reads settings
src/statusBarItems.js - Status bar → Python interpreter setting: checks env version
src/statusBarItems.js - PyPI document links → TOML dependency parsing: finds package positions
src/documentLinks.js - PyPI document links → PyPI: links packages
README.md - Version hints → TOML dependency parsing: finds dependency positions
src/codeLens.js - Version hints → PyPI: fetches package data
src/codeLens.js - Extension activation → Dependency graph panel: opens graph
src/extension.js - Dependency graph panel → Graph construction: builds graph data
src/dependencyGraphPanel.js - Dependency graph panel → Graph visualization: renders graph
src/dependencyGraphPanel.js - Graph construction → TOML dependency parsing: parses project dependencies
src/dependencyGraph.js - Dependency graph panel → Workspace and terminal utilities: gets workspace
src/dependencyGraphPanel.js - VS Code user → Status bar: clicks actions
README.md - VS Code user → Dependency graph panel: requests visualization
README.md