gus

🐻 Git user switcher for quickly switching between local git users

Installation

Install via Homebrew:

brew tap jamieweavis/gus
brew install gus

Usage

Help

Print usage and package information:

$ gus

gus 1.0.0 (https://github.com/jamieweavis/gus)

🐻 Git user switcher for quickly switching between local git users

Usage: gus <command>

COMMANDS
  <id>       Switch to user with the provided ID
  -          Switch to the previous user
  list, ls   List users and their IDs
  config     Open `~/.config/gus.toml` in your $EDITOR

Switch

Switch to a user by their ID:

$ gus 0
Switched git user to: Johnny <[email protected]>

Switch to the previous user:

$ gus -
Switched git user to: John Doe <[email protected]>

List

List users configured in your gus config file:

$ gus ls
* 0: Johnny <[email protected]>
  1: John Doe <[email protected]>

Edit

Edit your gus config file in your configured shell $EDITOR (alternatively you can manually edit the file at ~/.config/gus.toml, see the configuration section for more details):

$ gus edit

Configuration

When you run gus for the first time a ~/.config/gus.toml file is created. This file is used by gus to store your git users and is prepopulated with a your current git user.

As this is a Rust project, the config file is in TOML format. The config file is structured as follows:

Initial config file

previous_user = 0
current_user = 0

[[users]]
name = "<your current git user name>"
email = "<your current git user email>"

Additional users can be added to the users array by using Array of Tables syntax:

Example config file

previous_user = 1
current_user = 0

[[users]]
name = "Johnny"
email = "[email protected]"

[[users]]
name = "John Doe"
email = "[email protected]"

The previous_user and current_user fields are updated by gus when you switch users - you should not edit these fields manually.

Building Locally

Production

Compile a release binary of gus:

cargo build --release

Run the release binary:

cargo run --release

Development

Run gus in development mode:

cargo run

Install

Install the binary to your local crates:

cargo install --path .

Uninstall the binary from your local crates:

cargo uninstall gus

Built With

• Rust

Disclaimer

I'm not a Rust engineer, this is just for fun!

Related

• homebrew-gus - 🍺 Brew tap & formula for gus

License

This project is licensed under the MIT License - see the LICENSE file for details.