Metadata-Version: 2.1
Name: gittool
Version: 0.1.10
Summary: gittool
Author-Email: Jimmy Lin <b00502013@gmail.com>
License: MIT
Requires-Python: >=3.10
Requires-Dist: rich>=13.7.1
Description-Content-Type: text/markdown

# Gittool

Control Git config, SSH keys, and commit signing keys for multiple Git profiles.

# How to use

You may run it using `pipx`, but usually you want to set it as a `git` alias

```sh
...
[alias]
	use = "!pipx run --spec gittool==0.1.10 gittool-use"
...
```

You run it with `pipx`

```sh
# Create a new profile, including a new SSH key
> git use b00502013@gmail.com 'Jimmy Lin'
Created profile Jimmy Lin <b005020132@gmail.com>

# Create another profile
> git use contact@jimmylin.org 'Jimmy'
Created profile Jimmy <contact@jimmylin.org>

# Use it
> git use b00502013@gmail.com
Jimmy Lin <b005020132@gmail.com>

# Fuzzy matching is supported (only when purely activating a profile, not deleting or updating)
> git use cont
Jimmy <contact@jimmylin.org>

# List all profiles
> git use
* Jimmy <contact@jimmylin.org>
Created profile Jimmy Lin <b005020132@gmail.com>

# Delete a profile
> git use -d b00502013@gmail.com
Deleted profile Jimmy Lin <b005020132@gmail.com>

# Update profile name (`git`'s `user.name`)
> git use -u b00502013@gmail.com 'JL'
Updated profile as JL <b00502013@gmail.com>
```
