Diccionarios

Los diccionarios mapean claves hasheables a valores arbitrarios con una búsqueda promedio de O(1). Son la herramienta predeterminada para registros, índices, cachés y tablas de despacho en el código de aplicación de Python.

Receta

defaults = {"retries": 3, "timeout": 30}
overrides = {"timeout": 60}
config = defaults | overrides
 
for key in config:
    print(key, config[key])
 
if "retries" not in config:
    config["retries"] = 1

Cuándo usar esto:

• Registros tipo JSON y cargas útiles de API
• Contar y agrupar (a menudo con Counter)
• Cachés de memorización indexadas por argumentos
• Tablas de despacho de cadenas a manejadores

Ejemplo de Trabajo

from collections.abc import Callable
 
Handler = Callable[[dict], str]
 
def dispatch(handlers: dict[str, Handler], event: dict) -> str:
    kind = str(event.get("type", "unknown"))
    handler = handlers.get(kind, handlers["unknown"])
    return handler(event)
 
def merge_records(base: dict[str, object], patch: dict[str, object]) -> dict[str, object]:
    merged = base.copy()
    merged.update(patch)
    return merged
 
def invert_unique(mapping: dict[str, int]) -> dict[int, str]:
    return {value: key for key, value in mapping.items()}
 
if __name__ == "__main__":
    handlers: dict[str, Handler] = {
        "user.created": lambda e: f"create {e['id']}",
        "unknown": lambda e: "noop",
    }
    print(dispatch(handlers, {"type": "user.created", "id": 42}))
    print(merge_records({"a": 1}, {"b": 2}))

Lo que esto demuestra:

• handlers.get(kind, default) evita KeyError para eventos desconocidos
• dict.copy + update fusiona registros superficialmente
• La comprensión de diccionario invierte el mapeo cuando los valores son únicos
• Los valores Callable convierten los diccionarios en tablas de despacho

Inmersión Profunda

Cómo Funciona

• Tabla hash - Las claves se hashean en cubetas; el direccionamiento abierto resuelve colisiones.
• Orden de inserción - El orden de iteración coincide con el orden de inserción (la reinserción mueve la clave al final en CPython 3.7+ solo para inserciones nuevas).
• Vistas - keys(), values(), items() son vistas dinámicas, no instantáneas.
• Igualdad - Dos diccionarios son iguales si tienen los mismos pares clave-valor independientemente del orden.
• fromkeys - dict.fromkeys(keys, default) crea un diccionario con precaución por el valor predeterminado compartido.

Opciones de Fusión

Notas de Python

# setdefault solo cuando falta
counts: dict[str, int] = {}
counts.setdefault("a", 0)
counts["a"] += 1
 
# pop con valor predeterminado
value = config.pop("missing", None)

Trampas

• Valores mutables compartidos a través de fromkeys - dict.fromkeys(keys, []) comparte una lista. Solución: Comprensión con un objeto mutable nuevo.
• Iterar claves y luego eliminar - RuntimeError si el tamaño cambia durante la iteración. Solución: Usar list(d) para crear una instantánea primero.
• Usar float NaN como clave - NaN != NaN rompe las suposiciones de unicidad. Solución: Evitar o normalizar.
• Memoria de dict grande - Se almacena cada objeto clave. Solución: Considerar una base de datos, un índice en disco o objetos __slots__ para registros.
• Confiar en el orden para pruebas de igualdad - El orden difiere entre construcciones. Solución: Comparar como diccionarios, no como listas de claves.

Alternativas

Preguntas Frecuentes

Relacionado

• Sets y Frozensets - operaciones de unicidad complementarias
• Módulo collections - defaultdict, Counter
• Inmutabilidad y Hashabilidad - claves válidas
• TypedDict y NamedTuple - registros tipados

Versiones de la pila: Esta página fue escrita para Python 3.14.0 (estable 3.14, mantenimiento 3.13), FastAPI 0.115+, Django 5.2, Flask 3.1, Pydantic 2, PyTorch 2.6+, pandas 2.2+, Polars 1.x, ruff 0.9+, y uv 0.6+.