Kas ir YAML fails?

YAML fails sastāv no valodas YAML (YAML Ain’t Markup Language), kas ir uz Unikoda bāzes datu serializācijas valoda; izmanto konfigurācijas failiem, interneta ziņojumapmaiņai, objektu noturībai utt. YAML failiem izmanto paplašinājumu .yaml. Tās sintakse nav atkarīga no noteiktas programmēšanas valodas. Būtībā YAML ir paredzēts cilvēku mijiedarbībai un labi darbam ar mūsdienu programmēšanas valodām. Atbalsts patvaļīgu vietējo datu struktūru serializēšanai palielināja YAML failu lasāmību, taču tas ir nedaudz sarežģījis parsēšanas un failu ģenerēšanas procesu.

Īsa vēsture

YAML pirmo reizi tika ierosināts 2001. gadā, un to izstrādāja Klārks Evanss, Ingy döt Net un Orens Ben-Kiki. Vispirms tika teikts, ka YAML nozīmē vēl viena iezīmēšanas valoda, lai norādītu tās kā iezīmēšanas valodas mērķi. Vēlāk tā tika pārdēvēta par YAML Aint Markup Language, lai norādītu, ka tā ir orientēta uz datiem.

YAML faila formāts

YAML fails sastāv no šādiem datu tipiem

• Skalāri: skalāri ir tādas vērtības kā virknes, veseli skaitļi, Būla skaitļi utt.
• Secības: secības ir saraksti, kuros katrs vienums sākas ar defisi (-). Sarakstus var arī ievietot ligzdā.
• Kartēšana: kartēšana sniedz iespēju uzskaitīt atslēgas ar vērtībām.

Sintakse

• Atstarpes: atstarpes atkāpe tiek izmantota, lai norādītu ligzdošanu un vispārējo struktūru.

vārds: Džons Smits
kontaktēties:
mājas numurs: 1012355532
birojs: 5002586256
adrese:
iela: |
123 Tornado aleja
Suite numurs 16
pilsēta: East Centerville
valsts: KS

• Komentāri: Komentāri tiek rakstīti, sākot ar simbolu #.

# Šis ir YAML komentārs

• Saraksti: defise (-) tiek izmantota, lai norādītu saraksta dalībniekus ar katru dalībnieku atsevišķā rindā. Saraksta dalībniekus var arī ievietot kvadrātiekavās ([…]), atdalot tos ar komatiem (,).

  - "A"
  - "B"
  - "C"

[A, B, C]

• Asociatīvais masīvs: asociatīvo masīvu ieskauj krokainas iekavas ({…}). Atslēgas un vērtības ir atdalītas ar kolu (:), un katrs pāris ir atdalīts ar komatu (,).

{vārds: Džons Smits, vecums: 20}

• Virknes: virkni var rakstīt ar dubultpēdiņām () vai vienpēdiņām (’) vai bez tām.

Virknes paraugs
"Virknes paraugs"
Parauga virkne

• Skalārā bloka saturs: skalāro saturu var rakstīt bloka apzīmējumā, izmantojot tālāk norādīto.
  • “|: visi tiešraides pārtraukumi ir nozīmīgi.”
  • “>: katrs rindiņas pārtraukums tiek pārlocīts līdz atstarpei. Tas noņem katras rindas vadošo atstarpi.”

dati: |
YAML
(YAML nav iezīmēšanas valoda)
ir datu serializācijas valoda

dati: ?
YAML (YAML nav iezīmēšanas valoda)
ir datu serializācijas valoda

• Vairāki dokumenti: vairāki dokumenti ir atdalīti ar trim defisēm (—) vienā straumē. Defises norāda dokumenta sākumu. Defises tiek izmantotas arī, lai atdalītu direktīvas no dokumenta satura. Dokumenta beigas ir apzīmētas ar trim punktiem (…).

  ---
1. dokuments
  ---
2. dokuments
...

• Tips: lai norādītu vērtības veidu, tiek izmantotas dubultās izsaukuma zīmes (!!).

a: !!peld 123
b: !!str 123

• Tags: lai piezīmei piešķirtu atzīmi, tiek izmantota & (&) un, lai atsauktos uz šo mezglu, tiek izmantota zvaigznīte (*).

vārds: Džons Smits
rēķina saņēmējs: &id01
iela: |
123 Tornado aleja
Suite numurs 16
pilsēta: East Centerville
valsts: KS

piegāde uz: *id01

• Direktīvas: pirms YAML dokumentiem straumē var ievietot direktīvas. Direktīvas sākas ar procentu zīmi (%), kam seko nosaukums un pēc tam parametri, kas atdalīti ar atstarpēm.

%YAML 1.2
  ---
Dokumenta saturs

YAML faila piemērs

Tālāk ir redzams docker yaml faila piemērs:

topology:
database_node_name: docker_controller
docker_controller_node_name: docker_controller
self_service_portal_node_name: docker_controller
kvm_compute_node_names: kvm_compute1
docker_compute_node_names: docker_compute1

YAML vs JSON

Būtībā gan JSON, gan YAML ir izstrādāti, lai nodrošinātu cilvēkiem lasāmu datu apmaiņas formātu. YAML tiek realizēts kā JSON formāta superkopa. Tas nozīmē, ka mēs varam parsēt JSON, izmantojot YAML parsētāju. Lai gan šīs teorijas praktiskā īstenošana ir nedaudz sarežģīta. Tāpēc dažas pamata atšķirības starp YAML un JSON ir norādītas tālāk:

Atsauces Nr.

• YAML - Wikipedia
• YAML