INI2YAML(1)

💖 INI2YAML — the ini2yaml manual page 💖

okay bestie, welcome to ini2yaml(1), a User Command that does exactly one thing and does it flawlessly: it takes your dusty little INI config files and glow-ups them into YAML. no cap. 🌸

---

✨ NAME ✨

ini2yaml — convert INI configuration files to YAML format 🦋

---

✨ SYNOPSIS ✨

ini2yaml [-h] -f SOURCE [-nAPP_NAME] [-vVERSION] [-pPATH]

like. that's the whole vibe. four little flags and she's done. 💅

---

✨ DESCRIPTION ✨

so here's the tea ☕: this program converts INI configuration files (the ones with extensions .ini, .cf, or .conf) into YAML format. she can process either a single file or all valid files in a directory. output gets saved in the directory you specify, all formatted YAML-style. it's giving ✨glow up✨. periodt.

---

✨ OPTIONS ✨

• -h, --help — show the help message and dip. that's it, that's the whole job. 🙈
• -f SOURCE, --file SOURCE — specify the input source. required, bestie, she will not run without it. and it can be either of these two things:
  • a single INI file (.ini, .cf, or .conf extension)
  • a directory containing INI files
• -n APP_NAME, --name APP_NAME — specify the application name for the YAML metadata. default: 'app' 💜
• -v VERSION, --version VERSION — specify the configuration version. default: '1.0.0' ⭐
• -p PATH, --path PATH — specify the output directory. default: ${HOME}/yaml 🎀

---

🌈 PROCESSING DETAILS 🌈

the way she actually does the thing, step by step 🧚:

• converts each INI section to a YAML object
• preserves option values while stripping surrounding quotes
• adds metadata fields:
  • _default: original value from INI
  • _type: always 's' (string type)
• output filename: <APP_NAME>.yaml

---

🦋 ENVIRONMENT 🦋

• HOME — determines the default output directory when -p is not specified

---

🌸 EXAMPLES 🌸

convert single file with defaults:

ini2yaml -f /etc/dput.cf

convert directory with custom parameters:

ini2yaml -f ~/configs/ -n myapp -v 2.1.0 -p /tmp/output

process system configurations:

ini2yaml -f /etc/sysconfig/ -n system_cfg

---

👑 SEE ALSO 👑

• configparser(3python)
• PyYAML(3python)

---

💀 NOTES 💀

read these fr fr, they matter:

• nested INI sections are not supported
• all values are treated as strings
• existing YAML files will be overwritten 😭 (back up first, bestie, i'm begging)

---

💖 AUTHOR 💖

written for the UKUI project. iconic behavior honestly 🫶

---

and that's the whole page!! version v1.0, dated 2025-07-24. slay, go convert something, mwah 💅✨🎀