Faragiri

Aprender Python en la web Python

Quince líneas sin dependencias que responden una petición real, las cuatro cosas que agrega un framework, y lo que decide entre Django y el resto.

4Secciones
4Minutos
4Profundidad

Reduzca una aplicación web de Python a lo mínimo y es una función que recibe un diccionario y devuelve bytes. Esta no tiene ningún import fuera de la biblioteca estándar y responde dos peticiones de un inventario de repuestos correctamente:

  • GET /existencia?codigo=RB-09 da 200 OK, {'Content-Type': 'application/json', 'Content-Length': '29'} y un cuerpo de {"codigo": "RB-09", "hay": 3}
  • GET /noexiste da 404 Not Found y ninguna ruta así

La función recibe environ, un diccionario con PATH_INFO y QUERY_STRING entre otras treinta llaves aproximadamente, y llama a start_response(status, headers) antes de devolver un iterable de bytes. Ese contrato es WSGI, no ha cambiado desde 2003, y cada framework síncrono de Python que se haya usado es, en el fondo, un programa que termina llamando a algo con esta forma.

Las cuatro cosas que un framework agrega de verdad

Enrutamiento, para que /existencia/RB-09 llegue a una función con RB-09 como argumento y no como una cadena que hay que cortar a mano. Interpretación, para que un cuerpo de formulario o un JSON llegue como un diccionario con el tipo de contenido ya revisado. Plantillas o serialización, para que la respuesta se construya en vez de concatenarse, que es también donde vive el escape que evita un error de scripting entre sitios. Y una ruta de error, para que una excepción se vuelva un 500 con la traza en el registro y no una conexión que simplemente se cierra.

Capas de abstracción

Las cuatro funciones esenciales de un framework

Alrededor del contrato de entrada y salida, el framework construye mecanismos para no manipular texto manualmente.

  1. Núcleo WSGI / ASGIEnrutamientoEntrega la ruta solicitada a una función con argumentos ya extraídos
  2. 02InterpretaciónConvierte cargas útiles JSON o formularios en diccionarios validados
  3. 03Serialización y plantillasConstruye la respuesta aplicando escape para prevenir vulnerabilidades web
  4. 04Gestión de excepcionesCaptura fallas para devolver un código 500 con registro en vez de cortar la conexión
  5. 05Servicios opcionales adicionalesMapeador objeto-relacional, panel de control, migraciones y sesiones de usuario

La decisión del framework depende de si se requiere la capa externa integrada o solo los mecanismos centrales.

Todo lo demás que ofrece un framework es opcional, y la mayor parte es la quinta cosa: un mapeador objeto-relacional, un panel de administración, un sistema de migraciones, usuarios y sesiones. Esa es la división que de verdad importa, porque es la que decide qué framework y no una preferencia de sintaxis.

Elegir, sobre el único eje que importa

Django trae la capa de base de datos, el panel de administración y el sistema de autenticación como una sola decisión, así que un proyecto que necesita usuarios, un esquema que va a cambiar, y una pantalla para que el personal edite filas empieza tres semanas adelantado. Flask y FastAPI traen las primeras cuatro cosas y dejan la quinta para quien programa, que es lo correcto cuando los datos ya viven en otro lado o cuando el servicio le responde a otros programas y no a personas.

Criterio de selección

El único eje que decide qué framework utilizar

La elección no es por sintaxis sino por si los datos y usuarios ya existen o deben construirse desde cero.

¿El proyecto necesita base de datos propia, usuarios y panel administrativo?
  • Requiere ORM, panel de gestión interna y autenticación integrada
    Django como solución completaInicia con semanas de ventaja al incluir pantallas de administración y modelos integrados
    • Panel listo para que el personal edite registros
    • Autenticación, permisos y migraciones resueltos de fábrica
  • Es una API para otros programas o consume datos ya existentes
    FastAPI o Flask como base desacopladaFastAPI genera documentación y validación desde la firma; Flask otorga libertad estructural
    • Especificación y validación automática de parámetros
    • Integración directa con servicios y bases de datos externas

