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):
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:
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]):
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:
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:
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:
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.