YAML

Formáty serializace dat

Serializace dat je proces převodu strukturovaných dat do formátu, který lze uložit nebo přenést a později znovu sestavit. Různé formáty dělají různé kompromisy mezi čitelností pro člověka, strojovou zpracovatelností, výrazností a velikostí souboru. Volba správného formátu závisí na tom, zda soubor primárně čte člověk nebo stroj, a na ekosystému nástrojů, které s daty pracují.

JSON, YAML, TOML a XML jsou čtyři dominantní textové formáty serializace ve vývoji softwaru. Každý má silné stránky, které z něj dělají nejlepší volbu pro konkrétní kontext — pochopení těchto kompromisů vám umožní vybrat správný formát pro každý úkol. Znalost všech čtyř formátů je pro moderního vývojáře prakticky nezbytností, protože se s nimi setkáte napříč různými platformami a nástroji.

JSON a YAML vedle sebe

JSON a YAML reprezentují stejný datový model. YAML je striktní nadmnožinou JSON — jakýkoli platný JSON dokument je zároveň platným YAML. Níže je stejná konfigurace vyjádřená v obou formátech:

{
  "server": {
    "host": "localhost",
    "port": 8080,
    "debug": true
  },
  "database": {
    "url": "postgres://localhost/mydb",
    "pool": 10
  }
}

server:
  host: localhost
  port: 8080
  debug: true
database:
  url: postgres://localhost/mydb
  pool: 10

YAML používá odsazení místo složených závorek a hranatých závorek a vynechává uvozovky u většiny řetězcových hodnot. Díky tomu je kompaktnější a čitelnější pro soubory editované člověkem, ale zavádí citlivost na odsazení. Při automatizovaném generování YAML souborů je proto vždy bezpečnější použít knihovnu pro serializaci než skládat výstup ručně pomocí řetězcové konkatenace.

Porovnání formátů

Záludnosti YAML

YAML je výkonný, ale má dobře známé okrajové případy, které vývojáře překvapují. Toto jsou ty nejčastější. Dobrá znalost těchto pastí vám ušetří hodiny ladění, zejména při práci s automaticky generovanými konfiguracemi nebo při migraci souborů mezi různými parsery.

Funkce jedinečné pro YAML

Komentáře

YAML podporuje komentáře pomocí znaku #. To je jedna z největších praktických výhod oproti JSON pro konfigurační soubory — můžete dokumentovat nastavení přímo v souboru. Komentáře mohou být na vlastním řádku nebo za hodnotou. Tato možnost je zvláště cenná v prostředích, kde konfiguraci upravují i méně zkušení členové týmu, protože komentář přímo u nastavení výrazně snižuje počet chyb způsobených nepochopením účelu dané hodnoty.

Kotvy a aliasy

YAML umožňuje definovat uzel jednou pomocí &název-kotvy a znovu ho použít kdekoliv pomocí *název-kotvy. Tím se eliminuje opakování v složitých konfiguracích. Kubernetes a Docker Compose hojně využívají kotvy pro sdílené definice služeb. Aliasy lze kombinovat s operátorem sloučení (<<) pro přepsání nebo rozšíření definice, což umožňuje vytvořit základní šablonu a z ní odvodit specializované varianty se zachováním společných vlastností.

Víceřádkové řetězce

YAML podporuje blokové skaláry ve dvou režimech: literální blok (|) zachovává konce řádků přesně tak, jak jsou zapsány — vhodné pro skripty a šablony. Přeložený blok (>) zalamuje dlouhé řetězce do jednoho řádku — vhodné pro delší textové popisy. Správné použití těchto režimů je klíčové při vkládání shell skriptů nebo SQL dotazů přímo do konfiguračního souboru, protože špatně zvolený režim může změnit funkčnost vloženého kódu.

Kdy potřebujete konverzi

Nejčastěji kladené otázky