---
name: http_download_file
kind: function
lang: py
domain: infra
version: "1.0.0"
purity: impure
signature: "http_download_file(url: str, dest_path: str, headers: dict[str, str] | None = None, timeout: float = 120.0, chunk_size: int = 8192) -> dict"
description: "Descarga un archivo por HTTP en streaming (sin cargar todo en memoria). Crea directorios intermedios si no existen. Retorna dict con path, size_bytes y content_type."
tags: [http, download, file, streaming, network, stdlib, infra]
uses_functions: []
uses_types: []
returns: []
returns_optional: false
error_type: "error_go_core"
imports: ["os", "urllib.error", "urllib.request"]
params:
  - name: url
    desc: "URL del archivo a descargar"
  - name: dest_path
    desc: "ruta destino donde guardar el archivo descargado"
  - name: headers
    desc: "diccionario opcional de headers HTTP personalizados"
  - name: timeout
    desc: "timeout en segundos para la descarga (defecto 120.0)"
  - name: chunk_size
    desc: "tamaño en bytes de cada chunk descargado (defecto 8192)"
output: "diccionario con keys path, size_bytes y content_type"
tested: true
tests:
  - "mock de descarga con contenido binario"
  - "directorio destino creado automaticamente"
  - "retorno con size correcto"
  - "timeout configurado en el request"
test_file_path: "python/functions/infra/http_download_file_test.py"
file_path: "python/functions/infra/http_download_file.py"
---

## Ejemplo

```python
result = http_download_file(
    "https://example.com/report.pdf",
    dest_path="/tmp/reports/report.pdf",
    timeout=60.0,
)
print(f"Downloaded {result['size_bytes']} bytes to {result['path']}")
```

## Notas

Solo usa stdlib (urllib, os). La descarga se hace en chunks de `chunk_size` bytes para evitar consumo de memoria con archivos grandes. El timeout de 120s por defecto es mayor que http_get_json porque los archivos pueden ser pesados. Los directorios intermedios se crean con os.makedirs(exist_ok=True).
