Gestión eficiente de virtualenvs en Python con scripts bash

Introducción

Manejar múltiples entornos virtuales de Python puede volverse engorroso: recordá la ruta de cada venv, escribir comandos largos para activarlos y no contar con autocompletado en el shell. Esta guía muestra cómo simplificar el proceso con funciones personalizadas en bash y completion, reduciendo la fricción en el día a día.

Qué es y para qué sirve

Un virtualenv (entorno virtual) aísla una distribución de Python y sus paquetes, permitiendo instalar dependencias específicas para un proyecto sin afectar el sistema o otros entornos. Es la forma estándar de gestionar dependencias en Python desde la versión 3.3+, usando el módulo venv (o virtualenv en versiones anteriores).

El problema surge al escalar: con decenas de entornos, activarlos manualmente (source ~/.venv/proyecto/bin/activate) es repetitivo y propenso a errores. Las soluciones aquí presentadas automatizan:

• Activación con un comando corto (setup-venv proyecto).
• Autocompletado de nombres de entornos en la terminal.
• Centralización de los entornos en un directorio dedicado (ej: ~/.venv).

Prerequisitos

• Sistema operativo: Debian 10+ o derivados (Ubuntu, etc.). Los comandos asumen bash como shell.
• Python: Versión 3.3 o superior (verificá con python3 –version).
• Paquetes: python3-venv (para el módulo venv). En Debian: sudo apt-get install python3-venv.
• Permisos: Acceso de escritura en tu directorio home y /etc/bash_completion.d/ (requiere sudo).

Guía paso a paso

1. Crear un directorio para los entornos

Centralizá todos los virtualenvs en un directorio, por ejemplo ~/.venv:

mkdir ~/.venv

2. Añadir la función de activación a tu configuración bash

Editá ~/.bashrc (o ~/.bash_aliases) y agregá la siguiente función:

setup-venv() {
    if [ -z "$1" ]; then
        echo "Usage: setup-venv <venv_name>"
        return 1
    fi
    venv_path="$HOME/.venv/$1"
    if [ ! -d "$venv_path" ]; then
        echo "Virtualenv '$1' not found in $venv_path"
        return 1
    fi
    source "$venv_path/bin/activate"
}

python3 -m venv ~/.venv/mi_proyecto

setup-venv mi_proyecto

sudo apt-get install bash-completion

source ~/.bashrc

_setup_venv() {
    local cur=${COMP_WORDS[COMP_CWORD]}
    local opts=$(find "$HOME/.venv" -mindepth 1 -maxdepth 1 -type d -printf "%f\n")
    COMPREPLY=($(compgen -W "${opts}" ${cur}))
}

complete -F _setup_venv setup-venv

sudo chmod 644 /etc/bash_completion.d/venv

source ~/.bashrc

deactivate