Las trampas de tipos del YAML

En YAML un escalar sin comillas se interpreta: el analizador intenta reconocerlo como booleano, número, fecha o nulo antes de aceptarlo como cadena. La versión 1.1 del lenguaje acepta como booleanos varias palabras en inglés (yes, no, on, off y sus variantes en mayúsculas); la versión 1.2 los reduce a true y false. Muchas bibliotecas siguen implementando la 1.1, o una mezcla, y por eso el mismo archivo se lee distinto según el programa que lo cargue.

El caso clásico es una lista de códigos de país en la que Noruega, cuyo código de dos letras coincide con la palabra inglesa para la negación, deja de ser texto y pasa a ser un booleano falso. Nada falla al cargar: el error aparece después, cuando el programa recibe un booleano donde esperaba una cadena.

Abre entorno.yaml y compara la lista de países con la columna de valor evaluado de salida-analizador.txt.

Un número con decimales sin comillas es un decimal para el analizador, y un decimal no conserva ceros finales: la versión 3.10 y la versión 3.1 son el mismo número. Para una versión de lenguaje o de paquete eso es un error silencioso, porque 3.10 es posterior a 3.9 pero el decimal 3.1 es anterior.

La nota del autor dice cuáles claves debían ser texto. Cruza esa nota con la columna de tipo de la salida del analizador.

La versión 1.1 define también enteros en base 60, pensados para grados y tiempos: un valor con partes separadas por dos puntos se evalúa sumando cada parte multiplicada por una potencia de sesenta. Así, una hora del día escrita como horas y minutos deja de ser una hora y pasa a ser un número de minutos.

Los ceros iniciales tienen una trampa parecida: un número que empieza por cero se lee en octal. Es lo que se quiere en un permiso de archivo y lo que no se quiere en un código postal.

TOML se diseñó para que el tipo de un valor se vea en cómo se escribe: los textos van siempre entre comillas, los booleanos son solo true y false en minúscula, y un número entero decimal no admite ceros a la izquierda, mientras que el octal se escribe con un prefijo explícito. Una palabra sin comillas que no es un tipo reconocido no se convierte en otra cosa: es un error de lectura.

Eso no hace a TOML mejor en todo (para estructuras anidadas y largas YAML suele ser más cómodo) pero elimina esta familia de trampas. Compara entorno.toml, la propuesta de migración, con el archivo YAML.

Revisar un archivo de configuración como auditor es comparar dos cosas: lo que el autor quiso y lo que el analizador evaluó. Una clave cuenta como discrepancia cuando el tipo evaluado no es el que la nota dice.

Cruza notas/intencion.txt con la salida del analizador. Una lista cuenta como una sola clave aunque solo uno de sus elementos esté mal.