default, required i quote

Trzy funkcje pojawiają się niemal na każdym chartcie: default do wartości zastępczych, required do wartości wymaganych i quote do bezpiecznego zapisu ciągów znaków.

Funkcja default dostarcza wartość zastępczą, gdy wartość jest pusta lub nieobecna, dzięki czemu szablon nigdy nie wygeneruje pustego wyniku.

W zapisie funkcyjnym najpierw podaje się wartość zastępczą, a następnie wartość właściwą. W potoku wartość trafia na końcu, dzięki czemu zapis jest naturalny.

Dla funkcji default pusta wartość oznacza 0, pusty ciąg znaków, pustą listę lub nil. Każda z tych wartości uruchamia wartość zastępczą.

Funkcja required zatrzymuje renderowanie i wyświetla podany komunikat, gdy brakuje wartości, zamieniając ciche błędy w jasne komunikaty. ⛔

Gdy wartość jest obecna, required po prostu ją zwraca, dlatego można użyć tej funkcji bezpośrednio wszędzie tam, gdzie powinno znajdować się pole wymagane.

Dobry komunikat funkcji required wskazuje brakujący klucz i sposób jego ustawienia, dzięki czemu użytkownicy mogą naprawić problem bez czytania chartu.

Funkcja quote umieszcza wartość w cudzysłowach, chroniąc YAML przed wartościami wyglądającymi jak liczby, wartości logiczne lub wartości null.

Bez funkcji quote wartość taka jak yes lub 1.20 może zostać zinterpretowana jako wartość logiczna albo liczba. Cudzysłowy zachowują ją jako przewidywalny ciąg znaków.

Funkcje te można łączyć w jednym potoku: najpierw dostarczyć wartość domyślną, a następnie ująć wynik w cudzysłowy — wszystko w jednym czytelnym wierszu.

Funkcji default należy używać, gdy wartość jest opcjonalna, a required — gdy jest wymagana. Po quote warto sięgać zawsze, gdy ciąg znaków ma pozostać ciągiem znaków.

Która funkcja zatrzymuje renderowanie, gdy brakuje wartości?

Poznali Państwo funkcję default do wartości zastępczych, required do wartości wymaganych oraz quote do bezpiecznych ciągów znaków. Razem zapewniają one niezawodne wartości. 🎉