DHALL-TO-YAML(1)

🦋 dhall-to-yaml 🦋

ok so bestie, this is the manual page for dhall-to-yaml — it lives in the User Commands section of the manual, and it's the little icon that takes your Dhall and turns it into YAML. no cap, that's the whole vibe. version 1.7.12, for the record. 💅

---

✨ NAME ✨

dhall-to-yaml — literally the manual page for dhall-to-yaml 1.7.12. that's it. that's the name section. 🎀

---

🌸 SYNOPSIS 🌸

dhall-to-yaml [[--explain] [--omit-empty | --preserve-null]
[--documents]
[--quoted] [[--key ARG] [--value ARG] | --no-maps]
       [--file FILE] [--output FILE] [--generated-comment]
       [--preserve-header] | --version]

---

💖 DESCRIPTION 💖

Compile Dhall to YAML. that's the whole job, and it does it gorgeously. 🫶

👑 Available options:

• -h, --help — show this help text. your emotional support flag fr.
• --explain — explain error messages in detail. when something breaks, this one gives you the full story instead of just vibes. 😭
• --omit-empty — omit record fields that are null or empty records. declutter the timeline, basically. ✨
• --preserve-null — preserve record fields that are null. the opposite energy of --omit-empty — nulls stay, bestie.
• --documents — if you hand it a Dhall list, it outputs a document for every element. each document, including the first one, gets preceded by ---, even if there's only one document. and if you don't give it a list? it outputs a single document (as if it were a list of one element). either way you're eating good. 🍓
• --quoted — prevent it from generating not-quoted scalars. yes, the double negative is in the original, we do not touch the sacred text. 🙈
• --key ARG — reserved key field name for association lists (default: mapKey). you can rename it, it's your world.
• --value ARG — reserved value field name for association lists (default: mapValue). same deal, different field. 💜
• --no-maps — disable conversion of association lists to homogeneous maps. sometimes you just want the list, okay? let it be a list.
• --file FILE — read the expression from a file instead of standard input. very demure, very file-based. 🎀
• --output FILE — write YAML to a file instead of standard output. go off, redirect your destiny.
• --generated-comment — include a comment header warning not to edit the generated file. it's giving protective older sibling. 🫶
• --preserve-header — translate any Dhall comment header to a YAML comment header. carry the lore across the format boundary. 🌈
• --version — display version. you already know it's 1.7.12 but like, confirmation is self-care. ⭐

lowkey important: --omit-empty and --preserve-null are on opposite sides of the | in the synopsis, so pick a side, bestie — you don't get both. same goes for [[--key ARG] [--value ARG] | --no-maps] — the map-renaming pair and --no-maps are alternatives in that bracket. the synopsis is the vibe check, respect it. 💀

---

that's the whole page, bestie — every flag, every default, every bracket, untouched and iconic. this was dhall-to-yaml 1.7.12, dated July 2024, signing off. slay, compile safely, and may your YAML always be valid. 🔥👑✨