ini

ini lavora con veri file INI: legge sezioni e valori tipizzati, cerca impostazioni, convalida la sintassi e modifica una chiave in modo atomico. Un percorso è key o section.key.

DatiVersione 1.3.6Stabile
lil-terminal

Panoramica

ini lavora direttamente sui file INI: legge chiavi con percorsi puntati, cerca chiavi o valori, modifica atomicamente una singola impostazione, valida il risultato e mostra la sorgente normalizzata senza buffer di sessione.

Sezione e chiave formano due livelli

application.name seleziona name nella sezione [application]. Un percorso più profondo come a.b.c viene rifiutato intenzionalmente; JSON, TOML o YAML sono più adatti quando serve maggiore annidamento.

Sintassi

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

Riferimento

ini <file>

mostrare i dati INI

ini <file> <key>

mostrare il valore esatto di una chiave o sezione

ini dump <file>

mostrare il testo sorgente INI normalizzato

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

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

-w <key> : <value>

scrivere uno scalare o una lista in stile JSON direttamente nel file

-w <key> < <file>

scrivere un valore letto da un altro file

-d <key>

eliminare una chiave o sezione

-c

convalidare il file INI

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; ini <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.

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 ini
Pacchetto Minimum

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

install ini -m
Versione pubblica esatta

Installa esattamente questa versione pubblicata.

install ini -v 1.3.6
Controlla o aggiorna

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

upgrade ini
Rimuovi modulo

Rimuove il blocco estensione senza toccare core e altri moduli.

install ini -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 | ini app.ini
application.name   lil-sandbox
application.debug  true
paths.source       ../src
paths.public       ../public
Mostrare i dati INI
cd \sandbox\config | app.ini
application.name   lil-sandbox
application.debug  true
paths.source       ../src
paths.public       ../public
Mostrare il valore esatto di una chiave o sezione
ini config/app.ini application.name
lil-sandbox
Cercare corrispondenze in chiavi o valori; * e ? attivano una maschera
ini config/app.ini -f "paths.*" -k
paths.source  ../src
paths.public  ../public
Cercare corrispondenze in chiavi o valori; * e ? attivano una maschera
ini config/app.ini -f "../public" -v
paths.public  ../public
Cercare corrispondenze in chiavi o valori; * e ? attivano una maschera
ini config/app.ini -f "debug"
application.debug  true
Scrivere uno scalare o una lista in stile JSON direttamente nel file
ini config/app.ini -w application.debug : false
application.debug  false
Scrivere un valore letto da un altro file
ini config/app.ini -w application.name < config/plain-value.txt
application.name  demo-site
Eliminare una chiave o sezione
ini config/app.ini -d paths.public
application.name   lil-sandbox
application.debug  true
paths.source       ../src
Gestire un file mancante
ini config/app.ini -c
Valid INI
Mostrare il testo sorgente INI normalizzato
ini dump config/app.ini
[application]
name = "lil-sandbox"
debug = true

[paths]
source = "../src"
public = "../public"
Mostrare il valore esatto di una chiave o sezione
ini config/app.ini missing.key
Path not found
Scrivere uno scalare o una lista in stile JSON direttamente nel file
ini config/app.ini -w a.b.c : 1
INI paths support section.key only
Convalidare il file INI
ini config/invalid.ini -c
Invalid INI
Mostrare i dati INI
ini config/missing.ini
File not found
Scrivere uno scalare o una lista in stile JSON direttamente nel file
ini config/app.ini -w application.name
Value required after : or 

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

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

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

[paths]
source = "../src"
public = "../public"

Documentazione correlata

Versione pubblica attuale

v1.3.62026-11-01

Rifinitura di produzione

Versione stabile attuale di ini. ini lavora con veri file INI: legge sezioni e valori tipizzati, cerca impostazioni, convalida la sintassi e modifica una chiave in modo atomico.