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.5Stabile
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

File attivo

Con il core corrente, un file aperto correttamente diventa subito disponibile come $. Se questo modulo è il gestore installato con priorità più alta per l’estensione, basta digitare il nome del file per aprirlo con questo comando. Sono scorciatoie del core; toml <file> resta la forma esplicita.

Ricerca

-f cerca in percorsi e valori. Aggiungere -k per le sole chiavi o -v per i soli valori. Le query con * o ? sono trattate come maschere.

Modifica diretta

-w scrive subito nel file. Dopo : si indica un valore inline; < <file> legge il valore da un altro file. -d elimina un percorso puntato.

Ambito del formato

Il modulo implementa volutamente il sottoinsieme di configurazione comune nell’hosting condiviso. Le funzioni avanzate del formato vanno modificate testualmente con edit o code.

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.5
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
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 $ database.host
localhost
Toml · find-key
toml $ -f "database*" -k
database.host       localhost
database.port       3306
database.options.0  utf8mb4
database.options.1  strict
Toml · find-value
toml $ -f "strict" -v
database.options.1  strict
Toml · write
toml $ -w database.port : 3307
database.port  3307
Toml · delete
toml $ -d database.port
database.host  localhost
Toml · validate
toml $ -c
Valid TOML
Mostrare il testo sorgente TOML normalizzato
toml dump $
[application]
name = "lil-shop"
debug = true

[database]
host = "localhost"
port = 3306
Gestire un file mancante
toml \sandbox\config\missing.toml
File non trovato

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.52026-08-14

Guida uniforme per dati strutturati

Lettura, ricerca, scrittura, eliminazione e verifica sono presentate con lo stesso schema di opzioni.

# Cronologia versioni