Introducción a Flask

Creando el entorno virtual

Con las herramientas necesarias ya instaladas, tenemos que crear un directorio donde vamos a contener los archivos necesarios. Creamos una carpeta que se llame hello_world_app y nos movemos dentro de ella para instalar el entorno virtual de Python.

~ ➜ mkdir hello_world_app
~ ➜ cd hello_world_app
~/hello_world_app ➜

Todo el trabajo de nuestros proyecto web lo realizaremos dentro de esta carpeta hello_world_app. Si queremos pasar nuestro trabajo a otra máquina basta con copiar esta carpeta a destino y tenemos nuestros proyecto donde querramos.

Para instalar el entorno virtual, debemos darle un nombre, flasky es el que elegimos para este proyecto. Simplemente para no confundir el nombre del entorno virtual con el paquete Flask. Vamos a usar Python 3 en nuestra aplicación. Para averiguar dónde está el binario de Python 3 usamos el comando which:

~/hello_world_app ➜ which python3
/usr/bin/python3
~/hello_world_app ➜

Ahora le pasamos esa ruta al comando virtualenv para que nos cree el entorno virtual con Python 3 utilizando el parámetro -p:

~/hello_world_app ➜ virtualenv -p /usr/bin/python3 flasky

Esto creará una carpeta llamada flasky que contiene una instalación de Python.

~/hello_world_app ➜ virtualenv -p $(which python3) flasky

Dentro de esta carpeta nos interesa el archivo activate que va a servir para activar nuestro entorno virtual en nuestra sesión activa de la terminal. Lo activamos usando el comando source de la siguiente manera:

~/hello_world_app ➜ source flasky/bin/activate
(flasky) ~/hello_world_app ➜

Luego podemos usar el comando deactivate para volver a tener nuestra terminal normalmente.

(flasky) ~/hello_world_app ➜ deactivate
~/hello_world_app ➜

Instalando Flask

Con el entorno virtual activo instalamos Flask usando pip.

(flasky) ~/hello_world_app ➜ pip install Flask

Armando la aplicación

Y creamos las carpetas necesarias para nuestra aplicación:

(flasky) ~/hello_world_app ➜ mkdir app
(flasky) ~/hello_world_app ➜ mkdir app/static
(flasky) ~/hello_world_app ➜ mkdir app/templates

Dentro de app tendremos crearemos todos los archivos de la aplicación de Flask. Dentro de ella creamos un archivo llamado routes.py con el siguiente contenido:

edd/routes.py (Código fuente)

#!/usr/bin/env python

# Importamos del módulo flask la clase Flask que creará nuestra aplicación.
from flask import Flask

# Creamos una nueva instancia de Flask y la asignamos a `app`.
app = Flask(__name__)

# Estos decoradores nos sirven para mapear qué funciones se van a llamar en el
# momento que al servidor le llegue una petición con esa URL.
@app.route('/')
@app.route('/index')
def index():
    """ Nuestra función que responde en '/' o en '/index' y devuelve un
        simple 'Hello World!'
    """
    return "<h1>Hello World!</h1>"

# Si ejecutamos el módulo, la aplicación de Flask corre con el modo de prueba
# activo.
if __name__ == "__main__":
    app.run(debug=True)

Luego podemos ejecutar nuestra aplicación de prueba que escuchará peticiones en la ip 127.0.0.1 en el puerto 5000. Para cortar el servidor podemos presionar Ctrl+C:

(flasky) ~/hello_world_app ➜ python routes.py
* Running on http://127.0.0.1:5000/ (Press CTRL+C to quit)
* Restarting with stat
* Debugger is active!
* Debugger pin code: 459-745-705