cif-diff(1)

📦
version 2.0.0 · 3 versions
, in ubuntu stonking

💖 cif-diff — the mmCIF glow-up comparer 💖

okay bestie, so this is cif-diff(1), a lil User Commands icon from the cif-tools crew, and it's about to become your new obsession. ✨

🌸 NAME 🌸

<cute>not a typo, this is literally the name section:</cute>

cif-diff — a tool to compare two mmCIF files. that's it. that's the job. 💅

🦋 SYNOPSIS 🦋

cif-diff [OPTION] file1 file2

✨ DESCRIPTION ✨

okay so here's the tea 🍵: the mmCIF format does NOT specify the order in which categories or fields should be recorded. like, it just does not care. chaotic of it, honestly. 💀

so what cif-diff does is: it takes a second file and reorders it in the same way as the first file, before it compares the content. that way the diff is actually about content and not about "omg why are these two files in a different order for no reason". it makes it way easier to spot the actual differences. main character problem-solving energy, fr fr. 👑

🎀 OPTIONS 🎀

  • --category=arg — limits the comparison to this category only. the default is to show differences in all categories. you can specify this option multiple times, so go off, stack 'em up. 🌈
  • --max-diff-count=nr — displays at most nr items per category. the default is 5 items. if you specify zero, the number of items will be unlimited. ✨
heads up bestie: this option has no effect when the --text option is specified. none. zero. nada. 🙈
  • --text — default behaviour is to display the differences in some kind of summary. but if you prefer a more graphical diff, this option will use vimdiff to display the differences. very visual, very slay. 💜
  • --icase — passes the ignore case option to vimdiff. 🧚
  • --iwhite — passes the ignore white option to vimdiff. 🌸
  • --verbose, -v — be more verbose. useful to diagnose validation errors. when things are going weird, this is the one you call, no cap. 🔥

👑 AUTHOR 👑

Written by Maarten L. Hekkelman <maarten@hekkelman.com> — thank you for the tool king 🫶

😭 REPORTING BUGS 😭

Report bugs at https://github.com/PDB-REDO/cif-tools/issues — go tell 'em, they wanna know 💌

🌟 SEE ALSO 🌟

cif-grep, cif-merge, cif-validate, cif2pdb, mmcql, pdb2cif.

the whole friend group honestly — go say hi to all of them 💖

so yeah, that's the whole thing! this was version 2.0.0, dated 2022-11-20, and it's out here living its best life as cif-diff(1). 🦋✨ go diff some mmCIF files, you got this bestie, ily 🎀💅

📦 where this page comes from