RACONVERT(1)

💖 RACONVERT — the glow-up page 💖

okay bestie, welcome to raconvert(1) from the General Commands Manual section, and no cap this tool is lowkey a whole vibe. it takes comma-separated ASCII argus(8) data and turns it into binary argus(8) data. that's it. that's the girl. ✨

---

🌸 SYNOPSIS 🌸

raconvert -r input -w output

that's the whole thing, she's simple, she's elegant, she's iconic. 🫶

---

✨ DESCRIPTION ✨

so like, Raconvert reads ASCII based files — either CSV or Json argus data — from a file or from stdin, and converts that ASCII representation over to binary argus format. literally a transmutation arc. 🔥

for raconvert to process the data correctly, the file should be created by ra.1 like programs, using the -c <char> option or the -M json mode, to specify the ASCII format. iykyk, you gotta tell her what flavour you're serving.

in the case of CSV files, column delimiters can be any non-ambiguous character, and they're automatically discovered from the file's title string. she just knows. 🧚

💀 heads up bestie: in the case of CSV files, because raconvert.1 expects the first valid string in the file to be a ra.1 column title line, the ra.1 program must use the equivalent of the -L 0 option. no title line, no service.

the file can present its column oriented data in any order, and raconvert will accomodate. she's flexible like that. 💅

duplicate columns on the same line are allowed, but the final value in the resulting argus record will be the last value encountered. periodt.

and!! raconvert.1 can read gzip and bzip2 compressed files, based on the file extension. compressed girlies stay winning. 🎀

---

👑 USES 👑

Raconvert is predominately used for reading ASCII represented archive data. argus data is routinely converted to ASCII for inspection and archiving, due to the good compressibility offered by gzip and others. not me being obsessed with storage efficiency 😭

argus data is also converted from binary to ASCII and back to binary, as a routine process to enforce content policies. the conversion, with ASCII inspection, ensures that specific data of interest isn't leaked. security queen behaviour fr fr. 🛡️✨

---

🌈 INVOCATION 🌈

the sacred rituals, copy them exactly bestie:

ra -L0 -c , -r argusfile > argus.ascii.csv
raconvert -r argus.ascii.csv -w argusfile

ra -M json -r argusfile > argus.json
raconvert -r argus.json -w argusfile

look at that. csv route, json route. two paths, one destiny. 🦋

---

💜 COPYRIGHT 💜

Copyright (c) 2000-2024 QoSient. All rights reserved.

---

⭐ SEE ALSO ⭐

• ra(1)
• rarc(5)
• argus(8)

go read those too, bestie, they're the supporting cast and they ate. 👑

---

🎀 FILES 🎀

(no files listed here, the girl left it blank, we respect the minimalist era 💅)

---

🫶 AUTHORS 🫶

Carter Bullard (carter@qosient.com).

main character energy from start to finish. 🌟

---

🙈 BUGS 🙈

(nothing listed, so either she's flawless or nobody's filed yet. both are valid. 😭)

---

raconvert 5.0.3 · 07 October 2023 · that's the version and the date, bestie, and that's the whole page. thanks for coming to my ted talk, go convert something. bye slay 💖✨