Skip to content

13. Apéndices

13.1. Instalación de Python

Los ejemplos y el caso de estudio requieren [Python] 3.12 o posterior ([Django] 6.1 lo exige). Se probaron con la versión 3.13.

En [Windows], descargue el instalador desde la página python.org/downloads (el botón "Download Python 3.13.x", o una versión más reciente). En la primera pantalla del instalador, marque la casilla "Add python.exe to PATH", que permite escribir [python] en cualquier consola, y luego haga clic en "Install Now". El instalador también instala [pip], el módulo [venv] y el lanzador [py] ([py -3.13] inicia una versión específica cuando hay varias instaladas). En [Windows] 10 y 11, escribir [python] sin tenerlo instalado abre Microsoft Store: se trata de un acceso directo del sistema que puede desactivarse (Configuración / Aplicaciones / Configuración avanzada de aplicaciones / Alias de ejecución de aplicaciones).

En [macOS], utilice el instalador de python.org o el administrador de paquetes [Homebrew]: [brew install python@3.13]. En [Linux], [Python] ya está presente, pero los módulos [venv] y [pip] suelen ser paquetes separados. En [Ubuntu] 24.04 (donde la versión de [Python] es 3.12):

sudo apt install python3 python3-venv python3-pip

En [macOS] y [Linux], los comandos se llaman [python3] y [pip3]; en un entorno virtual activado, basta con [python] y [pip]. Verifique la instalación en una consola nueva:

python --version
python -m pip --version

El primer comando debe mostrar un número de versión igual o superior a 3.12 (por ejemplo, [Python 3.13.7]).

13.2. pip y entornos virtuales

[pip] es el administrador de bibliotecas de [Python]. Descarga las bibliotecas del repositorio [PyPI] (pypi.org): se requiere una conexión a Internet durante la instalación. Si está detrás de un proxy corporativo, especifique el proxy mediante las variables de entorno [HTTP_PROXY] y [HTTPS_PROXY], o mediante la opción [--proxy] de [pip].

Un entorno virtual es una carpeta que contiene una copia ligera del intérprete de [Python] y sus propias bibliotecas: cada proyecto tiene las suyas, en las versiones que necesita, sin afectar la instalación de [Python] ni a otros proyectos. Comandos útiles en una carpeta de proyecto (la que contiene [requirements.txt]):

1
2
3
4
5
6
7
python -m venv .venv                 # crear el entorno virtual (carpeta .venv)
.venv\Scripts\activate               # activarlo (Windows)
source .venv/bin/activate            # activarlo (Linux, macOS)
pip install -r requirements.txt      # instalar las bibliotecas del proyecto
pip list                             # las bibliotecas instaladas
pip freeze                           # la misma lista, en el formato de requirements.txt
deactivate                           # salir del entorno

En [Windows], [PowerShell] a veces se niega a ejecutar el script de activación (“la ejecución de scripts está deshabilitada en este sistema”): el comando [Set-ExecutionPolicy -Scope CurrentUser RemoteSigned] la habilita para el usuario actual. También se puede omitir la activación llamando directamente al intérprete del entorno: [.venv\Scripts\python manage.py runserver].

La carpeta [.venv] no se puede copiar de una máquina a otra (contiene rutas absolutas y programas específicos del sistema): debe recrearse con los comandos anteriores. Por eso no se incluye en los materiales del curso. La carpeta [examples] tiene su propio entorno, compartido por los 28 ejemplos; el caso de estudio tiene el suyo.

La biblioteca [mysqlclient] y el controlador de [MySQL] (ejemplo 28 y caso de estudio) están escritos en C. En [Windows], [pip] descarga una versión precompilada: no se requiere ninguna acción. En [Linux] y [macOS], [pip] la compila y, para ello, requiere los archivos de desarrollo de [MySQL] y un compilador:

1
2
3
sudo apt install python3-dev default-libmysqlclient-dev build-essential pkg-config     # Ubuntu, Debian
brew install mysql-client pkg-config                                                    # macOS
export PKG_CONFIG_PATH="$(brew --prefix)/opt/mysql-client/lib/pkgconfig"                # macOS, antes de pip install

Sin ellos, [pip install -r requirements.txt] falla en [mysqlclient], con un mensaje de error que hace referencia a [pkg-config] o a [mysql_config].

13.3. Instalación de Visual Studio Code

[Visual Studio Code] se descarga desde code.visualstudio.com. Agregue tres extensiones (menú View / Extensions):

  • Python (de Microsoft): para ejecutar y depurar código [Python], y administrar entornos virtuales. Instala junto con ella la extensión Python Debugger;
  • Pylance (de Microsoft, también instalada con la extensión de Python): autocompletado de código, navegación por el código (incluido el código de [Django], ubicado en la carpeta [.venv]), reporte de errores y verificación de anotaciones de tipo;
  • Django (de Baptiste Darthenay): resaltado de sintaxis y atajos para las plantillas de [Django] (archivos [.html] de la carpeta [templates]).

