{"id":125594,"date":"2026-05-05T13:56:46","date_gmt":"2026-05-05T13:56:46","guid":{"rendered":"https:\/\/mailinvest.blog\/index.php\/2026\/05\/05\/stop-writing-json-by-hand-this-is-a-much-easier-way-to-handle-config-files\/"},"modified":"2026-05-05T13:57:54","modified_gmt":"2026-05-05T13:57:54","slug":"stop-writing-json-by-hand-this-is-a-much-easier-way-to-handle-config-files","status":"publish","type":"post","link":"https:\/\/mailinvest.blog\/index.php\/2026\/05\/05\/stop-writing-json-by-hand-this-is-a-much-easier-way-to-handle-config-files\/","title":{"rendered":"Stop writing JSON by hand, this is a much easier way to handle config files"},"content":{"rendered":"

<\/a>\n<\/p>\n

\n

JSON is a massively widespread format, used for configuration, API responses, sport save knowledge, and rather more. However it has its critics, and JSON isn’t the one possibility.<\/p>\n

<\/p>\n

YAML is definitely older than JSON, however despite the fact that it hasn\u2019t caught on to fairly the identical extent, it has loads to supply.<\/p>\n

<\/p>\n

\n What’s YAML, and what’s it used for?
\n <\/h2>\n

\n A markup language that\u2019s actually extra of a knowledge format
\n <\/h3>\n

YAML could be difficult to come up with at first; in spite of everything, its identify has modified that means over time, from But One other Markup Language to YAML Ain\u2019t Markup Language. (This kind of recursive acronym<\/a> is widespread within the tech world, particularly amongst Unix geeks.)<\/p>\n

To grasp YAML, it\u2019s helpful to discover what a markup language is<\/a>. In brief, a markup language combines a doc written in plain textual content with annotations that describe varied elements of that textual content. HTML is the best-known instance, a language that helps on-line publication, including hyperlinks, embedded photos, and construction to net pages.<\/p>\n

Different widespread markup languages embrace XML and SGML; these are strongly related to HTML, though they’ve completely different scopes and makes use of. There\u2019s also Markdown<\/a>, a extremely popular format that, regardless of its identify, can be a markup language.<\/p>\n

YAML isn’t actually a markup language, although, as its acronym change displays. YAML describes itself as a knowledge serialization language, which actually simply means it\u2019s a syntax for storing knowledge. Consider YAML as much less like HTML with knowledge and extra like JSON improved.<\/p>\n

\n
\n \"A\n <\/picture>\n<\/p><\/div>\n<\/p><\/div>\n

YAML dates again so far as 2001, however its first full launch was in 2004. It\u2019s been revised a handful of instances since, with the newest model touchdown in 2021. Its recordsdata sometimes use certainly one of two extensions: .yml or .yaml.<\/p>\n

<\/p>\n

\n How is YAML completely different from JSON?
\n <\/h2>\n

\n A bit like JSON with the tough edges sanded down
\n <\/h3>\n

JSON is YAML\u2019s closest well-known various. In truth, YAML is a superset of JSON, so any JSON file can be a legitimate YAML file. A easy YAML doc appears to be like very similar to JSON:<\/p>\n

identify:\n    first: Jane\n    final: Doe\nage: 28\nfunction: Engineer\n<\/code><\/pre>\n
The JSON equal of the above is:<\/p>\n
{\n    \"identify\":\n    {\n        \"first\": \"Jane\",\n        \"final\": \"Doe\"\n    },\n    \"age\": 28,\n    \"function\": \"Engineer\"\n}\n<\/code><\/pre>\n
At this degree, YAML actually isn\u2019t that a lot completely different, though it\u2019s undoubtedly a bit nicer to learn and write\u2014for people, not less than. The language removes all these quotes, brackets, and commas in favor of a construction implied by line breaks and indentation.<\/p>\n
\n
\n
\n
YAML indentation is vital, and it should consist solely of area characters, not tabs. In case you set your editor\u2019s tab width to a big worth for YAML recordsdata, you\u2019ll rapidly spot any invalid indents.<\/p>\n<\/p><\/div>\n<\/p><\/div>\n<\/section>\n
YAML makes use of some constructs which can be acquainted from Markdown, like a set of rows, every starting with a hyphen to characterize a listing:<\/p>\n
fruits:\n    - Apple\n    - Banana\n    - Cherry\n<\/code><\/pre>\n
You’ll be able to simply mix the syntax for dictionaries (maps) and lists, in no matter hierarchy you want:<\/p>\n
\n
\n                                                                                            \"A\n        <\/picture>\n<\/p><\/div>\n<\/p><\/div>\n
 YAML additionally helps multi-line strings, which many JSON customers will welcome. The primary kind, the literal block, preserves line breaks. It\u2019s helpful once they convey that means:<\/p>\n
handle: |\n  1600 Pennsylvania Avenue NW\n  Washington, D.C.\n  20500\n<\/code><\/pre>\n
The opposite kind is known as a folded block, and it treats line breaks as areas:<\/p>\n
data: >\n  Folding permits lengthy traces to be damaged\n  wherever a single area character\n  separates two non-space characters.\n<\/code><\/pre>\n
The folded kind helps you to lay out paragraphs nonetheless you need, a lot the identical means that Markdown and HTML do.<\/p>\n
    <\/p>\n
\n                        The place is YAML utilized in the true world?
\n               <\/h2>\n
\n            Config recordsdata and DevOps have been vital adopters
\n    <\/h3>\n
Amusingly, the official YAML web site presents itself in YAML syntax:<\/p>\n
\n
\n                                                                                            \"The\n        <\/picture>\n<\/p><\/div>\n<\/p><\/div>\n
 Though it\u2019s intelligent, it demonstrates that YAML is best at representing knowledge than it’s at structuring the contents of net pages!<\/p>\n
YAML is commonly used for configuration recordsdata, particularly by extra trendy applications. For instance, looking out my consumer config listing for YAML recordsdata provides me the next:<\/p>\n
\n
\n                                                                                            \"The\n        <\/picture>\n<\/p><\/div>\n<\/p><\/div>\n
 Aside from gh, the GitHub command-line consumer, these are all TUI apps<\/a> with a contemporary strategy to configuration that differs from extra conventional approaches like INI recordsdata, scripts, or bespoke codecs.<\/p>\n
The gh config file demonstrates a superb use of YAML:<\/p>\n
\n
\n                                                                                            \"yaml-gh-config\"\n        <\/picture>\n<\/p><\/div>\n<\/p><\/div>\n
 This config file has smart defaults, clean values performing as templates, and feedback to clarify every setting. It is a marked enchancment on JSON, which doesn’t straight help feedback\u2014until you\u2019re using JSONC<\/a>.<\/p>\n
DevOps instruments like Docker<\/a> and Kubernetes<\/a> have adopted YAML, not less than partly for its ease of readability. The previous\u2019s Compose file<\/a> and the latter\u2019s object spec files<\/a> each use YAML.<\/p>\n
In the meantime, the yq tool<\/a> does for YAML what jq does for JSON<\/a>: it helps you to course of a YAML file, extracting knowledge from it or updating it.<\/p>\n
You need to use yq to transform JSON to YAML:<\/p>\n
yq -P -oy file.json\n<\/code><\/pre>\n
You’ll be able to edit knowledge with it, like this instance, which finds an merchandise in an array, then adjustments it:<\/p>\n
yq '(.[] | choose(.identify == \"foo\") | .handle) = \"12 cat st\"'\n<\/code><\/pre>\n\n
\n            When YAML works, it\u2019s excellent
\n    <\/h3>\n
YAML isn\u2019t at all times a more sensible choice than JSON, which has higher interoperability because the extra established format. However YAML\u2019s benefits are fairly vital, so it\u2019s no shock that, for configuration and associated duties, it\u2019s typically most popular.<\/p>\n<\/p><\/div>\n