toml

toml lit et modifie le sous-ensemble TOML courant : tables, clés pointées, valeurs scalaires et listes simples. Validation et écriture s’effectuent directement dans le fichier choisi.

DonnéesVersion 1.1.6Stable
lil-terminal

Vue d’ensemble

toml travaille directement sur les configurations TOML courantes : lecture par chemins pointés, recherche par clé ou valeur, modification atomique d’un réglage, validation du sous-ensemble pris en charge et source normalisée complète.

Les tables deviennent des chemins pointés

Une table [database] avec host se cible par database.host. Le parseur vise les configurations courantes d’hébergement ; les constructions TOML complexes se traitent mieux comme du texte.

Syntaxe

lil-terminal
toml <file> [key|options] · toml dump <file>

Référence

toml <file>

afficher les données TOML

toml <file> <key>

afficher un chemin pointé exact

toml dump <file>

afficher le texte source TOML normalisé

-f <text|mask> [-k|-v]

rechercher dans les clés ou valeurs ; * et ? activent un masque

-w <key> : <value>

écrire une valeur directement dans le fichier

-w <key> < <file>

écrire une valeur lue depuis un autre fichier

-d <key>

supprimer une valeur par chemin pointé

-c

valider le fichier TOML

Lire, rechercher et modifier un réglage

Commencez par toml config/app.toml pour afficher les paramètres, puis demandez database.host. -f cherche dans les chemins et valeurs, -k uniquement les clés, -v uniquement les valeurs. Le texte simple ignore la casse ; * et ? définissent des masques. -c vérifie la syntaxe et dump affiche une version reconstruite.

-w <key> : <value> enregistre immédiatement ; -w <key> < <file> lit une autre source et -d <key> supprime un chemin. Nombres et true/false peuvent être interprétés comme des valeurs typées. Faites une copie avant toute écriture. $ désigne le dernier fichier ouvert dans Core ; le nom seul peut lancer son gestionnaire.

Limites et modification prudente

Sections, chaînes, nombres, booléens et tableaux de style JSON sont pris en charge. Dates TOML, tableaux de tables et autres formes avancées ne le sont pas ; les doublons sont refusés. La réécriture efface commentaires et présentation. Préférez edit ou code pour les cas complexes. Minimum affiche seulement le fichier entier.

Aperçu interactif du sandbox

Lancez les exemples préparés directement sur la page. Les résultats sont prédéfinis et affichés dans le navigateur ; aucune commande terminal n’est exécutée sur le serveur.

Ouvrir le fichier et le réutiliser avec $

Installer et gérer

Installez la version compatible actuelle. Choisissez Base pour l’ensemble complet des fonctions ou Minimum pour le paquet réduit ; utilisez upgrade pour mettre à jour un module déjà installé.

Base et Minimum sont deux paquets de la même version actuelle du module.

Paquet Base

Installer le paquet complet avec référence locale et tous les modes publiés.

install toml
Paquet Minimum

Installer le paquet réduit. La référence locale est omise ; help <cmd> -i ouvre la référence serveur actuelle.

install toml -m
Version publique exacte

Installer exactement cette version publiée.

install toml -v 1.1.6
Vérifier ou mettre à jour

upgrade vérifie la compatibilité et remplace le bloc seulement si nécessaire.

upgrade toml
Supprimer le module

Supprimer le bloc d’extension sans toucher au noyau ni aux autres modules.

install toml -u

Exemples

Les exemples sont copiables mais ne sont pas exécutés par le site. Vérifiez chemins, droits et options destructrices.

Ouvrir le fichier et le réutiliser avec $
cd \sandbox\config | toml app.toml
application.name    lil-shop
application.debug   true
database.host       localhost
database.port       3306
database.options.0  utf8mb4
database.options.1  strict
Afficher les données TOML
toml config/app.toml
application.name    lil-shop
application.debug   true
database.host       localhost
database.port       3306
database.options.0  utf8mb4
database.options.1  strict
Afficher un chemin pointé exact
toml config/app.toml database.host
localhost
Afficher un chemin pointé exact
toml config/app.toml database.options.0
utf8mb4
Rechercher dans les clés ou valeurs ; * et ? activent un masque
toml config/app.toml -f "database.*" -k
database.host       localhost
database.port       3306
database.options.0  utf8mb4
database.options.1  strict
Rechercher dans les clés ou valeurs ; * et ? activent un masque
toml config/app.toml -f "strict" -v
database.options.1  strict
Rechercher dans les clés ou valeurs ; * et ? activent un masque
toml config/app.toml -f "debug"
application.debug  true
Écrire une valeur directement dans le fichier
toml config/app.toml -w database.port : 3307
database.port  3307
Écrire une valeur lue depuis un autre fichier
toml config/app.toml -w application.name < config/plain-value.txt
application.name  demo-site
Gérer un fichier absent
toml config/app.toml -d application.debug
application.name    lil-shop
database.host       localhost
database.port       3306
database.options.0  utf8mb4
database.options.1  strict
Valider le fichier TOML
toml config/app.toml -c
Valid TOML
Afficher le texte source TOML normalisé
toml dump config/app.toml
[application]
name = "lil-shop"
debug = true

[database]
host = "localhost"
port = 3306
options = ["utf8mb4","strict"]
Afficher un chemin pointé exact
toml config/app.toml unknown.key
Path not found
Valider le fichier TOML
toml config/invalid.toml -c
Duplicate TOML key
Afficher les données TOML
toml config/missing.toml
File not found
Écrire une valeur directement dans le fichier
toml config/app.toml -w database.port
Value required after : or

Fichier utilisé dans cet exemple: sandbox/config/app.toml

L’exemple utilise un fichier ou un répertoire de l’espace de documentation protégé /sandbox/.

[application]
name = "lil-shop"
debug = true

[database]
host = "localhost"
port = 3306
options = ["utf8mb4", "strict"]

Documentation associée

Comment installer un module ? →Pourquoi une commande répond-elle « command not found » ? →

Version publique actuelle

v1.1.62026-11-01

Affinage de production

Version stable actuelle de toml. toml lit et modifie le sous-ensemble TOML courant : tables, clés pointées, valeurs scalaires et listes simples.

# Historique des versions