HOWTO · Flask
Ejecutar una aplicación Flask
Configure un entorno virtual de Python, instale Flask, cree una pequeña aplicación app.py y ejecútela localmente.
En esta página
Para ejecutar una aplicación Flask, crea un entorno virtual de Python, instala Flask en él, guarda una ruta en app.py e inicia el servidor de desarrollo desde la interfaz de línea de comandos de Flask. Abre en un navegador la dirección local que muestra para ver la respuesta de la ruta. Esta guía usa Visual Studio Code, aunque los mismos archivos y comandos funcionan en cualquier otro editor.
Crear una aplicación básica con Flask
Flask es un framework web de Python para crear aplicaciones web y API. Un proyecto pequeño necesita Python, Flask instalado en el entorno del proyecto y un archivo de Python que defina la aplicación y sus rutas.
Primero, abre una carpeta del proyecto en Visual Studio Code y comprueba que Python esté disponible desde el terminal integrado ejecutando python --version. El comando debería mostrar una versión de Python instalada. En algunos sistemas, el comando de Python se llama python3; si hace falta, usa ese nombre de forma coherente para comprobar la versión, crear el entorno y ejecutar los comandos posteriores.
Crea un entorno virtual en la carpeta del proyecto con python -m venv .venv. Así, los paquetes de este proyecto se mantienen separados de los de otros proyectos de Python y de la instalación del sistema. Actívalo con el comando correspondiente a tu terminal:
- Símbolo del sistema de Windows:
.venv\Scripts\activate.bat - Windows PowerShell:
.venv\Scripts\Activate.ps1 - macOS o Linux:
source .venv/bin/activate
Después de activar el entorno, instala Flask con python -m pip install Flask. Usar python -m pip vincula la instalación al intérprete de Python seleccionado para el entorno activo. Si el terminal indica que python no está disponible, repite los comandos con python3 si ese comando está instalado. En Visual Studio Code, selecciona el intérprete .venv si el editor no lo detecta automáticamente.
Crea un archivo llamado app.py en la carpeta del proyecto y añade esta aplicación mínima. Su cliente de prueba solicita la ruta raíz e imprime la respuesta al ejecutar python app.py:
from flask import Flask
app = Flask(__name__)
@app.route("/")
def index():
return "Hi there, this is our basic Flask app."
if __name__ == "__main__":
response = app.test_client().get("/")
print(response.get_data(as_text=True))
Hi there, this is our basic Flask app.
La clase Flask crea el objeto de la aplicación. El decorador @app.route("/") asigna la ruta raíz del sitio a index, y la cadena que devuelve se convierte en la respuesta del navegador. El cliente de prueba recorre esa ruta sin abrir un puerto de red. El bloque if __name__ == "__main__": ejecuta la comprobación solo cuando ejecutas este archivo directamente; importarlo desde otro módulo no imprime la respuesta.
Para ver la aplicación en un navegador, mantén activo el entorno y deja el terminal en la carpeta que contiene app.py; después, inicia el servidor de desarrollo de Flask con flask --app app run. Si tu sistema usa python3, activa el entorno creado con ese intérprete y utiliza el comando de Flask correspondiente. Flask muestra una URL local, normalmente http://127.0.0.1:5000; abre la dirección exacta que aparezca en el terminal. Al visitar la ruta raíz, se muestra Hi there, this is our basic Flask app. Ese texto de respuesta permanece en inglés en el ejemplo. Mantén el proceso del terminal en ejecución mientras usas la página y pulsa Ctrl+C en ese terminal para detener el servidor. Al ejecutar python app.py, se realiza la comprobación de la ruta descrita arriba y el proceso termina.
El servidor integrado de Flask está pensado para el desarrollo local. No lo expongas como servidor de producción ni actives el modo de depuración en un despliegue de producción; utiliza un servidor WSGI de producción y una configuración de despliegue adecuada para tu proveedor.
