+
+

更新履歴

+
    +
  1. + : デジタルサーカス株式会社の社内記事として公開 +
    2. +
  2. + : ブログ記事として一般公開 +
    3. +
+
+
+
+ NOTE +
+
+ この記事は、2021-06-30 にデジタルサーカス株式会社 の社内 Qiita Team に公開された記事をベースに、加筆修正して一般公開したものです。 +
+
+ +
+

はじめに

+

+ データ記述言語の一つ YAML には 1.0、1.1、1.2 のバージョンがある。 これらのうち、1.1 と 1.2 の間には無視できない非互換の変更が多く、1.2 に対応していないライブラリもある (Ruby 同梱の yaml など)。 この記事では、YAML 1.1 と YAML 1.2 の主な破壊的変更を紹介する (影響範囲が広いものを抜粋しており、すべての非互換を網羅してはいない)。 +

+ +

+ 参照した仕様書はこちら: https://yaml.org/spec/1.2.2/ext/changes/ +

+
+ +
+

主な破壊的変更

+
+

Boolean としてパースされるトークンが true / false とその亜種のみに

+

+ この変更の影響が最も大きいと思われる。 YAML 1.1 では、boolean 値のリテラルとして true、false のほか yes、no、y、n、on、off、それらの大文字バージョンなどが認められていた。 YAML 1.2 では、true と false、それらの大文字バージョン (True、TRUE、False、FALSE) のみが boolean としてパースされるようになった。 +

+
+ +
+

八進数リテラルには 0o が必須に

+

+ C 言語などでは、0 から始まる数字の列を八進数としてパースする。 YAML 1.1 もこれに準じていたが、1.2 からは 0o のプレフィクスが必須となった ("o" は "octal" の "o")。 プログラミング言語では、Python や Haskell、Swift、Rust などがこの記法を採用している。 +

+
+ +
+

<< によるマージが不可能に

+

+ YAML 1.1 では、<< という文字列をキーに指定することで、マップをマージすることができた。 +

+ + 
x: &base
+  a: 123
+# => { "x": { "a": 123 } }
+
+y:
+  <<: *base
+  b: 456
+# => { "y": { "a": 123, "b": 456 } }
+ +

+ 1.2 からはこれができなくなる。 +

+
+ +
+

数字を _ で区切るのが禁止に

+

+ 1234567 を 1_234_567 と書けなくなった。 +

+
+
+ +
+

おわりに

+

+ 全体的に、There's more than one way to do it. から There should be one - and preferably only one - obvious way to do it. へ移行しているように思われる。 データ記述言語としては望ましい方向性ではないかと感じる。 +

+
+