This directory contains shell one-offs which solve focused problems. Generally, scwrypts are a better source for long-term maintenance, but, for a few selected scenarios, a raw shell script is preferred. This is typically due to:

The simplicity of the script outweighs the maintenance overhead for an equivalent scwrypt
The overhead of scwrypts causes excessive slowdowns for quick, simple tasks

Reference / Usage

All scripts in this directory support and can be used in one of two ways:

Direct reference through ${DOTWRYN}/config/bin/${script_name}
Symlinked on the user's ${PATH}

Direct Reference

Anytime a raw script is referenced throughout the dotwryn repository, it should be referenced with direct reference. dotwryn-internal operations must not assume the user has a symlink to any of these functions.

Symlink

An API for human users! All the scripts in this directory allow for symlinking.

# you can decide where it goes
ln -s "${DOTWRYN}/config/bin/${script_name}" "${somewhere_on_users_path}/${local_script_name}"

# since ~/.local/bin is on MY ${PATH} (and I want it to have the same name)
cd ~/.local/bin
ln -s "${DOTWRYN}/config/bin/${script_name}"