venv-relocate 0.3.0

Detecte et corrige les chemins absolus casses d'un venv deplace ou renomme.

venv-relocate

Detects and fixes broken absolute paths inside a Python virtual environment that has been moved or renamed.

The problem

When you move or rename the parent folder of a venv, all scripts inside it still hold the old absolute path hardcoded (shebangs, pyvenv.cfg, activation scripts). The venv becomes unusable even though the files are physically still there.

venv-relocate detects the mismatch between the recorded path and the real path, then rewrites the affected files in-place.

What it fixes

• pyvenv.cfg
• Shebangs of all scripts in bin/ (or Scripts/ on Windows)
• Activation scripts: activate, activate.csh, activate.fish, Activate.ps1

Installation

pip install venv-relocate

Usage

# Preview what would be changed (nothing is written)
venv-relocate .venv --dry-run

# Apply fixes (creates .bak backups by default)
venv-relocate .venv

# Apply without backups
venv-relocate .venv --no-backup

License

Copyright (c) 2026 Mehdi.A — MIT