default, required und quote

Drei Funktionen kommen in fast jedem Chart vor: default für Ersatzwerte, required für notwendige Werte und quote für sichere Strings.

Die Funktion default liefert einen Ersatzwert, wenn ein Wert leer ist oder fehlt. So rendert Ihr Template niemals einen leeren Wert.

Als Funktion geschrieben steht der Ersatzwert an erster Stelle und der Wert an zweiter. In einer Pipe kommt der Wert zuletzt, wodurch der Ausdruck natürlich lesbar ist.

Bei default gelten 0, ein leerer String, eine leere Liste oder nil als leer. Jeder dieser Fälle löst den Ersatzwert aus.

Die Funktion required bricht das Rendern mit Ihrer Nachricht ab, wenn ein Wert fehlt, und macht so stille Fehler zu eindeutigen Fehlermeldungen. ⛔

Wenn der Wert vorhanden ist, gibt required ihn einfach zurück. Sie können die Funktion daher überall dort direkt einsetzen, wo ein Pflichtfeld benötigt wird.

Eine gute required-Nachricht nennt den fehlenden Schlüssel und erklärt, wie er gesetzt wird. So können Benutzer das Problem beheben, ohne das Chart lesen zu müssen.

Die Funktion quote setzt einen Wert in doppelte Anführungszeichen und schützt YAML so vor Werten, die wie Zahlen, boolesche Werte oder Nullwerte aussehen.

Ohne quote kann ein Wert wie yes oder 1.20 als boolescher Wert oder Zahl interpretiert werden. Durch die Anführungszeichen bleibt er zuverlässig ein String.

Diese Funktionen lassen sich in einer Pipeline kombinieren: Geben Sie zunächst einen Standardwert an und setzen Sie das Ergebnis anschließend in Anführungszeichen – alles in einer übersichtlichen Zeile.

Verwenden Sie default, wenn ein Wert optional ist, und required, wenn er verpflichtend ist. Verwenden Sie quote immer dann, wenn ein String ein String bleiben muss.

Welche Funktion bricht das Rendern ab, wenn ein Wert fehlt?

Sie haben default für Ersatzwerte, required für Pflichtangaben und quote für sichere Strings kennengelernt. Zusammen machen sie Werte robust. 🎉