shell-utils 🛠️

A collection of useful shell scripts and wrappers for common shell interactions.

It provides the util command, which acts as a router to find and execute each individual script according to a query. All arguments are automatically forwarded to the scripts. It ships with autocompletion and global --help and --to-stdout flags.

For security reasons, the util router sets a predefined set of environment variables, including a strict $PATH.

Usage

util random generate -l 20 # this will execute ./scripts/random/generate.sh
                           # automatically forwarding all arguments.

Install

AUR

Install it with your favorite AUR helper.

yay -S shell-utils-git

APT (Debian and its derivatives)

echo "deb [trusted=yes] https://apt.fury.io/vncsmyrnk /" | sudo tee /etc/apt/sources.list.d/vncsmyrnk.list
sudo apt update && sudo apt install shell-utils

Nix

nix profile install github:vncsmyrnk/shell-utils

{
  inputs = {
    shell-utils = {
      url = "github:vncsmyrnk/shell-utils";
      inputs.nixpkgs.follows = "nixpkgs";
    };
  };
}

From source

shell-utils follows the standard GNU directives for make targets.

make install

Development

Use nix develop to get a Nix shell with all expected dependencies.