gitcon 1.0.0

A small utility to configure global Git settings interactively or via CLI.

Git Configurator ⚙️✨

Git Configurator is a Python-based utility that simplifies setting up your global Git configuration. It interactively guides you through selecting merge strategies, setting author details (including website), and choosing your commit signing preferences. Alternatively, you can configure everything via command-line arguments for automated setup.

Features 🚀

• Interactive Setup:
  Follow step-by-step prompts to configure merge options, author name/email, website, and GPG signing settings.
• Non-Interactive Mode:
  Use command-line arguments for quick, automated configuration.
• Global Git Configuration:
  Easily set up your Git environment with a single command.
• Integration with Kevin's Package-Manager:
  Installable via Kevin's Package-Manager under the alias gitconfig for global access.

Installation 📦

You can run the script directly:

python3 main.py --interactive

Or, if you have Kevin Package-Manager installed, install Git Configurator with:

pkgmgr install git-configurator

Then, use it globally via:

gitconfig --help

Usage 💻

• Interactive Mode:

  gitconfig --interactive
  

  Follow the on-screen prompts to set your Git configuration.

• Non-Interactive Mode:

  gitconfig --merge-option rebase --name "John Doe" --email "[e-mail]" --website "https://johndoe.com" --signing gpg --gpg-key YOUR_GPG_KEY
  

🔑 Using Your GPG Key with Git Configurator

To sign your Git commits with a GPG key, you must first identify your key ID. Follow these steps to find your GPG key ID:

1. List your available GPG keys:

gpg --list-secret-keys --keyid-format LONG

You will see output similar to:

/home/youruser/.gnupg/pubring.kbx
--------------------------------------------
sec   rsa4096/A1B2C3D4E5F6G7H8 2020-12-29 [SC]
      1234ABCD5678EFGH9012IJKL3456MNOP7890QRST
uid                 [ultimate] John Doe <[e-mail]>
ssb   rsa4096/Z9Y8X7W6V5U4T3S2 2020-12-29 [E]

The GPG key ID you need for Git configuration is the short form displayed after rsa4096/, in this example:

A1B2C3D4E5F6G7H8

2. Configure your GPG key with Git Configurator:

gitconfig --signing gpg --gpg-key R5T6Y7U8I9O0P1Q2

Replace R5T6Y7U8I9O0P1Q2 with your actual key ID from the output above.

License 📄

This project is licensed under the MIT License.

Author 👤

Kevin Veen-Birkenbach
veen.world

Acknowledgements 🤖💡

This script was created with the help of ChatGPT.

---

Happy configuring! 🎉