Migración de Request síncrono a HTTPX asíncrono en Python

Curso de Python Avanzado para Arquitectura de Proyectos y PyPI

Contenido del curso

Calidad de Código: Automatización y Validación

Rendimiento medición de velocidad y memoria

Programación concurrente con asyncio

Distribución y empaquetamiento

Tomar examen

Cursos Empresas Blog Live Conf Eventos Precios

0:0012:57

Migración de Request síncrono a HTTPX asíncrono en Python

Curso de Python Avanzado para Arquitectura de Proyectos y PyPI

Clase 15 de 17

Clase 15 / 17

Comentarios (5)5 comentarios

Pablo Hurtado

Hace un año

Debería hacer un curso detallado del uso de Async y Await en Python

Luis Martinez

Profesor

Hace un año

Sí, este curso sería muy lindo tenerlo, hay muchos conceptos alrededor de async por aprender!

En el home hay una sección donde puedes pedir cursos, sería cool que lo pidas!

Daniel Marí Estrada

Hace un año

podemos profundizar en la página oficial

Rodrigo Martinez

Hace 10 meses•editado

asyncio y httpx se enfocan en concurrencia de I/O sin threads ni locks. La clase explica cómo la asincronía permite ejecutar tareas concurrentemente sin bloquear el hilo principal, reduciendo el tiempo de respuesta. Si necesitas paralelismo real (CPU-bound), sí usarías threads.

Fabian Ezequiel Falón

Hace un año

Hay que tener ciertas cosas en cuenta al desplegar en prod una app que tiene llamadas asíncronas?

Luis Martinez

Profesor

Hace un año

Sí, si es web siempre toca usar asgi porque si no no va a correr.

Gabriel Obregón

Hace un año

🎨Migración a HTTPX + AsyncIO

🚀 1. El Gran Cambio

De → A

🟦 Requests (síncrono)

➡️

🟩 HTTPX + AsyncIO (asíncrono y concurrente)

¿Por qué importa?

✨ Hasta 50% menos tiempo de respuesta ✨ Concurrencia real ✨ Sin romper nada: conviven métodos síncronos y asíncronos

⚡ 2. Qué cambia técnicamente

🕗 Antes

🔸 Ejecución bloqueante

🔸 Cada request espera a la anterior

🔸 Menor aprovechamiento del I/O

⚡ Ahora

🔹 Varias solicitudes al mismo tiempo

🔹 Métodos asíncronos con prefijo A

🔹 Migración progresiva, sin apagar lo existente

Idea visual

🎯 Menos espera + Más paralelismo + Misma compatibilidad

📦 3. Instalación rápida de HTTPX

🛠️ Instalar: pip install httpx ó uv add httpx

🔍 Verificar: Revisar dependencias en pyproject.toml.

📌 Motivo: HTTPX funciona de forma nativa con AsyncIO.

🧱 4. Creación del nuevo protocolo asíncrono

Para cada método existente:

1️⃣ Copia el método síncrono

2️⃣ Renómbralo con prefijo A

3️⃣ Usa async def

4️⃣ Mantén la misma estructura y tipos

5️⃣ Retorna el mismo formato de artículos

🎨 Espejo perfecto: misma firma → versión async.

📰 5. Implementación por fuente

🟦 Guardian

Acciones:

Mover logger arriba
Importar HTTPX
Crear método afetch_articles
Usar async with httpx.AsyncClient()

Fragmento visual:

async def afetch_articles(params):

async with httpx.AsyncClient() as client:

response = await client.get("https://api.guardian...", params=params)

return [...]

🟧 News API

🔁 Igual que Guardian 🎯 Ajustar mapeo de campos (nombres distintos)

🧠 6. Ajuste del Servicio + CLI

🟩 Servicio (core/services)

🧩 Se añaden pares de métodos:

search_articles → search síncrono

a_search_articles → search asíncrono

📌 Lógica:

Obtener la fuente con el método actual
Llamar a afetch_articles con await si es async

🖥️ CLI

Crear dos entradas:

🔹 async_main Usa await.

🔹 main Ejecuta la corrutina para mantener compatibilidad.

def main():

import asyncio

asyncio.run(async_main())

⭐ Regla clave: await solo dentro de funciones async.

🔙 7. Superpoder de compatibilidad

✔ Métodos síncronos siguen intactos

✔ Migración por módulos

✔ Tests siguen válidos

✔ Quien quiera usar síncrono, lo usa

✔ Producción puede usar async sin riesgos

Jarod Fernando Fernandez Morales

Hace 5 meses

Refactor a AsyncIO

