Kasutaja:Kravi321/YAML

YAML
Viimane väljalase	1.2 / 1. oktoober 2009
Veebisait	yaml.org

YAML (YAML Ain’t Markup Language) on andmevahetusvorming, mis on loodud eesmärgiga olla võimalikult inimloetav ning lihtsasti integreeritav paljude programmeerimiskeeltega.

YAML kasutab sarnaselt Pythonile kuuluvuse näitamiseks treppimist. See tähendab, et samale kaugusele joondatud ridadel asetsevad muutujad moodustavad ühtse terviku. Alates YAML 1.2 versioonist on kuuluvust on võimalik lisaks treppimisele näidata ka nurksulgudega [] loendite ning looksulgudega {} sõnastike puhul. Kuna alates versioonist 1.2 on JSON YAML-i alamhulk, siis on JSON formaadis failid ühtlasi valiidsed ka YAML vormingus.

YAML vormingu kõige laialdasemaks kasutusalaks on konfiguratsioonifailid. Vormingu lihtsasti loetav süntaks annab kasutajale kiire ülevaate aktiivsetest seadistustest.

YAML failide ametlik faililaiend on .yaml.

Ajalugu

YAML formaati esitles 2001. aastal Colin Clark, kes oli selle disaininud koostöös Ingy döt Neti ja Oren Ben-Kikiga. Esmalt oli akronüümi tähenduseks Yet Another Markup Language, kuid juba 2002. aastal avaldatud spetsifikatsiooniuuenduses oli see muudetud tänase versiooni, YAML Ain’t Markup Language, vastu. Seda tehti, et eristada YAML-i kui andmete talletamisele spetsialiseerunud vormingut märgendkeeltest nagu HTML ja XML, mida kasutatakse dokumentide semantilise struktuuri edastamiseks.

Süntaks ja andmetüübid

YAML-i süntaksilised eripärad:

• Treppimine on lubatud vaid tühikutega. Tabuleerimine on keelatud, kuna tabeldusmärgi käsitlus pole erinevates tekstiredaktorites standardiseeritud ja võib seetõttu segada vormingu interpreteerimist.
• Kommentaar algab sümboliga # ja lõppeb reavahetusega. Mitmerealisi kommentaare YAML ei toeta.
• YAML fail võib koosneda mitmest dokumendist. Dokumendi algust tähistab kolm sidekriipsu --- ning lõppu kolm punkti .... Lõpu märkimine ei ole kohustuslik.

Muutujad

YAML toetab klassikalisi andmetüüpe nagu sõne, täisarv, tõeväärtus ja ujukomaarv. Erinevalt paljudest teistest vormingutest on YAML-is sõnede kirjutamisel süntaksiliselt üsna vabad käed. Sõne võib kirjutada ühekordsete või kahekordsete jutumärkide vahele. Kui sõne ei vasta täisarvu, ujukomaarvu või tõeväärtuse süntaksile, ei alga erisümbolitega {, }, [, ], ,, &, *, #, ?, |, -, <, >, =, !, %, @, \ ning ei sisalda erisümboleid :, # , siis võib jutumärgid ära jätta.

---
a: 123                     # täisarv
b: "123"                   # sõne 
c: '123'                   # sõne 
d: !!str 123               # sõne, kasutades tüüpimist
f: 123.0                   # ujukomaarv
g: true                    # tõeväärtus
h: Mari Maasikas           # sõne 
...

Sõnesid on võimalik kirjutada ka mitmerealisena. Selleks on kaks analoogset võimalust, mida saab kasutada vastavalt teksti vormindamise vajadusele. Püstkriipsuga | alustatud sõnesid parsitakse ilma reavahetusteta. Reavahetuste alles jätmiseks tuleb sõne alustada sümboliga >.

tekst: |
   Kui Arno isaga koolimajja jõudis, olid tunnid juba alanud. 
   Kooliõpetaja kutsus mõlemad oma tuppa, kõneles nendega natuke aega, 
   käskis Arnol olla hoolas ja korralik ja seadis ta siis pinki ühe pikkade juustega poisi kõrvale istuma.

Loend

Loendi elemente tähistatakse kirjele eelneva sidekriipsuga - . Samale kaugusele joondatud elemendid moodustavad loendikogumi.

 - sõiduk
   - auto
     - Audi
     - BMW
   - lennuk
     - Airbus
     - Boeing

Sõnastik

Sõnastikud koosnevad võti: väärtus paaridest. Väärtustena võib kasutada mistahes andmetüüpe.

# Töötajate andmed
-  martin:
    name: Martin Kuningas
    job: Arendaja
    skills:
      - python
      - java
      - pascal
-  mari:
    name: Mari Maasikas
    job: Analüütik
    skills:
      - excel
      - word
      - powerpoint

Vaata ka

• JSON
• XML