SHTK_IMPORT(3)

💖 NAME 💖

shtk_import — Loads an shtk module, bestie. Yep, this is the SHTK_IMPORT(3) page and we're making it adorable. 🫶

📚 LIBRARY 📚

Built-in function; automatically loaded. No cap, it's already here for you. ✨

🌸 SYNOPSIS 🌸

shtk_import module

🧚 DESCRIPTION 🧚

Okay so shtk_import imports the shtk module specified by module into the currently-running script. Requests to import a module are idempotent, so it's totally acceptable to import the same module multiple times. (Idempotent = doing it again doesn't break the vibe. 💅)

Modules are first searched for in the collection of directories provided by the user in the colon-separated environment variable SHTK_MODULESPATH. If this variable is not defined, or if the module is not found in any of the specified directories, then the built-in directory /nix/store/risfks95a9rh0wddw5yr65c7xzcabf8j-shtk-1.7/share/shtk is used. 🔍

Because shell scripts have no namespaces, an import of a module makes the module available script-wide regardless of where the import happens. Therefore, it is possible for an import of a module to import other modules, and for those indirectly-imported modules to be visible in your script. Good programming practice dictates that you should not rely on these implicit imports and always explicitly declare all the modules you use. (Like, be a main character who explicitly declares every module they use. 👑)

🚨 ERRORS 🚨

The requested module must exist, so shtk_import aborts execution if the module is not present. No module, no service, bestie. 😭

🌈 ENVIRONMENT 🌈

• SHTK_MODULESDIR — Overrides the built-in location of the modules. Defaults to /nix/store/risfks95a9rh0wddw5yr65c7xzcabf8j-shtk-1.7/share/shtk. 🎀
• SHTK_MODULESPATH — Colon-separated list of directories in which to look for modules. SHTK_MODULESDIR is always implied at the end of the path. The user can define this variable to point to other directories. This is especially handy in packages that install custom modules and want to use such modules before installing them. 🦋

📁 FILES 📁

• /nix/store/risfks95a9rh0wddw5yr65c7xzcabf8j-shtk-1.7/share/shtk/ — Location of the built-in shtk_import modules. 💖

👀 SEE ALSO 👀

• shtk(3)

🕰️ HISTORY 🕰️

shtk_import first appeared in shtk 1.0. ⭐

---

💖 That's the whole page, bestie! This SHTK_IMPORT(3) manpage comes from Debian, dated November 4, 2014, and the built-in path above is shtk 1.7. Byeee! 💅✨