Creación y activación del entorno virtual en Visual Studio Code

Para comenzar a desarrollar aplicaciones con Flask, es fundamental trabajar dentro de un entorno virtual que aísle las dependencias del proyecto. En Visual Studio Code, este proceso es sencillo y permite mantener un control adecuado de los paquetes instalados.

Primero, abre Visual Studio Code y navega hasta la carpeta donde deseas crear tu proyecto. Puedes utilizar la combinación de teclas Ctrl + K seguida de Ctrl + O para abrir una carpeta desde el editor.

Una vez en la carpeta del proyecto, abre el terminal integrado de Visual Studio Code presionando Ctrl + ` o navegando a Ver > Terminal en la barra de menú. Asegúrate de que el terminal esté en el directorio raíz de tu proyecto.

Para crear el entorno virtual con Python 3.13, ejecuta el siguiente comando:

python -m venv venv

Este comando crea una carpeta llamada venv que contiene el entorno virtual. Es una práctica recomendada nombrar el entorno virtual como venv, pero puedes elegir otro nombre si lo deseas.

Una vez creado, necesitas activar el entorno virtual. La activación varía según el sistema operativo:

• En Windows:

  venv\Scripts\activate

• En macOS y Linux:

  source venv/bin/activate

Al activar el entorno virtual, verás que el nombre del entorno aparece entre paréntesis al principio de la línea de tu terminal, indicando que estás trabajando dentro de él. Por ejemplo:

(venv) user@machine:~/project$

Para que Visual Studio Code reconozca el entorno virtual, asegúrate de que su extensión de Python esté instalada. Si no lo está, ve a la pestaña de extensiones (Ctrl + Shift + X) y busca "Python" desarrollada por Microsoft, luego instálala.

Después de activar el entorno virtual, selecciona el intérprete de Python correspondiente en Visual Studio Code. Haz clic en la versión de Python que aparece en la barra de estado en la parte inferior y elige el intérprete ubicado en venv. Esto garantiza que las operaciones como la ejecución de scripts y la depuración utilicen el entorno virtual.

Para verificar que estás utilizando el intérprete correcto, puedes ejecutar:

python --version

Debería mostrarse la versión de Python 3.13 o la que tengas instalada en tu entorno virtual.

Ahora, estás listo para instalar paquetes y desarrollar tu aplicación Flask dentro de un entorno aislado y controlado. Recuerda que todos los paquetes que instales mientras el entorno esté activo se instalarán únicamente en este entorno virtual.

Al finalizar tu trabajo, puedes desactivar el entorno virtual simplemente ejecutando:

deactivate

Esto restablecerá el terminal a su estado normal y evitará conflictos con otros proyectos o dependencias globales.

Instalación de Flask y verificar versión

Con el entorno virtual activado, estamos listos para instalar Flask en nuestro proyecto. La instalación se lleva a cabo utilizando el gestor de paquetes pip, incluido por defecto con Python.

Para instalar la última versión estable de Flask, ejecuta el siguiente comando en el terminal:

pip install Flask

Este comando descargará e instalará Flask y todas sus dependencias en el entorno virtual activo. Asegúrate de que el entorno virtual está activado para evitar conflictos con otros proyectos.

Una vez completada la instalación, es recomendable verificar la versión de Flask instalada. Puedes hacerlo de varias maneras. Una opción es utilizar el comando pip show:

pip show Flask

Este comando proporcionará información detallada sobre el paquete, incluyendo la versión instalada, la ubicación y las dependencias requeridas.

Otro método es utilizar el intérprete interactivo de Python. Abre el intérprete escribiendo:

python

Luego, en la consola de Python, puedes importar Flask y consultar su versión:

from importlib.metadata import version
version("flask")

Esto mostrará en pantalla el número de versión de Flask que acabas de instalar.

Recuerda salir del intérprete de Python cuando hayas terminado, escribiendo exit() o presionando Ctrl + D.

Es recomendable también actualizar pip a su última versión antes de instalar nuevos paquetes. Para ello, ejecuta:

pip install --upgrade pip

Mantener pip actualizado garantiza que dispongas de las mejoras y correcciones más recientes al gestionar paquetes Python.

Método hola mundo y ejecutar Flask por consola

Con Flask instalado y el entorno virtual activo, es momento de crear nuestra primera aplicación: un sencillo "Hola Mundo". Este ejercicio nos permitirá familiarizarnos con la estructura básica de una aplicación Flask y cómo ejecutarla desde la consola.

Comienza creando un archivo llamado app.py en la raíz de tu proyecto. Puedes hacerlo desde Visual Studio Code o utilizando el siguiente comando en el terminal:

touch app.py

Abre app.py y añade el siguiente código:

from flask import Flask

app = Flask(__name__)

@app.route('/')
def hola_mundo():
    return '¡Hola, mundo!'

Este código define una instancia de Flask llamada app y establece una ruta para la URL raíz '/'. La función hola_mundo() devuelve el texto '¡Hola, mundo!' cuando se accede a esta ruta. La ruta se define utilizando el decorador @app.route('/'), que indica a Flask qué función debe ejecutarse cuando se visita dicha ruta.

Para ejecutar la aplicación desde la consola, asegúrate de que el entorno virtual está activado y que te encuentras en el directorio donde está app.py. Luego, establece la variable de entorno FLASK_APP para que Flask sepa qué archivo ejecutar.

• En sistemas Unix (macOS y Linux), ejecuta:

export FLASK_APP=app.py

• En Windows, utiliza:

set FLASK_APP=app.py

Con la variable de entorno configurada, inicia el servidor de desarrollo de Flask con el siguiente comando:

flask run

Flask iniciará un servidor local y mostrará en la consola un mensaje similar:

 * Debug mode: off
WARNING: This is a development server. Do not use it in a production deployment. Use a production WSGI server instead.
 * Running on http://127.0.0.1:5000
Press CTRL+C to quit

Abre tu navegador web y visita la dirección http://127.0.0.1:5000/. Deberías ver lo siguiente:

Esto significa que tu aplicación Flask está funcionando correctamente. El servidor proporcionado por Flask es adecuado para desarrollo y pruebas, pero no debe usarse en producción. Por defecto, se ejecuta en modo no depuración, lo que significa que no mostrará información detallada sobre errores.

Para habilitar el modo debug, que facilita la detección de problemas durante el desarrollo, puedes establecer la variable de entorno FLASK_DEBUG.

• En sistemas Unix, ejecuta:

export FLASK_DEBUG=1

• En Windows, utiliza:

set FLASK_DEBUG=1

Ahora, cuando ejecutes flask run, el servidor se reiniciará automáticamente al detectar cambios en el código y proporcionará mensajes de error más detallados.

Alternativamente, puedes combinar las variables de entorno en un solo comando.

• En Unix:

export FLASK_APP=app.py FLASK_DEBUG=1

• En Windows:

set FLASK_APP=app.py
set FLASK_DEBUG=1

Recuerda que, al estar en modo debug, los cambios que realices en tu código se reflejarán inmediatamente sin necesidad de reiniciar manualmente el servidor. Esto agiliza el proceso de desarrollo y prueba.

Si prefieres evitar establecer variables de entorno cada vez, puedes añadir las siguientes líneas al final de tu app.py:

if __name__ == '__main__':
    app.run(debug=True)

Con este bloque, puedes ejecutar tu aplicación directamente con el comando:

python app.py

Esta práctica es útil para proyectos sencillos, pero es recomendable usar flask run y variables de entorno en proyectos más complejos para mantener una estructura clara y organizada.

En resumen, has creado una aplicación Flask básica que muestra un mensaje en la ruta principal. Has aprendido a ejecutar la aplicación desde la consola, configurar variables de entorno y utilizar el modo debug para mejorar tu flujo de desarrollo.