Django integra la capa de persistencia y administración en una sola decisión; Flask y FastAPI la dejan abierta.

El aporte propio de FastAPI es que la firma de la función es la especificación: se anotan los parámetros y valida la petición y genera la documentación de la API a partir de las mismas líneas. Eso es trabajo genuinamente nuevo y no una sintaxis distinta, y por eso la elección entre FastAPI y Flask no es arbitraria.

Qué correr en 2026

ASGI es la interfaz sobre la que conviene construir ahora, gratis y el estándar, y reemplazó a WSGI para cualquier cosa que mantenga una conexión abierta: el contrato de WSGI tiene una petición de entrada y una respuesta de salida, sin lugar para un websocket o un long poll. Las quince líneas de arriba son WSGI porque es lo más chico de leer, y la versión ASGI tiene la misma forma con async y un canal de recepción.

Servidor y protocolo en 2026

La tríada que procesa peticiones en producción

El servidor de ejecución y el framework son programas independientes coordinados por el estándar ASGI.

  • uvicorn gestiona el tráfico entrante y lo entrega mediante eventos ASGI
  • ASGI comunica la especificación asíncrona con el framework elegido
  • La aplicación retorna encabezados y bytes al servidor para responder al cliente
  • Servidor uvicorn
  • Especificación ASGI
  • Aplicación web
  • Servidor uvicornAtiende conexiones de red en producción separando el servidor del código de aplicación
  • Especificación ASGIEstándar asíncrono que reemplazó a WSGI permitiendo conexiones abiertas y canales
  • Aplicación webFramework como Django o FastAPI que procesa la lógica de negocio y retorna datos

Comprender la separación entre servidor y aplicación permite saber a cuál de los dos pertenece un error en el registro.

uvicorn es lo que lo ejecuta, gratis y de código abierto, y desde 2026 es la respuesta habitual para Django, FastAPI y cualquier otra cosa ASGI. Reemplazó correr el servidor de desarrollo propio del framework en producción, que cada framework advierte no hacer en la página que casi nadie lee. Lo que conviene entender en vez de memorizar es que el servidor y el framework son programas separados, por lo que la traza en el registro a veces pertenece a uno y a veces al otro.

Dónde se traba la gente aquí

El tropiezo es aprender un framework como un conjunto de decoradores, así que su magia queda opaca y cada requisito fuera de lo común se vuelve una búsqueda del conjuro exacto. Nada de lo de arriba es magia: una petición es un diccionario, una respuesta es un estado, unos encabezados y bytes, y una ruta es una búsqueda de una dirección a una función. Alguien con ese modelo puede leer el código fuente del framework cuando la documentación se acaba, que es lo que siempre necesita el requisito fuera de lo común.

Quince líneas, un GET

Qué pasa entre la ruta y los bytes

Cada parada de aquí es una línea del ejemplo, y un framework reemplaza cuatro de las seis con algo que se configura en vez de escribirse.

  1. El servidor arma environPATH_INFO, QUERY_STRING y unas treinta llaves más
  2. Se llama a la funciónUn argumento de entrada, y una función de retorno para responder
  3. Se compara la rutaUn if aquí, una tabla de enrutamiento en un framework
  4. Se interpreta la consultaparse_qs, y cada valor llega como una lista
  5. Se llama a start_response200 OK, y los encabezados, antes de que exista ningún cuerpo
  6. Se devuelven los bytesUn iterable, así que una respuesta grande no tiene que armarse entera

Nada de este riel toca una base de datos, una plantilla o una sesión, y ninguna de esas tres es parte del contrato. Por eso elegir framework es en realidad elegir sobre la quinta cosa y no sobre este riel.

El ejercicio que vale la pena hacer una vez: escribir las quince líneas, agregarles enrutamiento, y parar ahí. Veinte minutos, y cada decorador después de eso es reconocible como algo que ya se construyó a mano.

Cómo se guardan esos datos de existencia una vez que llegan está en datos desde el código, qué pasa antes de que el diccionario environ exista siquiera está en cómo responde un servidor, y en qué entorno se instala todo esto está en paquetes y entornos.

Al lado de esto

Arriba de esto