Configura un entorno de desarrollo de Python

En este instructivo, se muestra cómo preparar tu máquina local para el desarrollo en Python, incluido el desarrollo de aplicaciones de Python que se ejecutan en Google Cloud.

Si ya tienes configurado un entorno de desarrollo, consulta Python y Google Cloud para obtener una descripción general sobre cómo ejecutar apps de Python en Google Cloud.

Objetivos

  • Instala la versión más reciente de Python.
  • Usa venv para aislar las dependencias.
  • Instalar un editor (opcional).
  • Instala la CLI de Google Cloud (opcional).
  • Instala las bibliotecas cliente de Cloud para Python (opcional).
  • Instala otras herramientas útiles

Instalar Python

Las instrucciones de instalación de Python varían según el sistema operativo. Sigue la guía del sistema operativo que ejecutas en tu entorno de desarrollo, macOS, Windows o Linux.

macOS

macOS incluye una versión de Python de forma predeterminada y la usa para sus propios fines. Para evitar interferir en macOS, recomendamos crear un entorno de desarrollo separado y, luego, instalar la versión más reciente de Python. Para instalar Python, usa homebrew.

  1. Si deseas usar homebrew para instalar paquetes de Python, necesitas un compilador. Puedes obtenerlo si instalas las herramientas de línea de comandos de Xcode.

    xcode-select --install
    
  2. Para instalar Homebrew, sigue las instrucciones de la página principal de Homebrew y luego utiliza Homebrew para instalar Python de la siguiente manera:

    brew install python
    pyenv install 3.9
    
  3. Una vez finalizadas las instalaciones, verifica que Python 3 esté disponible como python y python3, y que pip también esté instalado.

    Para verificar que Python esté disponible, ejecuta el siguiente comando:

    python --version
    

    En el resultado, se muestra la versión. Puedes obtener información sobre la versión más reciente de Homebrew de Python en la página de Homebrew Python Formulae.

    Para verificar que PIP esté disponible, ejecuta el siguiente comando:

    pip --version
    

    En los resultados, se muestran las versiones. Puedes obtener más información sobre la versión más reciente de PIP en las Notas de versión de PIP.

    Homebrew instala las versiones más recientes de Python disponibles en tu plataforma a través de Homebrew. Los números de versión en los resultados pueden ser diferentes de las versiones oficiales más recientes de Python.

Windows

  1. Para instalar Python en un entorno de Windows, descarga los instaladores de las versiones más recientes de Python desde el sitio web de Python.

  2. A fin de acceder a tu versión de Python, usa el Selector de Python para Windows.

    Para iniciar la última versión de Python que instalaste, ejecuta el siguiente comando:

    py
    

    Para iniciar la última versión de Python 3 que instalaste, ejecuta el siguiente comando:

    py -3
    

    Para verificar la versión de PIP disponible, ejecuta el siguiente comando:

    py -m pip --version
    

    En el resultado, se muestra la versión de C:\users\[USERNAME]\appdata\local\programs\python\python38-32\lib\site-packages.

    Puedes obtener más información sobre la versión más reciente de PIP en las Notas de versión de PIP.

Linux

La mayoría de las distribuciones de Linux incluyen versiones recientes de Python.

  1. A fin de instalar Python en un entorno de Linux, instala los paquetes adecuados para tu distribución. En Debian y Ubuntu, estos paquetes son python3, python3-dev y python3-venv.

    Instala estos paquetes con los siguientes comandos:

    sudo apt update
    sudo apt install python3 python3-dev python3-venv
    
  2. También debes instalar pip. Si bien Debian y la mayoría de las demás distribuciones incluyen un paquete python-pip, te recomendamos que instales pip para obtener la última versión:

    sudo apt-get install wget
    wget https://bootstrap.pypa.io/get-pip.py
    sudo python3 get-pip.py
    
  3. Una vez finalizadas las instalaciones, verifica que tengas pip instalado:

    pip --version
    

    En el resultado, se muestra la versión de /usr/local/lib/python3.x/dist-packages. Puedes obtener más información sobre la versión más reciente de PIP en las Notas de versión de PIP.

Usa venv para aislar dependencias

venv es una herramienta que crea entornos de Python aislados. Estos entornos aislados pueden tener versiones separadas de los paquetes de Python, lo que te permite aislar las dependencias de un proyecto de las dependencias de otros proyectos. Te recomendamos que siempre uses un entorno virtual por proyecto cuando desarrolles con Python de forma local.

  1. Usa el comando venv para crear una copia virtual de toda la instalación de Python. En este instructivo, se crea una copia virtual en una carpeta llamada env, pero puedes especificar cualquier nombre para la carpeta.

    macOS

    cd your-project
    python -m venv env
    

    Windows

    cd your-project
    py -m venv env
    

    Linux

    cd your-project
    python3 -m venv env
    
  2. Configura tu shell para usar las rutas de acceso venv para Python mediante la activación del entorno virtual.

    macOS

    source env/bin/activate
    

    Windows

    .\env\Scripts\activate
    

    Linux

    source env/bin/activate
    
  3. Ahora puedes instalar paquetes sin afectar a otros proyectos ni a la instalación global de Python:

    pip install google-cloud-storage
    

    Si quieres dejar de usar virtual environment y volver al Python global, desactívalo:

    deactivate
    

Puedes leer más sobre venv en la documentación de venv.

Instala un editor

Necesitas un editor para desarrollar apps de Python. Estos son algunos de los editores más populares (en un orden específico):

Instala las bibliotecas cliente de Cloud para Python

Las bibliotecas cliente de Cloud para Python representan cómo los desarrolladores de Python se integran con los servicios de Google Cloud como Datastore y Cloud Storage. A fin de instalar el paquete para una API individual como Cloud Storage, usa un comando similar al siguiente:

pip install --upgrade google-cloud-storage

Instala la CLI de gcloud

La CLI de gcloud es un conjunto de herramientas de línea de comandos para Google Cloud. Contiene gcloudgsutilbq, que puedes usar para acceder a Compute Engine, Cloud Storage, BigQuery y otros productos y servicios desde la línea de comandos. Puedes ejecutar estas herramientas de manera interactiva o en tus secuencias de comandos automatizadas.

¿Qué sigue?