Cómo aprovechar el poder del código abierto ～ Bienvenido al mundo de Ubuntu ～

Cómo instalar y usar pyenv en Ubuntu para gestionar múltiples versiones de Python

Creación de entornos de desarrollo
目次

1. Introducción

Al desarrollar con Python en Ubuntu, es común necesitar diferentes versiones de Python para distintos proyectos. En estos casos, una herramienta de gestión de versiones como pyenv resulta muy útil. En este artículo, explicaremos cómo administrar fácilmente múltiples versiones de Python en Ubuntu usando pyenv.

Importancia de la gestión de versiones de Python

Las versiones de Python evolucionan constantemente: se añaden nuevas funciones y parches de seguridad, pero también existen programas que solo funcionan en versiones más antiguas. Por eso, poder alternar entre diferentes versiones según el proyecto es esencial para un desarrollo eficiente.

Ventajas de combinar Ubuntu y pyenv

Ubuntu es un sistema operativo muy popular entre desarrolladores, y configurar entornos de Python en él es bastante sencillo. Usar pyenv en Ubuntu permite instalar y alternar entre diferentes versiones de Python sin afectar el entorno global del sistema, facilitando la gestión del entorno de desarrollo.

2. ¿Qué es pyenv?

pyenv es una herramienta para gestionar fácilmente múltiples versiones de Python en un mismo sistema. Tradicionalmente, para usar una versión específica era necesario instalarla en todo el sistema. Con pyenv, en cambio, se pueden instalar versiones independientes por usuario o proyecto, lo que simplifica enormemente la gestión.

Principales funciones de pyenv

  • Gestión de múltiples versiones: Permite instalar y usar varias versiones de Python en un solo sistema.
  • Cambio de versiones: Facilita alternar entre versiones específicas de Python según cada proyecto.
  • Integración con entornos virtuales: Al combinarlo con venv o pyenv-virtualenv, se pueden administrar entornos virtuales de forma sencilla.

Por qué pyenv es útil

En muchos entornos de desarrollo, un proyecto puede requerir la versión más reciente de Python mientras otro necesita una más antigua. pyenv resulta ideal para estos casos, ya que permite mantener la compatibilidad entre proyectos mediante el uso flexible de diferentes versiones.

3. Cómo instalar pyenv en Ubuntu

Para instalar pyenv en Ubuntu, primero es necesario configurar algunos paquetes de dependencias que garantizan su correcto funcionamiento.

Instalación de los paquetes requeridos

Primero, instala los paquetes necesarios con los siguientes comandos:
sudo apt update
sudo apt install make build-essential libssl-dev zlib1g-dev \
libbz2-dev libreadline-dev libsqlite3-dev wget curl llvm \
libncursesw5-dev xz-utils tk-dev libxml2-dev libxmlsec1-dev \
libffi-dev liblzma-dev

Instalación de pyenv

El método más común es clonar directamente desde GitHub:
curl https://pyenv.run | bash

Configuración de variables de entorno

Agrega las siguientes líneas en ~/.bashrc (o ~/.zshrc) para que pyenv funcione correctamente:
export PYENV_ROOT="$HOME/.pyenv"
export PATH="$PYENV_ROOT/bin:$PATH"
eval "$(pyenv init --path)"
eval "$(pyenv init -)"
Una vez hecho esto, reinicia la terminal o ejecuta source ~/.bashrc para aplicar los cambios.

4. Instalación y gestión de versiones de Python

Con pyenv instalado, ya puedes proceder a instalar diferentes versiones de Python y alternar entre ellas según lo necesites.

Comprobar e instalar versiones de Python

Lista todas las versiones disponibles con:
pyenv install --list
Elige la versión que quieras instalar:
pyenv install 3.10.8

Cambiar de versión

Para establecer una versión global:
pyenv global 3.10.8
Para usar una versión específica en un proyecto, configura el directorio con:
pyenv local 3.10.8

5. Crear entornos virtuales con pyenv

Además de gestionar versiones, es recomendable usar entornos virtuales para aislar dependencias en cada proyecto.

Uso de venv

Ubuntu incluye venv como parte de la librería estándar de Python. Puedes crear un entorno virtual con:
python -m venv .venv
Activar el entorno virtual:
source .venv/bin/activate
Desactivarlo:
deactivate

6. Solución de problemas con pyenv

En ocasiones, ciertas versiones pueden no instalarse correctamente o presentarse errores en la configuración de PATH.

Errores comunes y soluciones

  1. Error al instalar versiones: Verifica que todas las dependencias estén instaladas con sudo apt install.
  2. PATH mal configurado: Si no se cambia la versión, revisa que ~/.bashrc contenga la configuración correcta y ejecuta source ~/.bashrc.

7. Configuración avanzada y usos

Una vez dominado lo básico, puedes mejorar aún más tu entorno con plugins y herramientas adicionales.

Uso de pyenv-virtualenv

Un plugin muy popular es pyenv-virtualenv, que facilita la gestión de múltiples entornos virtuales.
git clone https://github.com/pyenv/pyenv-virtualenv.git $(pyenv root)/plugins/pyenv-virtualenv
Crear y activar un entorno:
pyenv virtualenv 3.10.8 myenv
pyenv activate myenv
Desactivar el entorno:
pyenv deactivate

Integración con otras herramientas de gestión

  • Homebrew: Aunque es más común en Mac, también puede usarse en Ubuntu:
    brew install pyenv
  • Miniconda: Una herramienta ligera para gestionar paquetes de Python. Se puede instalar con pyenv:
    pyenv install miniconda3-latest

8. Conclusión

En este artículo vimos cómo usar pyenv en Ubuntu para gestionar entornos de Python. Aprendiste a instalar múltiples versiones, crear entornos virtuales y resolver errores comunes.

Glosario de términos

  • Gestión de versiones = version management
  • Entorno virtual = virtual environment
  • Dependencias = dependencies
  • Configuración de PATH = PATH configuration
  • Paquetes = packages
  • Plugin = plugin
  • Variables de entorno = environment variables
  • Terminal = terminal
Pythonプログラミングの世界
【pyenv徹底解説】Pythonのバージョン管理から仮想環境まで完全ガイド

目次 1 1. pyenvとは？1.1 Pythonバージョン管理の課題1.2 pyenvの利点1.3 pyenvの仕組…

侍エンジニア塾