CIF2JSON(1)

💖 cif2json(1) — the group chat version 💖

okay so bestie, welcome to cif2json, a lil General Commands Manual darling that lives in your terminal and is genuinely so good at what she does. no cap. 🎀

✨ NAME ✨

cif2json — parse a CIF file and print out the structure generated by the CIF parser. that's it, that's the whole vibe. it reads, it parses, it spills the structure. 💅

🌸 SYNOPSIS 🌸

cif2json [options] input.cif [input2.cif ...]

yes you can feed her more than one file. she's flexible like that. 🦋

🦋 DESCRIPTION 🦋

Parse CIF file and print out the structure generated by CIF parser. literally. that's the entire job description and she ate. 🔥

✨ OPTIONS ✨

• --fix-errors — try to fix syntax errors in the input CIF files that can be corrected unambiguously. she's a lil fixer-upper 🫶
• --dont-fix-errors, --no-fix-errors — do not try to fix syntax errors in input CIF files. this one is the default, so if you say nothing, nothing gets fixed. 🤷‍♀️
• --strict — strictly adhere to JSON syntax, i.e., make a top level list container for CIF data blocks and put comma (",") separators between consecutive CIF data blocks. very rules-following of her, we love a compliant queen 👑
• --no-strict, --relaxed, --stream, --concatenate — print a stream of JSON objects, where an object stands for a CIF data block. such output does not include comma (",") separators between top level objects, so streaming parsers have to be used. this is the default vibe. 🌈
• --canonical — print JSON objects with key-value pairs sorted in a canonical way. > the usage of this option is discouraged due to the added overhead. she'll do it but she will side-eye you 💀
• --no-canonical — print JSON object with key-value pairs sorted in the order Perl stores them. due to this, the outputs might differ between different runs of the script with identical parameters. yeah she's a lil chaotic, and this is the default. 🙈
• --use-c-parser — use Perl & C parser for CIF parsing. this is the default, the main character ✨
• --use-perl-parser — use Perl parser for CIF parsing. the understudy, but valid 💜
• --help,--usage — output a short usage message (this message) and exit. she tells you how to use her, then she leaves. iconic. 🎀
• --version — output version information and exit. she'll tell you who she is, then dip. 🌸

🫶 REPORTING BUGS 🫶

found a bug? not her fault but like, tell her people fr fr. report cif2json bugs using e-mail: cod-bugs@ibt.lt 📧

and that's the whole page bestie, no notes, she's perfect. this was CIF2JSON(1), section 1 of the General Commands Manual, and yes the footer is literally just her own name again because she contains multitudes. stay parsing, stay slaying, ily 💖✨🦋🎀💅