Livres
TypeScript
Chapitre 10. Formats de données et sérialisation
Travailler avec TOML

TypeScript:
Travailler avec TOML

Comment faire :

Tout d’abord, vous aurez besoin d’un analyseur TOML. @iarna/toml est un choix populaire. Installez-le avec npm : npm install @iarna/toml --save. Voici comment lire un fichier TOML et le parser en un objet JavaScript :

import * as fs from 'fs';
import toml from '@iarna/toml';

const contenuToml = fs.readFileSync('config.toml', 'utf-8');
const donneesParsees = toml.parse(contenuToml);

console.log(donneesParsees);

Si config.toml contient :

[server]
port = 8080

Le résultat sera :

{ server: { port: 8080 } }

Et, écrire dans un fichier TOML est tout aussi simple :

import * as fs from 'fs';
import { stringify } from '@iarna/toml';

const obj = { server: { port: 8080 } };
const chaineToml = stringify(obj);
fs.writeFileSync('config.toml', chaineToml);

Exécuter ce code écrit l’objet dans config.toml au format TOML.

Plongée Profonde

TOML a été créé par Tom Preston-Werner, co-fondateur de GitHub, vers 2013 en réponse aux limitations qu’il percevait dans d’autres formats comme INI ou YAML. Il est conçu pour être sans ambiguïté et facile à parser en structures de données, donc un favori pour les fichiers de configuration. Des alternatives comme JSON manquent de commentaires, tandis que YAML est plus complexe. TOML brille par sa simplicité et sa capacité à représenter clairement des hiérarchies de données complexes.

Sous le capot, lorsque vous parsez TOML en TypeScript, vous convertissez des données textuelles en un format structuré que le langage peut manipuler. Cela implique le lexing (transformation du texte brut en jetons) et le parsing (construction d’une structure de données interne) ; @iarna/toml gère les deux de manière transparente. Le support des emoji est une touche amusante, montrant l’approche centrée sur l’utilisateur de TOML.

Voir également

Travailler avec JSONTravailler avec XML