Django 4.2 LTS Tutorial en Español

El objetivo de este repositorio es proponer una forma para hacer un proyecto Django abarcando el ciclo de vida completo. Es decir, desde cero hasta Producción.

Que incluye:

Proyecto tipo

• Modelos: Client, Device, MAC Addresses, Types (lookup) y Modelos abstractos base
• Navegación estandarizada

Model and Form validation examples

django-htmx (AJAX)

Django Testing

CI (Continuous Integration)

Utilización de herramientas para Calidad de Código (Code Quality Tools)

Pendientes:

• Deploy to AWS
• Contribución (How to)
• Internacionalización y localización

Etapa actual (Stage 28)

• Model Validation & Form Validation

Siguiente etapa (Stage 29)

• Deploy to AWS

Documentación en español Diango 4.2

• Documentación
• Tutorial Django
• Instrucciones detalladas de para instalar Django 4.2 (Ingles)

Propuesta de desarrollo

La propuesta de desarrollo es crecer en capítulos que se implementaran con branches de git con la nomenclatura DJ4Z2P-NNN-Inicio .... DJ4Z2P-NNN-Termino

Requerimientos

• Django versión 4.2 LTS
• Python 3.8 (Python 3.8 es la versión mínima para Django 4.2)

Ambiente para desarrollo

• Ubuntu 18.04
• Visual Studio Code Versión 1.77.0

Preparar ambiente (linux)

Crear directorio base y fuentes para el proyecto, por ejemplo:

$ mkdir -p ~/Proyectos/d42_proj/src
$ cd ~/Proyectos/d42_proj

Clonar este repo

$ git clone https://github.com/mherreradsci/django42-tutorial-es.git ./src

Instalación

$ cd ~/Proyectos/d42_proj
$ python3.8 -m venv ve_py38_django42
$ source ve_py38_django42/bin/activate

$ (ve_py38_django42)$ python --version
Python 3.8.0

# Para eliminar el venv (solo si deseas volver a crear el ambiente)
(ve_py38_django42)$ deactivate # Cierra el ambiente virtual
$ rm -rf ./ve_py38_django42 # Elimina el directorio completo, es decir, el ambiente virtual

# Actualiza la versión de pip
(ve_py38_django42)$ python -m pip install pip --upgrade

# Instalar requerimientos
(ve_py38_django42)$ cd ~/Proyectos/d42_proj/src
(ve_py38_django42)$ pip install -r requirements-dev.txt

Ejecución

Activar el ambiente virtual python y ejecutar el server (solo si está desactivado)

$ cd ~/Proyectos/d42_proj
$ source ve_py38_django42/bin/activate

Migración inicial (crea una base de datos sqlite3)

(ve_py38_django42)$ cd ~/Proyectos/d42_proj/src
(ve_py38_django42)$ python manage.py migrate

Carga inicial de datos

Crear un super usuario para carga inicial

• Debe reemplazar <<clave>> por su propia clave

(ve_py38_django42)$ echo "from accounts.models import User; User.objects.create_superuser('init', '', '<<clave>>')" | python manage.py shell

• Observación: También se puede crear en forma interactiva con la siguiente instrucción (email es opcional; el usuario de inicio se debe llamar init y puede haber más de un superusuario):

(ve_py38_django42)$ python manage.py createsuperuser

Carga datos para lookup tables. En este caso, para MAC_ADDRESS_TYPES

(ve_py38_django42)$ python manage.py loaddata init_mac_address_types.json

Carga datos para Customers, devices y MAC Address

(ve_py38_django42)$ python manage.py loaddata init_customers.json
(ve_py38_django42)$ python manage.py loaddata init_devices.json
(ve_py38_django42)$ python manage.py loaddata init_mac_addresses.json

Ejecutar el servidor de desarrollo

(ve_py38_django42)$ python manage.py runserver

Por omisión, el server se ejecuta en el puerto 8000 en el local host

http://127.0.0.1:8000/

Para terminar el server, desde la consola python

<CTRL+C>

Desactivar el ambiente virtual python

(ve_py38_django42)$ deactivate

Referencias

Try Django 3.2 - Python Web Development Tutorial Series

CodingEntrepreneurs - Django 3.2 series