imported>LWChris: /* Design-Ziele */ Nicht das Konzept macht es einfacher zu lesen, sondern die "schlanke" Syntax, welche durch das Konzept ermöglicht wird.

2026-04-19T00:42:17Z

Design-Ziele: Nicht das Konzept macht es einfacher zu lesen, sondern die "schlanke" Syntax, welche durch das Konzept ermöglicht wird.

Neue Seite

{{Dieser Artikel|beschreibt das Datenformat. Zum CSS-Framework siehe [[YAML (Framework)]].}}
{{Infobox Dateiformat
| Name =
| Icon =
| Logo = [[Datei:YAML Logo.svg|rahmenlos]]
| Screenshot =
| Beschreibung =
| Dateiendung = .yml (veraltet),<ref>{{Internetquelle |url=https://yaml.org/faq.html |titel=Is there an official extension for YAML files? |werk=yaml.org |abruf=2021-01-15}}</ref> .yaml
| MIME = application/yaml<ref>{{RFC-Internet |RFC=9512 |Titel=YAML Media Type |Datum=2024-02 |Autor=Roberto Polli, Erik Wilde, Eemeli Aro}}</ref>
| MIME-Anm =
| MagischeZahl =
| MagischeZahlNotation =
| MagischeZahlHex =
| Entwickler =
| Veröffentlicht = 2001-05-11
| LetzteVersion = 1.2.2<ref>{{Internetquelle |url=https://yaml.org/spec/1.2.2/ |titel=YAML Ain’t Markup Language (YAML™) Version 1.2.2 |werk=yaml.org |abruf=2022-03-28}}</ref>
| LetzteVersionDatum = 2021-10-01
| Art = Datenaustausch
| Container für =
| Enthalten in =
| Erweitert von =
| Erweitert zu =
| Standard =
| Website = [https://yaml.org/ yaml.org]
}}

'''YAML''' [{{IPA|ˈjæməl}}] ist ein textbasiertes [[Dateiformat]] zur [[Serialisierung|Datenserialisierung]], das außerdem für [[Konfigurationsdatei]]en verbreitet ist. Die Idee zu YAML stammt von Clark Evans von 2001<ref>{{Internetquelle |autor=Clark C . Evans |url=https://groups.yahoo.com/neo/groups/sml-dev/conversations/topics/4710 |titel=YAML Draft 0.1 |datum=2001-05-11 |abruf=2019-06-22 |kommentar=Newsgroup, jetzt auf Yahoo Groups}}</ref>, die Spezifikation wurde von ihm selbst, Brian Ingerson und Oren Ben-Kiki erstellt. YAML ist an [[Extensible Markup Language|XML]] ''(da ursprünglich als [[vereinfachte Auszeichnungssprache]] gedacht)'' und an die Datenstrukturen in den Sprachen [[Perl (Programmiersprache)|Perl]], [[Python (Programmiersprache)|Python]] und [[C (Programmiersprache)|C]] sowie dem in <nowiki>RFC 2822</nowiki><ref>{{RFC-Internet |RFC=2822 |Titel=Internet Message Format |Datum=2001-04}}</ref> vorgestellten E-Mail-Format angelehnt.

YAML ist ein [[rekursives Akronym]] für „YAML Ain’t Markup Language“ (ursprünglich „Yet Another Markup Language“).

== Design-Ziele ==
Die grundsätzliche Annahme von YAML ist, dass jede beliebige [[Datenstruktur]] als geschachtelte Struktur von [[Skalare Variable|Skalaren]], [[Array (Datentyp)|Arrays]] und [[Zuordnungstabelle]]n dargestellt werden kann. Durch dieses Konzept benötigt die [[Syntax]] von YAML seltener strukturgebende Elemente wie umschließende Klammern, [[Tag (Informatik)|Tags]] oder Anführungszeichen, und ist dadurch wiederum leichter von Menschen zu lesen und zu schreiben als beispielsweise XML oder [[JSON]]. Außerdem vereinfacht das Konzept die Weiterverarbeitung der Daten, da die meisten [[Programmiersprache|Sprachen]] [[Datentyp]]en für diese drei Konstrukte bereits integriert haben.

== Beispiele ==
Hinweis:
* Das Zeichen <code>#</code> leitet einzeilige Kommentare ein, <code>---</code> markiert den Beginn eines neuen Abschnitts.
* Ein Kommentar in der gleichen Zeile wie <code>---</code> kann zwar Probleme beim Einlesen der YAML-Datei hervorrufen – aus Übersichtsgründen ist er im Beispiel jedoch trotzdem in der gleichen Zeile.

Listen:
<syntaxhighlight lang="yaml">
--- # im Block-Format ein paar Filme von M. Curtiz und A. Hitchcock aus den 1940er Jahren
- Berüchtigt (Notorious)
- Casablanca
- Ich kämpfe um dich (Spellbound)
- Solange ein Herz schlägt (Mildred Pierce)
--- # Inline-Format einer Einkaufsliste
[Haferflocken, Bananen, Nüsse]
</syntaxhighlight>

Assoziative Listen:
<syntaxhighlight lang="yaml">
--- # Block
name: John Smith
age: 33
--- # Inline
{name: John Smith, age: 33}
</syntaxhighlight>

Block-Ausdrücke mit [[Senkrechter Strich|senkrechtem Strich]] bewirken, dass Zeilenumbrüche beibehalten werden:
<syntaxhighlight lang="yaml">
--- |
There was a young lady of Wright
Who travelled much faster than light.
She departed one day
In a relative way
And returned in the previous night.
</syntaxhighlight>
Quelle <ref>Ein Limerick aus dem Buch ''Eine kurze Geschichte der Zeit'' von [[Stephen Hawking]] zum Thema Relativitätstheorie</ref>

Block-Ausdrücke mit Größer-als-Zeichen bewirken, dass einzelne Zeilenumbrüche in Leerzeichen geändert werden:
<syntaxhighlight lang="yaml">
--- >
Umbrochener Text
wird zu einem
einzigen Absatz
gefaltet.

Leerzeilen bezeichnen
dagegen Absatzumbrüche.
</syntaxhighlight>

Liste von assoziativen Listen:
<syntaxhighlight lang="yaml">
- {name: John Smith, age: 33}
- name: Mary Smith
age: 27
</syntaxhighlight>

Assoziative Liste von Listen:
<syntaxhighlight lang="yaml">
men: [John Smith, Bill Jones]
women:
- Mary Smith
- Susan Williams
</syntaxhighlight>

== Kritik ==
Insbesondere nach der weiten Verbreitung von YAML in Konfigurationen für [[Cloud Computing|Cloud]]-verwandte Systeme, beispielsweise [[Kubernetes]] und [[Microsoft Azure]], hat das Format einige Kritik erhalten.<ref>[https://noyaml.com/ noyaml.com]</ref><ref>[https://ruudvanasseldonk.com/2023/01/11/the-yaml-document-from-hell ''The yaml document from hell''.] ruudvanasseldonk.com</ref>

Die angestrebte Vereinfachung der JSON-Syntax wird nach Meinung verschiedener Kritiker nicht erreicht. Die YAML-Spezifikation ist wesentlich länger als die Spezifikationen für [[JavaScript Object Notation|JSON]], [[TOML]] oder selbst die als umfangreich geltende [[Extensible Markup Language|XML]].<ref>{{Internetquelle |url=https://www.arp242.net/yaml-config.html#its-pretty-complex |titel=YAML: probably not so great after all |abruf=2022-07-01}}</ref> YAML weist beispielsweise eine Vielzahl an Datentypen, einschließlich Datums- und Zeitformaten auf, die fast alle ohne Anführungszeichen geschrieben werden können. Da Strings nicht in Anführungszeichen geschrieben werden müssen, führt das zu komplexen Regeln bei der Typisierung von Werten, deren Ergebnisse überraschend sein können:
<syntaxhighlight lang="yaml">
time: 04:30 # Uhrzeit als Ganzzahl: 16200
# d. h. Port-Weiterleitung in Containern muss für korrektes Ergebnis evtl. in Anführungszeichen stehen:
port-forwarding-bad: 24:24 # falsch, Uhrzeit
port-forwarding-good: 80:80 # korrekt, String

# Es gibt 22 Varianten für boolesches Wahr und Falsch:
- Don Corleone: Do you have faith in my judgment? # String
- Clemenza: Yes # Boolescher Wert Wahr (true)
- Don Corleone: Do I have your loyalty? # String

# Gleitkommazahlen werden immer als solche erfasst, falls möglich
python: 3.5.3 # String
postgres: 9.3 # Gleitkommazahl
</syntaxhighlight>
Hinzu kommen Schwierigkeiten wie mindestens neun Varianten für mehrzeilige Texte und die bereits erwähnten 22 Varianten für boolesche Werte, die es in der veralteten Version 1.1 gab und aus Variationen der Wörter "yes", "no", "true", "false", "on" und "off" bestehen.<ref>[https://yaml.org/type/bool.html yaml.org]</ref> Alle diese Schwierigkeiten lassen sich jedoch umgehen, indem man Strings immer in Anführungszeichen schreibt.

Tolerantes Parsing, welches Fehler weitestgehend vermeiden möchte (vergleiche [[JavaScript]]), kann zu unerwarteten Resultaten führen. Beispielsweise sind abgeschnittene YAML-Dokumente, die bei unvollständiger Dateispeicherung oder einem Netzwerkfehler auftreten können, meist noch gültig.

YAML ist standardmäßig unsicher und erlaubt beim Einlesen die Ausführung beliebigen Programmcodes in einer Vielzahl von Implementierungen.<ref>{{Internetquelle |url=https://github.com/yaml/pyyaml |titel=PyYAML yaml.load(input) Deprecation |werk=yaml/pyyaml |hrsg=github |sprache=en |abruf=2022-07-01}}</ref><ref>{{Internetquelle |url=https://lgtm.com/blog/swagger_snakeyaml_CVE-2017-1000207_CVE-2017-1000208 |titel=Arbitrary code execution via Swagger YAML parser (CVE-2017-1000207 and CVE-2017-1000208) |werk=LGTM Blog |datum=2018-06-28 |offline=1 |archiv-url=https://web.archive.org/web/20180628021903/https://lgtm.com/blog/swagger_snakeyaml_CVE-2017-1000207_CVE-2017-1000208 |archiv-datum=2018-06-28 |archiv-bot=2023-02-18 03:39:51 InternetArchiveBot |abruf=2022-07-01}}</ref><ref>{{Internetquelle |url=https://www.php.net/manual/en/function.yaml-parse.php#refsect1-function.yaml-parse-notes |titel=yaml_parse |werk=Manual |hrsg=PHP |abruf=2022-07-01}}</ref><ref>{{Internetquelle |url=https://ruby-doc.org/stdlib-2.4.0/libdoc/yaml/rdoc/YAML.html#module-YAML-label-Security |titel=Module: YAML (Ruby 2.4.0) |abruf=2022-07-01}}</ref> Obwohl die meisten Implementierungen eine sichere Alternative anbieten und teilweise die unsichere Einlesefunktion als veraltet markiert haben, stellen die unsicheren Funktionen den Standard dar.

== Implementierungen ==
YAML-Implementierungen existieren unter anderem in den Programmiersprachen [[C (Programmiersprache)|C]], [[C++]], [[C-Sharp|C#]], [[JavaScript]], [[ActionScript]], [[Perl (Programmiersprache)|Perl]], [[PHP]], [[Python (Programmiersprache)|Python]], [[Java (Programmiersprache)|Java]], [[R (Programmiersprache)|R]],<ref>{{Internetquelle |url=http://biostat.mc.vanderbilt.edu/wiki/Main/YamlR |titel=R YAML package |hrsg=Vanderbilt University, Department of Biostatistics |datum=2012-01-20 |sprache=en |abruf=2018-01-26 |offline=ja }}</ref> [[Ruby (Programmiersprache)|Ruby]], [[Rust (Programmiersprache)|Rust]]<ref>{{Internetquelle |autor=David Tolnay |url=https://docs.rs/serde_yaml/ |titel=Crate serde_yaml |sprache=en |abruf=2020-07-01}}</ref> sowie für die [[.NET (Oberbegriff)|.NET-Plattformen]].

== Ähnliche Techniken ==

Zu ähnlichen Formaten für Konfigurationsdateien siehe [[Konfigurationsdatei#Dateiformate]].

Mit [[JavaScript Object Notation|JSON]] existiert eine ähnliche Technik, die noch mehr am [[Objektmodell]] ([[Document Object Model|DOM]]) orientiert ist und aus der Programmiersprache [[JavaScript]] stammt. JSON ist eine echte Untermenge von YAML: Jedes JSON-Dokument ist in Version 1.2 von YAML ein valides YAML-Dokument.<ref>[https://www.yaml.org/spec/1.2/spec.html YAML Ain’t Markup Language (YAML) Version 1.2]</ref> Aus der [[Clojure]]-Welt stammt das [[Extensible Data Notation|EDN]]-Format, welches eine an JSON angelehnte, erweiterbare Syntax verwendet.

Auch für die grafische Notationssprache [[Unified Modeling Language|UML]] (Version 2) existiert eine textbasierte Alternative, die auf leichte Lesbarkeit für Menschen hin ausgelegt ist – die [[Human-Usable Textual Notation]] (HUTN). Das [[Metamodell]] von UML und HUTN ist jeweils [[Meta Object Facility|MOF]], sodass HUTN jedes UML-Diagramm als leicht lesbaren Text darstellen kann. Die leichte Lesbarkeit unterscheidet HUTN vom [[XML Metadata Interchange|XMI]]-Format, das für den Datenaustausch zwischen UML-Applikationen vorgesehen ist.

== Weblinks ==
* [https://yaml.org/ Offizielle Website]
** [https://yaml.org/spec/ YAML-Spezifikation] (englisch)
* [https://www.nt.ntnu.no/users/haugwarb/Programming/YAML/YAML_for_ruby.html YAML-Kochbuch für Ruby] (englisch)
* [https://codebeautify.org/yaml-validator YAML-Validator] YAML Lint (englisch)
* [https://onthegotools.com/yamltools/yaml-linter YAML Linter & Validator] Quickly validate and clean YAML files. (englisch)

== Einzelnachweise ==
<references />

[[Kategorie:Datenserialisierungformat]]
[[Kategorie:Beschreibungssprache]]
[[Kategorie:Abkürzung]]
[[Kategorie:Konfiguration (Computer)]]

YAML - Versionsgeschichte

imported>LWChris: /* Design-Ziele */ Nicht das Konzept macht es einfacher zu lesen, sondern die "schlanke" Syntax, welche durch das Konzept ermöglicht wird.