Mention `git config commit.template` in README. |
||
|---|---|---|
| src | ||
| .gitignore | ||
| .travis.yml | ||
| Cargo.lock | ||
| Cargo.toml | ||
| LICENSE | ||
| README.md | ||
README.md
Git-mob
A command-line tool for social coding
This is a CLI tool for including your co-authors in your commits.
It is essentially a Rust clone of the git-mob NPM package.
Install
Just run cargo install git_mob and you should be all set.
If it does not seem to work, try to run git config --glebal commit.template .git/.gitmessage to ensure that you have configured your your gitmessage
template to where git-mob is looking for it.
Examples
-
Add Alice, Bob, and yourself as a possible co-authors:
git add-coauthor a "Alice" alice@example.com git add-coauthor b "bob" Bob@example.com git add-coauthor me "me" myself.i@example.com -
Set Alice as co-author, making your mob consist of you and Alice:
git mob a -
Set both Alice and Bob as co-authors, making your mob consist of the three of you:
git mob a b -
Set Alice as the main author for any commits you make, since she is the one doing most of the thinking anyway, and add yourself as a mob member:
git mob -o a b me -
Edit Bob's name, since you accidentally capitalized his email instead of his name:
git edit-coauthor b --name "Bob" --email bob@example.com -
Remove Bob as a possible co-author:
git delete-coauthor b -
List all available co-authors:
git mob -l -
Go back to coding by yourself again:
git solo
Working features
git mob <co-author-initials>git add-coauthor <initials> "Co-author Name" <co-author-email-address>git -o <initials>for overwriting the main authorgit edit-coauthor [--name "Co-author Name"] [--email <co-author-email-address>]git delete-coauthor <initials>git mob -lgit solo
TODO
There are some missing features from the original NPM package, that are yet to be implemented, and then there is also a severe lack of tests and documentation.
Missing features
git mob-printgit suggest-coauthors--installTemplateand--uninstallTemplatefor prepare-commit-msg
Why clone an existing, working CLI tool?
Basically, I was looking for some decent size project to write in Rust, and I didn't have any other ideas.
The NPM package works just fine. There's just one thing that annoys me about it, and that is that I have to install it in once for every node version that is used in any repo I work in. With this approach, I only need to install it once.