Czym jest plik YAML?

YAML — konfiguracja czytelna dla człowieka

Co to jest?

YAML to format konfiguracyjny zaprojektowany tak, by był łatwy do odczytania i zapisania przez człowieka. Brak nawiasów klamrowych, brak znaczników — strukturę wyznacza wcięcie, podobnie jak w liście punktowanej.

Dopuszcza komentarze, co czyni go formatem z wyboru dla plików konfiguracyjnych — tam, gdzie JSON, który ich zabrania, bywa po prostu niewygodny.

Historia i pochodzenie

YAML pojawia się w 2001 roku, z wyraźną ambicją bycia bardziej czytelnym niż XML i bardziej elastycznym niż istniejące formaty konfiguracyjne.

Na dobre zadomowił się w narzędziach nowoczesnego programisty: integracja ciągła, orkiestracja kontenerów, automatyczne wdrożenia. Dzisiejszy inżynier pisze w nim praktycznie codziennie.

Dlaczego jest przydatny

Bardzo czytelny, bardzo zwięzły, dopuszcza komentarze i elegancko obsługuje struktury zagnieżdżone.

Jest technicznie nadzbiorem JSON-a: każdy plik JSON jest jednocześnie poprawnym plikiem YAML.

Ograniczenia i wady

Wcięcie ma znaczenie, a tabulator jest zabroniony: jedna spacja za dużo lub źle postawiona, i plik zmienia sens albo staje się nieprawidłowy.

Jego automatyczne konwersje typów to znany pułapek: w starszych wersjach wartość NO — kod Norwegii — była interpretowana jako wartość logiczna „fałsz”. Tego typu niespodzianki przyniosły formatowi opinię niejednoznacznego.

Wskazówki

YAML sprawdza się doskonale do konfiguracji pisanej ręcznie. Do wymiany danych między maszynami warto przekonwertować go na JSON: bardziej rygorystyczny, bardziej przewidywalny, bez dwuznaczności typów.

Zawsze ujmuj w cudzysłów wartości, które mogłyby zostać źle zinterpretowane: tak, nie, on, off, oraz wszystko, co przypomina liczbę, a nią nie jest.

Przekonwertuj swój plik YAML w kilka sekund na naszych bezpiecznych serwerach we Francji.

Konwertuj YAML