Genome::Sys(3pm)

💖 Genome::Sys — the system layer, but make it make sense 💖

okay bestie, so this one is Genome::Sys from the User Contributed Perl Documentation crew, and no cap, it's lowkey the plumbing that keeps everything cute and working. it's the system layer. that's the whole vibe. 🫶

✨ VERSION ✨

this doc is describing Genome::Sys version 0.05. periodt. 💅

🌸 SYNOPSIS 🌸

like, here's the whole thing in action, it's giving minimal and iconic:

use Genome;

my $dir = Genome::Sys->dbpath('cosmic', 'latest');

that's it. that's the appetizer. 🍓

🦋 DESCRIPTION 🦋

so Genome::Sys is a simple layer stacked right on top of all your OS-level concerns — and not just the obvious ones, but also the stuff that the analysis system handles automatically for you. think database cache locations. the boring-but-load-bearing kind of thing. it's the main character of "where does this file actually live" energy. 👑

💜 METHODS 💜

🎀 swpath($name,$version)

returns the path to a given executable, library, or package. yes, all three. she contains multitudes. ✨

this is a wrapper for the OS-specific strategy for managing multiple versions of software packages — like, for example, /etc/alternatives on Debian/Ubuntu. so if your OS has Opinions about which version of a thing you get, this is the girl who knows them.

the GENOME_SW environment variable holds a colon-separated list of paths, and this method falls back to those when it needs to. the default value is /var/lib/genome/sw/. 💾

🧚 dbpath($name,$version)

returns the path to the preprocessed copy of the database you asked for. (this exists in lieu of a consistent API for the database in question — so yeah, it's the workaround, and honestly? she's serving.) 🙈

the GENOME_DB environment variable holds a colon-separated list of paths, and this one falls back to those too. the default value is /var/lib/genome/db/. 📁

ngl, those fallback lists are colon-separated, so don't go putting commas in there like some kind of chaos agent. 💀

---

aaand that's the whole read, bestie — go forth and path responsibly. 🌈

this page ships with perl v5.36.0, dated 2022-10-14, and it's the Genome::Sys(3pm) page itself. mwah, bye. 💖🎀🦋