Abra la carpeta [examples] o la carpeta del caso de estudio (menú File / Open Folder) y luego seleccione el intérprete del entorno virtual de la carpeta (paleta de comandos, Ctrl+Shift+P, Python: Select Interpreter, y después el de [.venv]). El terminal integrado (menú Terminal / New Terminal) activa entonces automáticamente el entorno y permite ejecutar aplicaciones y comandos de [python manage.py ...] sin salir del editor.

Para ejecutar una aplicación paso a paso, cree una configuración de depuración (menú Run / Add Configuration, luego Python Debugger y Django): el editor inicia [manage.py runserver] bajo el control del depurador y se detiene en los puntos de interrupción establecidos en las vistas.

13.4. Instalación de MySQL con Laragon

[Laragon] instala un servidor [MySQL] listo para usar en [Windows], junto con la herramienta de administración [HeidiSQL] (consulte “Instalación de Laragon” en la introducción). Después de la instalación:

  • el botón “Start All” inicia el servidor [MySQL] en el puerto 3306;
  • el usuario [root] no tiene contraseña: estos son los valores de la configuración [DATABASES] del ejemplo 28 ([config/settings.py]), y de las variables [DB_USER] y [DB_PASSWORD] del archivo [.env] en el caso de estudio;
  • el botón Database abre [HeidiSQL], donde la opción de menú File / Run a File (SQL) ejecuta los scripts [dbpersons.sql] (ejemplo 28) y [dbrdvmedecins2.sql] (caso de estudio).

En [Linux] o [macOS], instale [MySQL] o [MariaDB] con el administrador de paquetes del sistema y ejecute los scripts con el cliente de línea de comandos [mysql] ([mysql -u root < database/dbrdvmedecins2.sql]). El controlador [mysqlclient] y el motor [MySQL] de [Django] funcionan con ambos sin ninguna configuración. En [Linux], la cuenta [root] de [MariaDB] suele estar configurada para iniciar sesión solo mediante la cuenta del sistema [root] ([sudo mysql]): entonces se crea un usuario para las aplicaciones:

sudo mysql -e "CREATE USER 'course'@'localhost' IDENTIFIED BY 'course'; GRANT ALL ON dbpersons.* TO 'course'@'localhost'; GRANT ALL ON dbrdvmedecins2.* TO 'course'@'localhost';"

y se lo indicamos a las aplicaciones: las claves [USER] y [PASSWORD] de la configuración [DATABASES] para el ejemplo 28, las líneas [DB_USER=course] and [DB_PASSWORD=course] del archivo [.env] para el caso de estudio.

13.5. Instalación de curl

[curl] viene incluido con [Windows] 10 y 11, [macOS], y la mayoría de las distribuciones de [Linux]. En [PowerShell], se debe escribir [curl.exe] y no [curl]: en las versiones antiguas de [PowerShell], [curl] es un alias de otro comando ([Invoke-WebRequest]), que tiene opciones diferentes. En el símbolo del sistema de [Windows] ([cmd]), las comillas de una cadena JSON se escriben como [\"] (ejemplo 11), y una cadena URL que contenga [&] debe ir entre comillas dobles.

13.6. La herramienta django-admin

[Django] instala un comando, [django-admin], que no es necesario para seguir este documento (los ejemplos se entregan listos para usar), pero que sirve para iniciar un proyecto nuevo. El archivo [manage.py] de cada proyecto es un archivo [django-admin] que además conoce la configuración del proyecto: dentro de un proyecto, se escribe [python manage.py] en lugar de [django-admin]. Los comandos más útiles:

django-admin startproject config .        # un nuevo proyecto, cuya configuración es el paquete config
python manage.py startapp pages           # una nueva aplicación, la carpeta pages
python manage.py runserver 8000           # el servidor de desarrollo
python manage.py check                    # verificar el proyecto (configuración, rutas, modelos...)
python manage.py check --deploy           # verificar la configuración de seguridad para producción
python manage.py shell                    # una consola de Python, con Django cargado
python manage.py dbshell                  # el cliente de la base de datos, con la configuración del proyecto
python manage.py inspectdb                # escribir los modelos de una base de datos existente (para revisar y corregir)
python manage.py makemessages -l fr       # recopilar los textos por traducir (archivo .po)
python manage.py compilemessages          # compilar los diccionarios (archivos .mo)
python manage.py collectstatic            # reunir los archivos estáticos para producción
python manage.py diffsettings             # las configuraciones que difieren de los valores predeterminados

El punto al final del comando [startproject] crea el proyecto en la carpeta actual (sin él, el proyecto se crea en una carpeta nueva llamada [config]). Una aplicación creada con [startapp] debe agregarse a la lista de configuración [INSTALLED_APPS] . El comando [inspectdb] es una herramienta valiosa para una base de datos existente, como la del caso de estudio: lee las tablas y genera un primer borrador de los modelos con [managed = False]; solo queda nombrar las relaciones, elegir los tipos y agregar los métodos. Los comandos [makemigrations] y [migrate], que crean y actualizan las tablas a partir de los modelos, no se utilizaron en este documento: sus bases de datos se crean mediante scripts SQL, que se comparten con otras versiones de la aplicación.