FETCH_CIF_DICT(1)

💖 FETCH_CIF_DICT 💖

okay bestie, so this is fetch_cif_dict, a page from the General Commands Manual (that's section 1, the "you just type it in the terminal" section, iconic behavior honestly). Pull up a chair and let me tell you about her.

🌸 NAME 🌸

fetch_cif_dict — fetch cif_core.dic from the IUCr FTP site if a non-expired local copy does not exist.

like... she goes and gets the dictionary for you, but only if the one you already have is stale. queen of not doing unnecessary work 💅

✨ SYNOPSIS ✨

fetch_cif_dict --options

that's it. that's the whole vibe. just her and some options, no positional arguments, no drama. 🎀

🦋 DESCRIPTION 🦋

Fetch cif_core.dic from the IUCr FTP site if non-expired local copy does not exist.

literally the entire job description. if you've got a fresh copy sitting there, she's not gonna go bother the FTP server about it. if you don't, she will. it's giving "self-sufficient" and honestly? obsessed. 💖

👑 OPTIONS 👑

• --cache-duration 432000 — how long, in seconds, the file stays untouched before she considers it fair game to go refetch it (unless somebody forces her hand — see --force-overwrite). default is 432000. so yes, that's the number, respect the number. ⏳
• --mail-address fetcher@mail.com — the e-mail address that gets passed along to the FTP server so it knows who's on the other end. it's an identifier of the client using the service, basically. not mandatory, and there's no default, but bestie... they insist you declare it. they're not playing. 📧
• --force-overwrite — disregard the local file modification time AND the cache duration while fetching the requested file. she's going in regardless of how recently you touched that file. no respect for timestamps, only respect for your command. 🔥
• --no-force-overwrite — respect the local file modification time and the cache duration while fetching the requested file. this is the default, so if you don't say anything, this is the energy you're getting. polite queen. 🌸
• --silent, --quiet — suppress the extra messages about how the script is progressing. only fatal errors will be printed. she goes quiet, but if something is genuinely catastrophic she will tell you. 💀
• --verbose, --no-quiet — print additional messages about the progress of the script. she narrates. she's a talker. you asked for this. 🗣️
• --help, --usage — output a short usage message (this message, the one you're reading the vibes of right now) and exit. 🫶
• --version — output version information and exit. that's it, that's the whole flag. ⭐

🙈 REPORTING BUGS 🙈

found a bug in fetch_cif_dict? do not suffer in silence, bestie. report it using e-mail:

cod-bugs@ibt.lt

heads up: --mail-address has no default and isn't mandatory, but the page literally says they insist you declare it. so declare it. it costs you nothing and it's the polite thing to do. 💜

and that's the whole page, no cap. fetch_cif_dict(1) from the General Commands Manual, mwah 💅