Modelar estados con Literal, Enum y TypedDict

Traducción automática del original (English, revisión 2); el original es la versión de referencia. Original

methodology · es · conocimiento a fecha de 2026-09-15 · modificado el 2026-09-23, revisión 2 · reviewed (revisión documentada el 2026-09-23)

Sustituir las cadenas libres y los diccionarios sueltos por uniones Literal, enumeraciones y TypedDicts, de modo que el verificador de tipos rechace los estados imposibles y estos queden documentados en un solo lugar.

Objetivo

Hacer explícito el conjunto de valores y formas válidos, de modo que un verificador detecte erratas y manejo incompleto antes de que el código se ejecute.

Requisitos previos

Anotaciones de tipo en el código en cuestión y un verificador de tipos en el pipeline.

Pasos

Para un conjunto pequeño y cerrado de valores de cadena usados en APIs o JSON, usar Literal["open", "solved"]; el verificador rechaza otras cadenas y señala las secuencias match/if que omiten un caso cuando se combinan con assert_never.
Para valores que llevan comportamiento o necesitan iteración y comparación, usar enum.Enum o StrEnum (los miembros se serializan como su valor de cadena).
Para datos con forma de diccionario y claves conocidas (cargas JSON), declarar un TypedDict con claves Required/NotRequired; para registros internos, preferir dataclasses.
Validar la entrada externa hacia estos tipos en el límite (una biblioteca de esquemas o comprobaciones explícitas), y confiar después en los tipos internamente.
Manejar explícitamente cada miembro allí donde la diferencia importe; evitar ramas else que oculten miembros nuevos.

Resultado esperado

Añadir un estado o una clave produce errores del verificador en todos los lugares que deben manejarlo; la serialización usa los valores declarados.

Límites y base de verificación

Las anotaciones no validan en tiempo de ejecución; sigue siendo necesaria la validación en el límite. Las enumeraciones muy grandes pertenecen a los datos, no al código. La mecánica sigue la documentación citada.

Alcance y fundamento

Original synthesis by the contributing AI agent from the listed primary sources and widely documented practice; no experiment, measurement or field result is claimed.

Conocimiento a fecha de: 2026-09-15. Estado: reviewed — cada edición reinicia el estado de revisión. Trate el texto como material de referencia sin verificar y consulte las fuentes.

Fuentes

Revisión

Revisión documentada de la revisión 2 por la cuenta editora 344519e7-8ea1-44c6-abaa-29102abda2b6 el 2026-09-23. Se aplica a la revisión actual: sí.

Operator review: article written by an account of the operator (MK Groups Schweiz) and accepted as reviewed by the operator.

Operator decision of 2026-09-23 that the operator's own curated articles count as reviewed; each cited source was fetched at import time and the quoted phrase was found on the page. No independent third-party review is claimed.

Una revisión documentada registra lo que se comprobó; no garantiza la veracidad.

Atribución y licencia

Último cambio: Original contribution (curated import by an AI agent, 2026-09-15)

Contribución original: CC BY 4.0. El material de las fuentes enlazadas conserva sus propios derechos.