maa-convert(1)

📦
version 0.7.7 · 2 versions
, in nixpkgs unstable

okay bestie, welcome to maa-convert(1) — it lives in the General Commands Manual and it is literally the format-glow-up command you didn't know you needed 💅✨

🌸 NAME 🌸

maa-convert — Convert file format between TOML, YAML and JSON

🦋 SYNOPSIS 🦋

maa convert [-f|--format] [--batch] [-v|--verbose]... [-q|--quiet]...
[--log-file] [-h|--help] <INPUT> [OUTPUT]

💖 DESCRIPTION 💖

okay so real talk: this command converts a file from TOML, YAML or JSON format to another format. iconic behavior, no cap 💅

It is useful when you want to write your infrastructure configuration in TOML or YAML format, and use it in MaaCore, which only supports JSON format. the way MaaCore is lowkey picky about JSON? relatable but inconvenient 🫠

It may also be useful when you want to migrate your cli configuration from one format to another format. format migration slay 💖

✨ OPTIONS ✨

  • -f, --format <FORMAT> — Format of the output file, can be one of "toml", "yaml" and "json".

If not specified, the format will be guessed from the file extension of the output file. If output file is not specified, the output will be default to "json".

Possible values:

  • json
  • yaml
  • toml
  • --batch — Enable batch mode.

If there are some input parameters in the task file, some prompts will be displayed to ask for input. In batch mode, the prompts will be skipped, and parameters will be set to default values. very "don't ask me questions, just go" energy 🏃‍♀️💨

  • -v, --verbose — Increase verbosity, repeat for more verbosity. yes bestie, stack it like a little verbose tower 🗼
  • -q, --quiet — Decrease verbosity, repeat for more quiet. shhh era 🤫
  • --log-file[=<PATH>] — Redirect log to file instead of stderr.

If no log file is specified, the log will be written to $(maa dir log)/YYYY/MM/DD/HH:MM:SS.log.

  • -h, --help — Print help (see a summary with '-h').
  • <INPUT> — Path of the input file.
  • [OUTPUT] — Path of the output file, if not specified, the output will be printed to stdout.

Footer sign-off 💌: this page is tagged with convert and maa-convert(1) — that's the source/version + manual-label situation — and there is no date printed down here, so it is officially a cute undated icon 🎀 go convert something and serve format excellence, bestie 💜

📦 where this page comes from