0.0
No release in over 3 years
Low commit activity in last 3 years
`git-context` provides a tool to manage conditional git config.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Runtime

~> 0.22
 Project Readme

git-context

CircleCI Status codecov

git-context provides a tool to manage conditional git config.

No more committing with the wrong email in a new repository. With git-context you can set up a context per directory. Any git repositories within the directory would use the git config specified for that directory.

Currently, the supported config values are:

  • user.name
  • user.email
  • user.signingKey

git-context uses git config conditional includes under the hood.

Installation

Install the git-context CLI via gem install.

    $ gem install git_context

Usage

First, set up git-context to hook into the user's ~/.git/config.

    $ git-context setup

Next, create one or more user profile to contain the user name and email address.

    $ git-context create_profile
    Please enter profile name: work
    Please enter the name to be used in git config: John Doe
    Please enter the email address to be used in git config: johndoe@company.com
    Please enter the signing key to be used in git config: ABCD1234

    $ git-context create_profile
    Please enter profile name: fun
    Please enter the name to be used in git config: Johnny
    Please enter the email address to be used in git config: johnny@wut.lol
    Please enter the signing key to be used in git config: ZYXV0987

Finally, create contexts to use a specified profile in a directory.

    $ git-context create_context
    Please enter working directory: /Users/john/work
    Please select from existing profiles: work
    
    $ git-context create_context
    Please enter working directory: /Users/john/fun
    Please select from existing profiles: fun

Now you can commit as different users easily.

    $ cd /Users/john/work/project/unicorn
    $ git config user.name
    John Doe
    $ git config user.email
    johndoe@company.com
    $ git config user.signingKey
    ABCD1234
    
    $ cd /Users/john/fun/lol/wut
    $ git config user.name
    Johnny
    $ git config user.email
    johnny@wut.lol
    $ git config user.signingKey
    ZYXV0987

Tip: You could also use git context. git recognizes git-context as a custom command.

Development

After checking out the repo, run bin/setup to install dependencies. Then, run rake spec to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the .gem file to rubygems.org.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/caalberts/git_context.

License

The gem is available as open source under the terms of the MIT License.