Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ayakovlenko/zit
git identity manager
https://github.com/ayakovlenko/zit
configuration-management git git-identity
Last synced: 11 days ago
JSON representation
git identity manager
- Host: GitHub
- URL: https://github.com/ayakovlenko/zit
- Owner: ayakovlenko
- License: mit
- Created: 2020-04-10T10:10:25.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2024-10-16T07:24:31.000Z (22 days ago)
- Last Synced: 2024-10-17T21:12:58.369Z (21 days ago)
- Topics: configuration-management, git, git-identity
- Language: Go
- Homepage:
- Size: 79.1 KB
- Stars: 16
- Watchers: 4
- Forks: 2
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# zit
_git identity manager_
## How it works
_zit_ chooses a git identity based on:
1. git remote host
2. repository owner
3. repository name
… as defined in the configuration file:
```yaml
users:
work: &work_user
name: "John Doe"
email: "[email protected]"
personal:
github_user: &personal_github_user
name: "JD42"
email: "[email protected]"
gitlab_user: &personal_gitlab_user
name: "JD42"
email: "[email protected]"
hosts:
github.com:
default: *personal_github_user
overrides:
- owner: "corp"
user: *work_user
gitlab.com:
default: *personal_gitlab_user
```
## Setup
There are 4 ways to set up a configuration file:
1. Specify an environment variable that points to the config file:
```bash
export ZIT_CONFIG=/custom-location/.zit-config.yaml
```
If the environment variable is set up, it will be chosen over the configs at the
default locations.
2. Place it in [XDG_CONFIG_HOME](https://specifications.freedesktop.org/basedir-spec/0.6/) location: `$XDG_CONFIG_HOME/.zit/config.yaml`
3. Place it in `.config` location: `$HOME/.config/zit/config.yaml`
4. Place it at the default location: `$HOME/.zit/config.yaml`
## Usage
To set up an identity, run `zit set` inside a repo directory:
```bash
$ zit set # personal repo
set user: jdoe
$ git remote get-url origin
https://github.com/jdoe/repo.git
```
```bash
$ zit set # work repo
set user: John Doe
$ git remote get-url origin
[email protected]:team/repo.git
```
**Note**: Use `--dry-run` flag to test which identity will be used without
applying it.
## Installation
**On Mac/Linux with Homebrew**
```bash
brew tap ayakovlenko/tools
brew install ayakovlenko/tools/zit
```
**From sources**
```bash
git clone https://github.com/ayakovlenko/zit.git
cd zit
go install
```
**From binaries**
Download binaries from the
[releases](https://github.com/ayakovlenko/zit/releases) page.
## Setup
**Remove any existing global identity**
```bash
git config --unset-all --global user.name
git config --unset-all --global user.email
git config --unset-all --system user.name
git config --unset-all --system user.email
```
**Require config to exist in order to make commits**
```bash
git config --global user.useConfigOnly true
```
Without the global user name and user email, git would use the system's hostname
and username to make commits. Tell git to throw an error instead, requiring you
to specify an identity for every new project.
Run `zit doctor` to make sure the system is configured correctly:
```bash
$ zit doctor
- [x] git config --global user.useConfigOnly true
- [x] git config --unset-all --global user.name
- [x] git config --unset-all --global user.email
- [x] git config --unset-all --system user.name
- [x] git config --unset-all --system user.email
```