Hacer que el proyecto sea instalable

Hacer que tu proyecto sea instalable significa que puedes construir un archivo wheel e instalarlo en otro entorno, al igual que instalaste Flask en el entorno de tu proyecto. Esto hace que el despliegue de tu proyecto sea igual que instalar cualquier otra biblioteca, por lo que estás utilizando todas las herramientas estándar de Python para gestionar todo.

La instalación también viene con otros beneficios que podrían no ser obvios desde el tutorial o como un nuevo usuario de Python, incluyendo:

• Actualmente, Python y Flask entienden cómo usar el paquete flaskr sólo porque lo ejecutas desde el directorio de tu proyecto. Instalarlo significa que puedes importarlo sin importar desde dónde lo ejecutes.

• Puedes gestionar las dependencias de tu proyecto igual que otros paquetes, así que pip install tuproyecto.whl las instala.

• Las herramientas de prueba pueden aislar el entorno de prueba del entorno de desarrollo.

Nota

Esto se está introduciendo tarde en el tutorial, pero en tus futuros proyectos deberías empezar siempre con esto.

Describa el proyecto

El archivo pyproject.toml describe tu proyecto y cómo construirlo.

pyproject.toml

[project]
name = "flaskr"
version = "1.0.0"
description = "The basic blog app built in the Flask tutorial."
dependencies = [
    "flask",
]

[build-system]
requires = ["flit_core<4"]
build-backend = "flit_core.buildapi"

Consulte el tutorial oficial Tutorial de empaquetado para obtener más explicaciones sobre los archivos y las opciones utilizadas.

Instalar el proyecto

Utilice pip para instalar su proyecto en el entorno virtual.

$ pip install -e .

Esto le dice a pip que encuentre pyproject.toml en el directorio actual e instale el proyecto en modo editable o development. Modo editable significa que a medida que realice cambios en su código local, sólo tendrá que volver a instalar si cambia los metadatos sobre el proyecto, tales como sus dependencias.

Se puede observar que el proyecto se instala ahora con pip list.

$ pip list

Package        Version   Location
-------------- --------- ----------------------------------
click          6.7
Flask          1.0
flaskr         1.0.0     /home/user/Projects/flask-tutorial
itsdangerous   0.24
Jinja2         2.10
MarkupSafe     1.0
pip            9.0.3
Werkzeug       0.14.1

Nada cambia de cómo has estado ejecutando tu proyecto hasta ahora. --app sigue siendo flaskr y flask run sigue ejecutando la aplicación, pero puedes llamarla desde cualquier lugar, no sólo desde el directorio flask-tutorial.

Continúe con Cobertura de la prueba.