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.

Note

This project does not package the scripts dependencies, you need to ensure they are installed and available.

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

Roadmap

Check out the milestones section to know what's being currently developed.

The unstable branch is usually updated with soon to be available features.

Development

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