🚀 A comprehensive VS Code extension for Python developers that streamlines development workflow with UV package manager integration and smart panel management.
✨ Key Features
🐍 Python UV Integration
- 📁 Smart Context Menus: Right-click any
.py file for instant UV commands
- 🧠 Intelligent Module Detection: Automatically converts file paths to Python module notation
- 📂 Project Root Discovery: Finds project root using
pyproject.toml, setup.py, or .git
- 💻 Terminal Integration: Opens commands in dedicated, named terminal windows
- 🔍 UV Detection: Checks UV availability before execution
- 🔄 Fallback Support: Graceful degradation to standard Python when UV unavailable
- 📖 Installation Guidance: Direct links to UV documentation and installation guides
🎛️ Panel Management
- 📍 Status Bar Integration: One-click panel toggle directly from the status bar
- ⚡ Quick Access: Instantly show/hide the bottom panel (terminal, problems, output, debug console)
- 🎨 Clean Interface: Minimalist design that doesn't clutter your workspace
- ⌨️ No Shortcuts Needed: Mouse-friendly workflow without memorizing keyboard shortcuts
🛡️ Error Handling & Safety
- ✅ Pre-execution Checks: Validates UV installation before running commands
- 🔀 Smart Fallbacks: Offers Python alternatives when UV is missing
- 📚 Educational Prompts: Helpful dialogs with installation guidance
- 🚨 No Silent Failures: Clear feedback for all operations
🎯 How to Use
Python File Execution
- Right-Click: On any
.py file in the file explorer
- Choose Command:
- "uv run" → Direct file execution
- "uv run -m" → Module-based execution
- Automatic Terminal: Commands open in dedicated terminal windows
Panel Management
- Locate the Icon: Find the panel toggle icon in the left side of the status bar
- One-Click Toggle: Click to show/hide the bottom panel instantly
- Tooltip Help: Hover for helpful tooltips
Example Workflows
Direct File Execution
# File: /Users/dev/myproject/scripts/data_processor.py
# Command: uv run
# Executes: uv run "/Users/dev/myproject/scripts/data_processor.py"
Module Execution
# File: /Users/dev/myproject/src/ai/model_trainer.py
# Command: uv run -m
# Executes: uv run -m src.ai.model_trainer
Project Structure Example
myproject/
├── pyproject.toml # ← Project root detected
├── src/
│ └── ai/
│ └── groq_ai.py # Right-click → "uv run -m" → uv run -m src.ai.groq_ai
└── scripts/
└── helper.py # Right-click → "uv run" → uv run "/full/path/helper.py"
🎮 Commands Reference
| Command |
Function |
Usage |
extension.togglePanel |
Toggle bottom panel visibility |
Status bar icon |
extension.uvRun |
Execute Python file with UV |
Right-click context menu |
extension.uvRunModule |
Execute as Python module with UV |
Right-click context menu |
🔧 Technical Requirements
- VS Code: Version 1.99.0 or higher
- UV Package Manager: Optional (extension provides fallbacks)
- Python: For fallback functionality when UV unavailable
📦 Installation
From VS Code Marketplace
- Open VS Code
- Navigate to Extensions (
Ctrl+Shift+X / Cmd+Shift+X)
- Search for "python-uv-toolkit"
- Click Install
Manual Installation
- Download the
.vsix file
- Open VS Code
- Run
Extensions: Install from VSIX... command
- Select the downloaded file
🚨 Error Scenarios & Solutions
UV Not Installed
What happens: Extension detects missing UV
Options provided:
- 🔗 Install UV: Direct link to installation docs
- 🐍 Use Python: Fallback to standard Python commands
- ❌ Cancel: Skip execution
UV Not in PATH
What happens: Command execution fails
Solution: Extension guides you to installation resources
Project Root Not Found
What happens: Uses workspace root or file directory as fallback
Best practice: Ensure pyproject.toml, setup.py, or .git exists in project root
📝 Release Notes
🎉 Version 0.0.3 (Latest)
- ✅ UV Integration: Full UV command support with context menus
- ✅ Smart Module Detection: Automatic path-to-module conversion
- ✅ Error Handling: Comprehensive UV detection and fallbacks
- ✅ Terminal Management: Dedicated terminals for each command
- ✅ Installation Guidance: Direct links to UV documentation
🎯 Version 0.0.1 (Initial)
- ✅ Panel Toggle: Basic status bar panel management
🤝 Contributing
This extension is designed for Python developers who use UV for package management. Feedback and suggestions are welcome!
Following extension guidelines
Ensure that you've read through the extensions guidelines and follow the best practices for creating your extension.
Working with Markdown
You can author your README using Visual Studio Code. Here are some useful editor keyboard shortcuts:
- Split the editor (
Cmd+\ on macOS or Ctrl+\ on Windows and Linux).
- Toggle preview (
Shift+Cmd+V on macOS or Shift+Ctrl+V on Windows and Linux).
- Press
Ctrl+Space (Windows, Linux, macOS) to see a list of Markdown snippets.
Enjoy!
