Metadata-Version: 2.1
Name: git-identity
Version: 1.0.1
Summary: Quickly set user.name and user.email for a repository, based on a config file
Home-page: https://github.com/aatifsyed/git-identity
License: MIT
Author: Aatif Syed
Author-email: aatifsyedyp@gmail.com
Requires-Python: >=3.8,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Requires-Dist: GitPython (>=3.1.18,<4.0.0)
Requires-Dist: argcomplete (>=1.12.3,<2.0.0)
Requires-Dist: dataclasses-json (>=0.5.4,<0.6.0)
Requires-Dist: jsonschema (>=3.2.0,<4.0.0)
Requires-Dist: logging-actions (>=0.1.6,<0.2.0)
Requires-Dist: xdg (>=5.1.0,<6.0.0)
Project-URL: Repository, https://github.com/aatifsyed/git-identity
Description-Content-Type: text/markdown

# `git-identity`
Quickly set user.name and user.email for a repository, based on a config file. 
Available on [pypi](https://pypi.org/project/git-identity/).
## Installation
Recommended installation is with [`pipx`](https://pypi.org/project/pipx):
```bash
pipx install git-identity
```
### Autocompletion
Autocompletion is done with [`argcomplete`](https://pypi.org/project/argcomplete/). 
Install, and add the following to your shell's startup scripts:
```bash
eval "$(register-python-argcomplete git-identity)"
```
## Configuration
This project will look for `git-identity.json` in the XDG config folder (typically `$HOME/.config/`).
```json
{
    "identities" : {
        "<alias>": {
            "name": "Alex Ample",
            "email": "alexample@example.com"
        }
    }
}
```
`alias` is what is used when invoking the command.
## Usage
After installation, you [may use this as a git subcommand](https://github.com/git/git/blob/670b81a890388c60b7032a4f5b879f2ece8c4558/Documentation/howto/new-command.txt) (though argcomplete only works when you invoke it as `git-identity`)
```bash
git identity <alias>
```