Instalar httpx con uv add httpx
Agregar método async al protocolo NewsSource
Implementar afetchArticles con httpx en fuentes
Crear método asearchArticles en el servicio
Envolver main con asyncio.run()

Recursos

Adopta un flujo asíncrono en Python con confianza: en Platzi News se migra de Request síncrono a HTTPX con AsyncIO para ejecutar llamadas concurrentes a The Guardian y News API, logrando reducir el tiempo de respuesta ~50% y mantener la compatibilidad hacia atrás gracias a un enfoque de dual approach.

¿Qué cambia con HTTPX y AsyncIO?

La ejecución deja de ser bloqueante. Antes, cada petición HTTP esperaba a la anterior. Con AsyncIO y HTTPX se disparan varias solicitudes de forma concurrente, aprovechando mejor el I/O de red y acelerando la obtención de artículos. Se preservan los métodos síncronos existentes y se agregan equivalentes asíncronos con prefijo “A” para distinguirlos y facilitar una migración gradual.

Concurrencia real en I/O: múltiples requests al mismo tiempo.
Prefijo “A” en métodos asíncronos para claridad y consistencia.
Dual approach: síncrono y asíncrono conviven sin romper usos previos.
Menos tiempo total: respuesta más rápida, aprox. 50%.

¿Cómo se instala HTTPX?

Se elige HTTPX por su compatibilidad con AsyncIO.
Instalación directa: ejecutar en la terminal: V add HTTPX.
Verificación: aparece en dependencias de pyproject.toml.

¿Cómo se define el nuevo protocolo asíncrono?

En el módulo source se tiene un protocolo con el método síncrono existente (ej.: fetch...).
Se agrega el nuevo método asíncrono con prefijo “A” y misma firma y documentación.
Se usa async def y se mantiene el tipado para retornar la misma estructura de artículos.

¿Cómo se implementa en Guardian y News API?

En guardian.py se crea el método asíncrono con async def y prefijo “A”.
Se mueve el logger a la parte superior del archivo para reutilizarlo.
Se importa httpx y se usa un cliente asíncrono con contexto.

import httpx

async def afetch_articles(params):
    # logger definido arriba
    async with httpx.AsyncClient() as client:
        response = await client.get("https://api.guardian...", params=params)
    data = response.json()
    # Adaptar a la estructura de artículos esperada
    return [ ... ]

En News API se repite el refactor: mover logger, importar httpx, crear el método con prefijo “A”, usar await y ajustar el mapeo de campos porque los nombres difieren respecto a Guardian.

¿Cómo se adapta el servicio y la CLI?

El servicio en core/services agrega un método asíncrono gemelo del síncrono (misma responsabilidad, prefijo “A”). Internamente, obtiene la fuente con el método actual (sigue siendo síncrono) y llama al nuevo método asíncrono de la fuente con await. Se toca el mínimo de funciones para no afectar otras features ni tests.

class NewsService:
    def search_articles(self, ...):
        source = self.get_source(...)
        return source.fetch_articles(...)

    async def a_search_articles(self, ...):
        source = self.get_source(...)
        return await source.afetch_articles(...)

Regla de oro: await solo dentro de funciones async. Por eso, al actualizar el uso desde la CLI, la función que invoca el nuevo método se vuelve async.
Se renombra el main asíncrono y se crea un wrapper síncrono que ejecuta la corrutina con asyncio.run, manteniendo la compatibilidad del punto de entrada.

async def async_main():
    # await service.a_search_articles(...)
    ...

def main():
    import asyncio
    asyncio.run(async_main())

¿Cómo mantener compatibilidad hacia atrás?

Compatibilidad: el código existente sigue funcionando con métodos síncronos.
Migración gradual: módulo por módulo, sin pausas grandes.
Flexibilidad: scripts simples usan síncrono; producción usa asíncrono.
Testing: los tests no se rompen al conservar los métodos previos.

¿Cómo verificar que HTTPX está en uso?

La validación práctica incluye ejecutar la búsqueda y luego activar los logs en modo debug para confirmar que HTTPX realiza los requests.

Ejecutar búsqueda: Platinus search con término y source News API. Muestra artículos correctamente.
Confirmar HTTPX: PlatzyNews con log level debug para ver los mensajes info/DEBUG de HTTPX indicando requests exitosos.

En conjunto, se logra un refactor sólido: métodos asíncronos con async def, uso de async with httpx.AsyncClient(), llamados con await, logger centralizado y un wrapper con asyncio.run que garantiza compatibilidad. ¿Te animas al reto final? Agrega nuevas funcionalidades asíncronas en el servicio aplicando el mismo patrón.

