toml

toml legge e modifica il sottoinsieme TOML più comune: tabelle, chiavi puntate, valori scalari e liste semplici. Convalida e scrittura avvengono direttamente sul file scelto.

DatiVersione 1.1.6Stabile
lil-terminal

Panoramica

toml lavora direttamente con le configurazioni TOML comuni: legge percorsi puntati, cerca chiavi o valori, modifica atomicamente una voce, valida il sottoinsieme supportato e mostra la sorgente normalizzata completa.

Le tabelle diventano percorsi puntati

Una tabella [database] con host si indirizza come database.host. Il parser è pensato per configurazioni comuni di hosting; i costrutti TOML complessi è meglio modificarli come testo.

Sintassi

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

Riferimento

toml <file>

mostrare i dati TOML

toml <file> <key>

mostrare un percorso puntato esatto

toml dump <file>

mostrare il testo sorgente TOML normalizzato

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

cercare corrispondenze in chiavi o valori; * e ? attivano una maschera

-w <key> : <value>

scrivere un valore direttamente nel file

-w <key> < <file>

scrivere un valore letto da un altro file

-d <key>

eliminare un valore tramite percorso puntato

-c

convalidare il file TOML

Leggere, cercare e modificare le impostazioni

Inizia con toml config/app.toml per vedere le impostazioni; aggiungi database.host per un valore specifico. -f cerca nei percorsi e nei valori, -k solo nelle chiavi e -v solo nei valori. Il testo semplice ignora maiuscole e minuscole; * e ? sono maschere. -c verifica la sintassi e dump mostra il testo ricostruito.

-w <key> : <value> salva subito, -w <key> < <file> legge un altro file e -d <key> elimina un percorso. Numeri e true/false possono essere interpretati come tipi. Fai una copia prima di salvare. $ indica l’ultimo file aperto in Core; il solo nome può attivare il relativo gestore.

Limiti e modifiche sicure

Sono supportate sezioni, stringhe, numeri, booleani e liste in stile JSON. Date TOML, array di tabelle e altre funzioni avanzate non sono supportati; le chiavi o sezioni duplicate vengono rifiutate. Il salvataggio elimina commenti e formattazione. Per TOML complesso usa edit o code. Minimum mostra solo il file.

Anteprima interattiva del sandbox

Esegui gli esempi preparati direttamente nella pagina. I risultati sono predefiniti e mostrati nel browser; sul server non viene eseguito alcun comando del terminale.

Aprire il file e riutilizzarlo con $

Installa e gestisci

Installa la versione compatibile corrente. Scegli Base per tutte le funzioni o Minimum per il pacchetto ridotto; usa upgrade per aggiornare un modulo già installato.

Base e Minimum sono due pacchetti della stessa release corrente del modulo.

Pacchetto Base

Installa il pacchetto completo con riferimento locale e tutte le modalità pubblicate.

install toml
Pacchetto Minimum

Installa il pacchetto ridotto. Il riferimento locale è omesso; help <cmd> -i apre il riferimento server corrente.

install toml -m
Versione pubblica esatta

Installa esattamente questa versione pubblicata.

install toml -v 1.1.6
Controlla o aggiorna

upgrade controlla la compatibilità e sostituisce il blocco solo quando serve.

upgrade toml
Rimuovi modulo

Rimuove il blocco estensione senza toccare core e altri moduli.

install toml -u

Esempi

Gli esempi sono copiabili ma il sito non li esegue. Controlla percorsi, permessi e opzioni distruttive.

Aprire il file e riutilizzarlo con $
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
Mostrare i dati 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
Mostrare un percorso puntato esatto
toml config/app.toml database.host
localhost
Mostrare un percorso puntato esatto
toml config/app.toml database.options.0
utf8mb4
Cercare corrispondenze in chiavi o valori; * e ? attivano una maschera
toml config/app.toml -f "database.*" -k
database.host       localhost
database.port       3306
database.options.0  utf8mb4
database.options.1  strict
Cercare corrispondenze in chiavi o valori; * e ? attivano una maschera
toml config/app.toml -f "strict" -v
database.options.1  strict
Cercare corrispondenze in chiavi o valori; * e ? attivano una maschera
toml config/app.toml -f "debug"
application.debug  true
Scrivere un valore direttamente nel file
toml config/app.toml -w database.port : 3307
database.port  3307
Scrivere un valore letto da un altro file
toml config/app.toml -w application.name < config/plain-value.txt
application.name  demo-site
Gestire un file mancante
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
Convalidare il file TOML
toml config/app.toml -c
Valid TOML
Mostrare il testo sorgente TOML normalizzato
toml dump config/app.toml
[application]
name = "lil-shop"
debug = true

[database]
host = "localhost"
port = 3306
options = ["utf8mb4","strict"]
Mostrare un percorso puntato esatto
toml config/app.toml unknown.key
Path not found
Convalidare il file TOML
toml config/invalid.toml -c
Duplicate TOML key
Mostrare i dati TOML
toml config/missing.toml
File not found
Scrivere un valore direttamente nel file
toml config/app.toml -w database.port
Value required after : or

File usato in questo esempio: sandbox/config/app.toml

L’esempio usa un file o una directory dell’area di documentazione protetta /sandbox/.

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

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

Documentazione correlata

Come si installa un modulo? →Perché un comando risponde “command not found”? →

Versione pubblica attuale

v1.1.62026-11-01

Rifinitura di produzione

Versione stabile attuale di toml. toml legge e modifica il sottoinsieme TOML più comune: tabelle, chiavi puntate, valori scalari e liste semplici.

# Cronologia versioni