La respuesta corta
- TOML es un formato de configuración de texto que asigna claves y valores sin ambigüedad a una tabla hash, con nombres que distinguen mayúsculas y minúsculas y codificación UTF-8 válida obligatoria.
- Abre el archivo con un editor de texto. En Windows, usa Abrir; en Mac, elige el modo de texto sin formato; en el móvil, utiliza una aplicación capaz de abrir texto UTF-8. Conserva esa codificación al guardar. Ver el texto no valida la sintaxis. Python permite analizarlo con tomllib.load() o tomllib.loads(); los documentos inválidos producen TOMLDecodeError.
- El registro de IANA indica que TOML no contiene contenido ejecutable. Aun así, una entrada maliciosa puede consumir mucha CPU y memoria al analizarse. Limita el tamaño de los datos antes de procesarlos. Una lectura correcta no demuestra que el contenido sea fiable.
Archivos TOML: abrir, editar y convertir configuraciones
TOML significa Tom's Obvious, Minimal Language. Utiliza key = value y admite cadenas, enteros, números de coma flotante, booleanos, fechas y horas, arrays, tablas y arrays de tablas. Los comentarios empiezan por #. Su tipo de medio registrado es application/toml, su extensión es .toml y no tiene bytes mágicos fijos.
tomllib convierte TOML en diccionarios de Python, pero no escribe TOML. Para editar archivos existentes conservando el estilo, la documentación de Python recomienda TOML Kit. Pasar por un diccionario no garantiza conservar comentarios ni formato. La conversión de números de coma flotante puede redondear valores; parse_float permite elegir decimal.Decimal.
Cómo abrirlo
Abre el archivo con un editor de texto. En Windows, usa Abrir; en Mac, elige el modo de texto sin formato; en el móvil, utiliza una aplicación capaz de abrir texto UTF-8. Conserva esa codificación al guardar. Ver el texto no valida la sintaxis. Python permite analizarlo con tomllib.load() o tomllib.loads(); los documentos inválidos producen TOMLDecodeError.
Abre el archivo con un editor de texto. En Windows, usa Abrir; en Mac, elige el modo de texto sin formato; en el móvil, utiliza una aplicación capaz de abrir texto UTF-8. Conserva esa codificación al guardar. Ver el texto no valida la sintaxis. Python permite analizarlo con tomllib.load() o tomllib.loads(); los documentos inválidos producen TOMLDecodeError.
tomllib convierte TOML en diccionarios de Python, pero no escribe TOML. Para editar archivos existentes conservando el estilo, la documentación de Python recomienda TOML Kit. Pasar por un diccionario no garantiza conservar comentarios ni formato. La conversión de números de coma flotante puede redondear valores; parse_float permite elegir decimal.Decimal.
Seguridad
El registro de IANA indica que TOML no contiene contenido ejecutable. Aun así, una entrada maliciosa puede consumir mucha CPU y memoria al analizarse. Limita el tamaño de los datos antes de procesarlos. Una lectura correcta no demuestra que el contenido sea fiable.
Un remitente desconocido, un nombre que acaba en dos extensiones o un contenido que no cuadra con la extensión: compruébalo antes de abrirlo.
Cómo convertirlo
tomllib convierte TOML en diccionarios de Python, pero no escribe TOML. Para editar archivos existentes conservando el estilo, la documentación de Python recomienda TOML Kit. Pasar por un diccionario no garantiza conservar comentarios ni formato. La conversión de números de coma flotante puede redondear valores; parse_float permite elegir decimal.Decimal.
Convierte una copia, nunca el original, y después compara calidad, metadatos y maquetación con el archivo de partida.
Preguntas frecuentes
¿Qué es un archivo TOML y para qué sirve?
Es un archivo de configuración de texto con asignaciones key = value que se corresponden sin ambigüedad con una tabla hash. Distingue mayúsculas y minúsculas y requiere UTF-8 válido.
¿Cómo abrir un archivo TOML en Windows?
Abre un editor de texto y selecciona el archivo .toml mediante Abrir. Si el filtro lo oculta, selecciona todos los archivos. Guarda los cambios en UTF-8.
¿Cómo editar un archivo TOML en Mac?
Ábrelo en un editor en modo de texto sin formato. Conserva la sintaxis key = value y guarda el archivo como texto UTF-8 con extensión .toml.
¿Cómo abrir un archivo TOML en el móvil?
Selecciona el archivo en una aplicación de texto que admita UTF-8. El acceso a archivos y las opciones de edición dependen de la aplicación. Poder leerlo no confirma que su sintaxis sea válida.
¿Por qué aparece TOMLDecodeError al leer un archivo TOML?
Python genera ese error ante un documento TOML inválido. Revisa asignaciones, comillas, declaraciones de tablas y codificación UTF-8. Comprueba también la versión: tomllib apareció en Python 3.11 con TOML 1.0.0; Python 3.15 añade TOML 1.1.0.
¿Conviene usar un editor de texto o un analizador de Python para TOML?
Usa un editor para leer o cambiar el texto. Usa tomllib para obtener un diccionario y detectar TOML inválido. tomllib solo lee: no escribe archivos ni conserva un diseño de texto editable.
¿Cómo convertir TOML sin perder comentarios ni formato?
Convertirlo primero en un diccionario no garantiza conservar el estilo original. La documentación de Python recomienda TOML Kit para editar con conservación del estilo y capacidad de lectura y escritura. Comprueba los comentarios y el formato del resultado.
¿Qué riesgos tiene analizar un archivo TOML no fiable?
Aunque IANA indica que TOML no contiene contenido ejecutable, una entrada maliciosa puede consumir mucha CPU y memoria. Limita el tamaño antes de analizarla; aquí no se establece un tamaño universalmente seguro.
¿Puede cambiar la precisión de los números de coma flotante en TOML?
Sí. TOML recomienda al menos IEEE 754 binary64; los valores con más de 15 cifras decimales significativas pueden redondearse. En tomllib, parse_float=decimal.Decimal permite usar aritmética decimal para esos valores.
¿Cómo leer archivos TOML con Python?
Usa tomllib.load() con un archivo abierto en modo binario o tomllib.loads() con una cadena. Ambos devuelven un diccionario. El módulo está en la biblioteca estándar desde Python 3.11 y solo permite lectura.
¿Que un archivo TOML se analice correctamente demuestra que es fiable?
No. Solo demuestra que el analizador aceptó el documento. No verifica su procedencia, la exactitud de los valores ni que la configuración sea adecuada para su uso.
Formatos relacionados
Fuentes
TOML v1.1.0 官方规范 · TOML 官方项目
application/toml 媒体类型登记 · IANA
tomllib — Parse TOML files · Python 官方文档
Tom's Obvious, Minimal Language · 美国国会图书馆