#executable #shim

app shim

Create shims for executables from config files

5 releases

0.1.4 Jan 1, 2023
0.1.3 Jan 1, 2023
0.1.2 Jan 1, 2023
0.1.1 Jan 1, 2023
0.1.0 Oct 25, 2022

#653 in Configuration

Custom license

18KB
345 lines

Shim

Create shims for executables from config files.

Stability Warning

API may change wildly until while the major version number is 0. Once this crate's version hits 1.0.0 api changes will only happen with major version bumps.

Installation

With Cargo

cargo install shim

Usage

Cli

shim --help

Shim config files

Motivation

Condensing configuration

My git configuration was scattered over too many places

  • Git allows arbitrary commands to be named with prefix git- and git will

  • My git config file defined aliases

[alias]
url = remote get-url origin
root = rev-parse --show-toplevel
commit = !cz commit
cz = !cz commit
  • My bashrc has a function that
    • adds pre/post hooks globally, for all git commands
    • overrides some git subcommands
function git() {
  # Run pre-commit first for immediate feedback
  pre-commit # TODO: only run on some git commands

  # Override functionality based on the first argument, the subcommmand
  case "$1" in
    'commit')
      cz commit
      ;;
    'init'|clone)
      # Run command before creating a new repo on filesystem
      git-track-repos --quiet "$@"
      # Unlike other commands, make sure to run the git operation still
      git "$@"
      ;;
    *)
      # Fall back to actual git for everything else
      git "${@}"
      ;;
  esac

  # Run these after any git operation completes
  git-track-repos # This is a program I wrote to keep track of all repos I've cloned
}
  • Git hooks

Forking fewer times when calling git

I've created quite a few hooks. I've written a tool for some of my hooks (TODO: publish that tool and link here) in rust. I plan for shim to be able to load shims from dynamic libraries instead of forking a bunch of processes

Dependencies

~14–26MB
~401K SLoC