uvhow 0.4.0

Detect how uv was installed and get upgrade instructions

uvhow

Detect how uv was installed and get upgrade instructions.

Works on Windows, macOS, and Linux with support for all major installation methods.

Usage

Run with uvx (recommended):

uvx uvhow

Or install and run:

uv add uvhow
uvhow

Example Output

🔍 uv installation detected

✅ Found uv: uv 0.8.0 (0b2357294 2025-07-17)
📍 Location: /Users/user/.local/bin/uv

🎯 Installation method: Standalone installer
💡 To upgrade: uv self update

Supported Installation Methods

Unix/Linux/macOS

• Standalone installer (~/.local/bin/uv) -> uv self update
• Cargo (~/.cargo/bin/uv) -> cargo install --git https://github.com/astral-sh/uv uv --force
• Homebrew (/opt/homebrew/bin/uv) -> brew upgrade uv
• pipx (~/.local/share/pipx/venvs/uv/bin/uv) -> pipx upgrade uv
• pip (virtual environment) -> pip install --upgrade uv
• pip (system) -> sudo pip install --upgrade uv
• pip (user) -> pip install --upgrade --user uv

Windows

• Standalone installer (%USERPROFILE%\AppData\Local\Programs\uv\uv.exe) -> uv self update
• Cargo (%USERPROFILE%\.cargo\bin\uv.exe) -> cargo install --git https://github.com/astral-sh/uv uv --force
• Scoop (%USERPROFILE%\scoop\apps\uv\current\uv.exe) -> scoop update uv
• Chocolatey (C:\ProgramData\chocolatey\bin\uv.exe) -> choco upgrade uv
• pipx (%USERPROFILE%\pipx\venvs\uv\Scripts\uv.exe) -> pipx upgrade uv
• pip (virtual environment) -> pip install --upgrade uv
• pip (system) -> pip install --upgrade uv
• pip (user) -> pip install --upgrade --user uv
• pip (Windows Store Python) -> pip install --upgrade uv

Programmatic Usage

from uvhow import detect_uv_installation

installation = detect_uv_installation()
if installation:
    print(f"Method: {installation.method}")
    print(f"Upgrade: {installation.upgrade_command}")

Development

Setup

Install pre-commit hooks for code quality:

pip install pre-commit
pre-commit install

This will automatically:

• Remove trailing whitespace
• Fix end-of-file issues
• Format Python code with Black
• Sort imports with isort
• Validate YAML/TOML syntax
• Check for merge conflicts

Releasing New Versions

Use the included version bump script to release new versions:

# Preview what will happen
python bump_version.py patch --dry-run

# Bump patch version (0.1.2 -> 0.1.3) and deploy
python bump_version.py patch

# Bump minor version (0.1.2 -> 0.2.0) and deploy
python bump_version.py minor

# Bump major version (0.1.2 -> 1.0.0) and deploy
python bump_version.py major

The script will:

1. Update the version in pyproject.toml
2. Commit the version change
3. Create a git tag (e.g., v0.1.3)
4. Push the tag to trigger GitHub Actions deployment to PyPI

Requirements:

• Clean git working directory (no uncommitted changes)
• Push access to the repository