nindent e indent nella pratica

YAML usa gli spazi per indicare la struttura, quindi un blocco inserito alla profondità sbagliata danneggia il file. Helm offre helper per indentare correttamente l'output.

La funzione indent aggiunge un numero fisso di spazi all'inizio di ogni riga di una stringa, spostando un intero blocco verso destra.

Ecco il punto importante: indent sposta ogni riga, ma non aggiunge una nuova riga iniziale. La prima riga viene inserita esattamente nel punto in cui si trova l'azione.

La funzione nindent applica la stessa spaziatura, ma prima stampa una nuova riga, così il blocco inizia ordinatamente su una riga separata.

La nuova riga iniziale aggiunta da nindent evita di dover lasciare uno spazio finale e indovinare l'allineamento dopo una chiave sulla stessa riga.

Ricorrerà a nindent soprattutto quando inserisce un blocco toYaml sotto una chiave, perché posiziona la mappa renderizzata ordinatamente sotto la chiave.

Scelga il numero contando gli spazi dalla chiave padre, non dalla colonna zero. Un elemento figlio a due livelli di profondità di solito richiede nindent 4.

Il semplice indent è corretto quando il blocco inizia già su una riga separata, quindi non desidera inserire una nuova riga aggiuntiva davanti.

La maggior parte delle strutture YAML procede per livelli di due spazi. Sbagliare di due il conteggio di nindent è la causa principale dei chart che non riescono a essere analizzati.

Non indovini mai la profondità. Esegua helm template e legga l'output grezzo per confermare che le righe del blocco inserito siano allineate sotto la chiave padre.

Entrambi gli helper leggono la stringa dalla pipe alla loro sinistra, quindi si combinano naturalmente con toYaml per formattare un'intera mappa nel manifest.

Scrive {{ toYaml .Values.env | indent 4 }} subito dopo una chiave sulla stessa riga e il formato YAML risulta non valido.

Ora sa che indent aggiunge spazi a un blocco, nindent inserisce prima una nuova riga e il rendering è il modo più sicuro per confermare la profondità. 🧹