4 releases (2 breaking)

0.4.0 Feb 27, 2024
0.3.0 Feb 16, 2023
0.1.1 May 9, 2021
0.1.0 May 5, 2021

#564 in Development tools

Download history 141/week @ 2024-02-22 34/week @ 2024-02-29 7/week @ 2024-03-07 4/week @ 2024-03-14

186 downloads per month

MIT license

34KB
869 lines

Git Mob (Rust Edition)

git_mob_rs is a rust version of Git Mob.

Please see their readme and blog for more information on why this type of tool exists.

This Rust version was made because I felt like learning some Rust and applying it to a tool I use everyday at work. Since I use this everyday at work, one thing I did not like about git-mob was its speed. IMO, it shouldn't take ~50-120ms to set a template, so I wanted it to be faster by using a native implementation.

This version is not a one to one implementation. See the differences for more details.

"Hey this rust version exists too!" I actually didn't search for a native version until I added this readme. I probably should have done that. Well, if you need a more feature complete version, use theirs!

Usage

Add/edit/delete co-author

$ git edit-coauthors

This will edit ~/.config/git-coauthors (on Linux) with your default text editor. Use the following json syntax to make the file.

{
  "coauthors": {
    "fl": {
      "name": "First Last",
      "email": "firstlast@example.com"
    }
  }
}

The commands listed here to add/edit/delete also work.

Mobbing co-author

$ git mob fl

Or multiple:

$ git mob fl ab cd ef

Reset mob, going back solo

$ git solo

Install

Mac

brew install jplsek/tap/git-mob-rs

Linux

See the release page for binaries or build from source.

Windows

There is no installer, but there are executables that you can put somewhere. See the release page or build from source.

Cargo

cargo install git_mob_rs

Source

git clone https://github.com/jplsek/git-mob-rs && cd git-mob-rs
cargo install --path .

Differences

  • The XDG config directory is used by default (~/.config/git-coauthors) for the configuration, falling back to ~/.git-coauthors if it exists.
  • Since I primarily use the CLI, I won't make editor plugins related to git-mob-rs.

If someone else feels like making some of these missing features, feel free to submit a PR!

Benchmarks

Summary: Over 15x faster

git-solo

+ hyperfine --warmup 3 -- git-solo target/release/git-solo
Benchmark #1: git-solo
Time (mean ± σ):      80.4 ms ±  22.6 ms    [User: 84.4 ms, System: 7.7 ms]
Range (min … max):    70.0 ms … 166.5 ms    40 runs

Benchmark #2: target/release/git-solo
Time (mean ± σ):       4.3 ms ±   0.1 ms    [User: 4.4 ms, System: 0.7 ms]
Range (min … max):     4.2 ms …   4.9 ms    497 runs

Summary
'target/release/git-solo' ran
18.52 ± 5.22 times faster than 'git-solo'

git-mob

+ hyperfine --warmup 3 -- 'git-mob ts' 'target/release/git-mob ts'
Benchmark #1: git-mob ts
Time (mean ± σ):      88.5 ms ±  24.4 ms    [User: 93.0 ms, System: 8.8 ms]
Range (min … max):    80.1 ms … 223.4 ms    36 runs

Benchmark #2: target/release/git-mob ts
Time (mean ± σ):       4.4 ms ±   0.1 ms    [User: 4.4 ms, System: 0.7 ms]
Range (min … max):     4.3 ms …   5.0 ms    510 runs

Summary
'target/release/git-mob ts' ran
20.17 ± 5.59 times faster than 'git-mob ts'

Dependencies

~13–25MB
~387K SLoC