¿Tienes dudas sobre la migración o quieres compartir tu experiencia con AsyncIO y HTTPX? Deja tu comentario y conversemos.

Resumen

¿Qué cambia con HTTPX y AsyncIO?

Concurrencia real en I/O: múltiples requests al mismo tiempo.
Prefijo “A” en métodos asíncronos para claridad y consistencia.
Dual approach: síncrono y asíncrono conviven sin romper usos previos.
Menos tiempo total: respuesta más rápida, aprox. 50%.

¿Cómo se instala HTTPX?

Se elige HTTPX por su compatibilidad con AsyncIO.
Instalación directa: ejecutar en la terminal: V add HTTPX.
Verificación: aparece en dependencias de pyproject.toml.

¿Cómo se define el nuevo protocolo asíncrono?

En el módulo source se tiene un protocolo con el método síncrono existente (ej.: fetch...).
Se agrega el nuevo método asíncrono con prefijo “A” y misma firma y documentación.
Se usa async def y se mantiene el tipado para retornar la misma estructura de artículos.

¿Cómo se implementa en Guardian y News API?

En guardian.py se crea el método asíncrono con async def y prefijo “A”.
Se mueve el logger a la parte superior del archivo para reutilizarlo.
Se importa httpx y se usa un cliente asíncrono con contexto.

import httpx

async def afetch_articles(params):
    # logger definido arriba
    async with httpx.AsyncClient() as client:
        response = await client.get("https://api.guardian...", params=params)
    data = response.json()
    # Adaptar a la estructura de artículos esperada
    return [ ... ]

En News API se repite el refactor: mover logger, importar httpx, crear el método con prefijo “A”, usar await y ajustar el mapeo de campos porque los nombres difieren respecto a Guardian.

¿Cómo se adapta el servicio y la CLI?

class NewsService:
    def search_articles(self, ...):
        source = self.get_source(...)
        return source.fetch_articles(...)

    async def a_search_articles(self, ...):
        source = self.get_source(...)
        return await source.afetch_articles(...)

Regla de oro: await solo dentro de funciones async. Por eso, al actualizar el uso desde la CLI, la función que invoca el nuevo método se vuelve async.
Se renombra el main asíncrono y se crea un wrapper síncrono que ejecuta la corrutina con asyncio.run, manteniendo la compatibilidad del punto de entrada.

async def async_main():
    # await service.a_search_articles(...)
    ...

def main():
    import asyncio
    asyncio.run(async_main())

¿Cómo mantener compatibilidad hacia atrás?

Compatibilidad: el código existente sigue funcionando con métodos síncronos.
Migración gradual: módulo por módulo, sin pausas grandes.
Flexibilidad: scripts simples usan síncrono; producción usa asíncrono.
Testing: los tests no se rompen al conservar los métodos previos.

¿Cómo verificar que HTTPX está en uso?

La validación práctica incluye ejecutar la búsqueda y luego activar los logs en modo debug para confirmar que HTTPX realiza los requests.

Ejecutar búsqueda: Platinus search con término y source News API. Muestra artículos correctamente.
Confirmar HTTPX: PlatzyNews con log level debug para ver los mensajes info/DEBUG de HTTPX indicando requests exitosos.

¿Tienes dudas sobre la migración o quieres compartir tu experiencia con AsyncIO y HTTPX? Deja tu comentario y conversemos.

Calidad de Código: Automatización y Validación

Python That Lasts in Production

Configuración inicial del proyecto Platy News con Python

Ruff: Formatea automáticamente código Python con facilidad

Fixing Real Type Errors With MyPy

Ruff Linter: Catch Python Bugs Before Runtime

Configuración de pre-commit con Ruff y MyPy para validar código

Ejecución paralela de pruebas unitarias con pytest y coverage

Configuración de GitHub Actions para CI/CD con Python

Configuración de logging y Sentry para monitoreo en producción

Rendimiento medición de velocidad y memoria

Medición de rendimiento de código con Timeit en Python

Análisis de rendimiento en Python con cProfile y Snakeviz

Programación concurrente con asyncio

Programación asíncrona en Python con AsyncIO para operaciones I/O

Sintaxis async y await en Python para concurrencia eficiente

How asyncio's Event Loop Schedules Tasks

Migración de Request síncrono a HTTPX asíncrono en Python

Distribución y empaquetamiento

Automate Dev Tasks with Make Targets

Publicación de paquetes Python con UV y TestPyPI

Migración de Request síncrono a HTTPX asíncrono en Python

Progreso del curso

Calidad de Código: Automatización y Validación

Rendimiento medición de velocidad y memoria

Programación concurrente con asyncio

Distribución y empaquetamiento

Recursos

Recursos