# 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

```bash
cargo install shim
```

## Usage

### Cli

```bash
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

```toml
[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

```bash
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