TINA-CONVERT(1)

✨ TINA-CONVERT ✨ (section 1, general commands manual, bestie)

okay so real talk: this is tina-convert, the little glow-up machine for your tina database files. she takes a tree of stuff and re-represents it in a whole different format. no cap. πŸ’…


🌸 NAME 🌸

tina-convert β€” convert Tina database files from one format to another


πŸŽ€ SYNOPSIS πŸŽ€

tina-convert [-d | --debug] [-v | --verbose] convert [-I infmt]
             [-O outfmt] [-o target] source
tina-convert [-d | --debug] [-v | --verbose] list formats
tina-convert [-h | --help] [-V | --version]

so there's three whole moods she can be in, bestie. you can convert (the main character), you can list formats (she tells you what she can do), or you can hit -h / --help and -V / --version like a normal person. and yeah, -d / --debug and -v / --verbose are the global switches you can tack on. ✨


πŸ¦‹ DESCRIPTION πŸ¦‹

the tina-convert tool is used to read a tree of tina database items and represent it in a different format. it currently supports three formats, which you pass in via the -I and/or -O command-line options:

  • tina β€” the native tina database format. the og. the homegirl. πŸ‘‘
  • json β€” a hierarchical structure represented as a JSON object.
  • yaml β€” a hierarchical structure represented as a YAML object.

that's it, that's the menu. it's giving "small but mighty". 🫢


πŸ“ FILES πŸ“

here's the lil pipe situation, okay, pay attention:

  • if the source filename is specified as -, then tina-convert will read the data from its standard input stream.
  • if a target filename is not specified via the -o command-line option, or if it is specified as -, then tina-convert will write the converted entries to its standard output stream.

so basically - means "the vibes, not a file". iykyk. 🌈


⭐ EXIT STATUS ⭐

the tina-convert utility exits 0 on success, and >0 if an error occurs.

that's the whole thing. zero means slay, anything bigger means something went sideways. πŸ’€


πŸ’– EXAMPLES πŸ’–

reading the tina database and representing it as JSON

tina-convert convert -O json ~/.tina

doing the same but saving the result as a file

tina-convert convert -O json -o tina.json ~/.tina

reading that file and converting it back to the native format

tina-convert convert -I json -O tina tina.json
and yes, in that last one you're needlessly specifying the output format, because tina is the default for both input and output. she's being extra. let her. πŸ™ˆ

🌟 AUTHORS 🌟

the tina-convert tool, along with its documentation, is developed as part of the tina tool by Peter Pentchev ⟨roam@ringlet.net⟩.


and that's a wrap, bestie!! this page came to you from Debian, dated December 22, 2024 β€” go convert something cute πŸ’…βœ¨πŸŽ€

πŸ“¦ where this page comes from