Formateador de TOML
Formatee archivos de configuración TOML, como Cargo.toml, pyproject.toml y otros ajustes de aplicaciones con el complemento Prettier TOML. El formateador normaliza los espacios alrededor de los signos igual, las tablas en línea y las matrices; separa las tablas con una línea en blanco, conserva todos los comentarios e indica los errores de sintaxis con su línea y columna, para que los desarrolladores puedan ordenar la configuración de forma segura antes de confirmarla.
Preguntas frecuentes
¿Qué motor formatea TOML?
La herramienta usa Prettier 3 con prettier-plugin-toml 4.1 en el servidor. Lee documentos TOML 1.0 y los imprime con un estilo uniforme.
¿Qué cambia en el resultado?
Las claves y los valores quedan separados por un espacio a cada lado del signo igual, y las tablas en línea y las matrices tienen un espaciado uniforme. Se reducen las líneas en blanco adicionales y cada encabezado de tabla se separa de la sección anterior con una línea en blanco.
¿Se conservan los comentarios?
Sí. Los comentarios en líneas completas y los comentarios al final de línea que siguen a los valores permanecen en su sitio, de modo que los archivos de configuración anotados conservan sus notas.
¿Se ordenarán las claves o las tablas?
No. Las claves, las tablas y las matrices de tablas conservan su orden original, algo importante para los archivos que se leen de principio a fin.
¿Pueden cambiar las comillas de las cadenas?
Las cadenas literales entre comillas simples pueden reescribirse con comillas dobles cuando el valor no contiene barras invertidas ni comillas dobles; así, el valor se mantiene igual. Las cadenas que necesitan comillas literales conservan las comillas simples.
¿Cómo se gestionan las matrices largas?
Las matrices que caben en el ancho de línea permanecen en una sola línea. Las matrices con una coma final o que superan ese ancho se imprimen con un elemento por línea.
¿Qué ocurre con TOML no válido?
El formateo se detiene y la herramienta muestra el mensaje del analizador con la línea y la columna, por ejemplo, si falta un valor después de un signo igual. Las claves duplicadas y otros TOML no válidos se notifican de la misma manera.
¿Puedo cambiar la indentación?
Sí. Elija 2 o 4 espacios o tabuladores para las matrices anidadas, y un ancho de línea entre 40 y 200 caracteres; el valor predeterminado es 80.
¿Qué tamaño puede tener el archivo?
Hasta 1 MB de texto por solicitud, mucho más que el tamaño habitual de los archivos de configuración. El formateo se detiene después de 10 segundos.
¿Se almacena mi configuración?
No. Los archivos de configuración pueden contener secretos, por lo que el contenido se procesa solo en memoria y nunca se guarda ni se registra.