Python Requirements Updater

Smart version management for Python requirements.txt files with one-click updates and breaking change detection.

✨ Features

• 🔍 Smart Version Detection - Automatically detects requirements.txt and pyproject.toml files and displays version information
• 🎯 Risk Analysis - Distinguishes between safe updates (patch/minor) and risky updates (major versions)
• 🖱️ One-Click Updates - Click on version hints to update to the latest version instantly
• ⚠️ Safety Confirmation - Shows confirmation dialogs for major version updates to prevent breaking changes
• 📊 Status Bar Display - Real-time display of updatable package count
• 🌍 Multi-language Support - Supports Chinese, English, Japanese, Korean, and more languages
• 💾 Smart Caching - Reduces network requests and improves response speed
• 📦 Modern Python Projects - Full support for pyproject.toml with [project] dependencies and [project.optional-dependencies]

🚀 Installation

1. Open VS Code
2. Go to Extensions (Ctrl+Shift+X)
3. Search for "Python Requirements Updater"
4. Click Install

Or install from command line:

code --install-extension cookabc.python-requirements-updater

🚀 Usage

requirements.txt Files

1. Open any requirements.txt file
2. The extension automatically shows status for each dependency:
   • ✓ Up to date - Package is already latest version
   • ↗ Update to X.X.X - Safe update available (click to update)
   • ⚠️ Update to X.X.X Major - Major version update (use caution)

pyproject.toml Files

1. Open any pyproject.toml file with [project] dependencies
2. The extension supports both:
   • Main dependencies in [project] section
   • Optional dependencies in [project.optional-dependencies] sections
3. Shows the same version information and update capabilities

Batch Updates

• Click the status bar update notification
• Or use Command Palette: Ctrl+Shift+P → "Update All Packages"
• Automatically separates safe updates from risky major version updates

⚙️ Configuration

🏗️ Project Structure

src/
├── core/           # Core business logic
│   ├── cache.ts           # Cache management
│   ├── parser.ts          # Dependency parsing (requirements.txt)
│   ├── pyprojectParser.ts # pyproject.toml parsing
│   ├── unifiedParser.ts   # Unified parser for both formats
│   ├── versionAnalyzer.ts # Version risk analysis
│   └── versionResolver.ts # Version resolution
├── providers/      # Service providers
│   ├── codeLensProvider.ts # CodeLens provider
│   ├── pypiClient.ts      # PyPI API client
│   └── versionService.ts  # Version service
├── utils/          # Utility functions
│   ├── configuration.ts   # Configuration management
│   ├── i18n.ts           # Internationalization
│   └── statusBar.ts      # Status bar management
├── types/          # Type definitions
│   └── index.ts
└── extension.ts    # Extension entry point

🛠️ Development

# Install dependencies
npm install

# Compile
npm run compile

# Run tests
npm test

# Package extension
npx vsce package

🆕 pyproject.toml Support

Starting from v1.1.0, this extension now supports modern Python project files! It can parse and update dependencies in pyproject.toml files, supporting:

Supported Sections

• [project] - Main dependencies
• [project.optional-dependencies] - Optional dependency groups

Example pyproject.toml

[project]
name = "my-project"
version = "1.0.0"
dependencies = [
    "fastapi==0.116.1",
    "sqlalchemy==2.0.43",
    "pydantic==2.11.7",
]

[project.optional-dependencies]
dev = [
    "pytest>=7.0.0",
    "black>=23.0.0",
]

The extension will automatically detect pyproject.toml files and provide the same smart version checking and update capabilities as for requirements.txt files.

📄 License

MIT