gmsg 0.1.4__py3-none-any.whl → 0.1.5__py3-none-any.whl

gmsg/README.md

@@ -0,0 +1,121 @@
+# gmsg
+
+A command-line tool that automatically generates concise and meaningful Git commit messages using Google's Gemini model based on your staged changes.
+
+---
+
+## 🚀 Features
+
+* ✅ Detects if the current directory is a Git repository
+* ✅ Retrieves your staged changes via `git diff --cached`
+* ✅ Uses Gemini (for now) to generate a one-liner commit message
+* ✅ Allows you to:
+
+  * Accept the suggestion
+  * Edit the message in your preferred text editor
+  * Regenerate a new suggestion
+* ✅ Automatically commits the changes with your selected message
+
+---
+
+## 📦 Installation
+
+```bash
+pip install gmsg
+```
+
+---
+
+## 🛠️ Configuration
+
+Get your [Google Gemini API key](https://aistudio.google.com/app/apikey) if you don't have already.
+
+### 1. Set API key
+
+Enter your api key when package is used for the first time.
+
+```bash
+$ ENTER your API Key=
+```
+
+---
+
+## ⚙️ Usage
+
+1. Stage your changes:
+
+   ```bash
+   git add .
+   or 
+   git add <file>
+   ```
+
+2. Run the package:
+
+   ```bash
+   gmsg
+   ```
+
+3. Follow the prompts:
+
+   * Press `y/Y/enter` to commit with the suggested message
+   * Press `e` to edit the message in your default `$EDITOR` (e.g., `vim`)
+   * Press `n` to regenerate the commit message
+
+---
+
+## ✨ Example
+
+```bash
+$ git add some_file.py
+$ gmsg
+
+> Generate a one liner git commit message for these changes...
+> Added error handling in API response parser
+
+Do you want to continue with this message? [Y = yes / e = edit / n = no]: y
+Running: `git commit -m Added error handling in API response parser`
+Message committed to git. You can run `git commit --amend` to modify it.
+```
+
+---
+
+## 🧩 Requirements
+
+* Python 3.10+
+* [Google Generative AI SDK](https://pypi.org/project/google-generativeai/)
+* Git installed and available in your system path
+---
+
+## 📍 Roadmap
+
+Here are some upcoming features and improvements planned for this project:
+
+* [ ] **CLI Arguments Support**
+  Add flags like `--dry-run` for non-interactive use.
+
+* [ ] **Multi-line Commit Messages**
+  Option to generate more descriptive, multi-line messages with summaries and bullet points.
+
+* [ ] **Better Diff Parsing**
+  Use syntax-aware parsing to improve prompt context and generate more accurate commit messages.
+
+* [ ] **Git Hook Integration**
+  Provide an installable Git commit hook that auto-runs this tool on `git commit`.
+
+* [ ] **Support for Other LLMs**
+  Add support for OpenAI's GPT, Claude, or local models using plugins/adapters.
+
+---
+
+
+## 📝 License
+
+MIT License. Feel free to use, modify, and contribute!
+
+---
+
+## 🤝 Contributing
+
+Pull requests are welcome. For major changes, open an issue first to discuss what you'd like to change.
+

gmsg/gmsg.py

@@ -118,6 +118,7 @@ def printt(text: str, is_success: bool = True):
 
 def main():
     try:
+        user_api_key = get_or_set_api_key()
         if not is_git_repo():
             printt("Not a git repository.", is_success=False)
             sys.exit(1)
@@ -127,7 +128,6 @@ def main():
             printt("No staged changes found.", is_success=False)
             sys.exit(1)
 
-        user_api_key = get_or_set_api_key()
         cycle_through_messages(diff, user_api_key)
 
     except KeyboardInterrupt:

{gmsg-0.1.4.dist-info → gmsg-0.1.5.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: gmsg
-Version: 0.1.4
+Version: 0.1.5
 Summary: Generates git commit messages for you using AI.
 License: MIT
 Author: shiyan99s@gmail.com

gmsg-0.1.5.dist-info/RECORD

@@ -0,0 +1,9 @@
+gmsg/README.md,sha256=r08M-p_W2PtDdAEoapaqRCWZAKBbDCjYOEzE7CsNoKY,2676
+gmsg/__init__.py,sha256=9B4ZkbOBiBYYqv3Kh-mdlNn-yDPvkpXOqrm52Ng8CTk,23
+gmsg/api_key.py,sha256=73RAEjrcN6f1tc3cqaJ5888COTm4gnjQ4G7VRB3-CnQ,569
+gmsg/gmsg.py,sha256=SSmIomjS7c6JfWygp6aZApXvzS33qoNRpYuEcO46-mM,3871
+gmsg-0.1.5.dist-info/LICENSE,sha256=4gnFnu1ft89RQUn-ohdbqKLhpQ6-wHtq2eAOs1p6X6M,1071
+gmsg-0.1.5.dist-info/METADATA,sha256=Ds9Kf8kZJ9Dq4NMZDUU7oV5tNmvL4PappxLaMAWYvTM,609
+gmsg-0.1.5.dist-info/WHEEL,sha256=RaoafKOydTQ7I_I3JTrPCg6kUmTgtm4BornzOqyEfJ8,88
+gmsg-0.1.5.dist-info/entry_points.txt,sha256=LqLzIXT9IVenl_xEptCn4LqWHm34ypTaVMhoW5tFBSg,39
+gmsg-0.1.5.dist-info/RECORD,,

gmsg-0.1.4.dist-info/RECORD

@@ -1,8 +0,0 @@
-gmsg/__init__.py,sha256=9B4ZkbOBiBYYqv3Kh-mdlNn-yDPvkpXOqrm52Ng8CTk,23
-gmsg/api_key.py,sha256=73RAEjrcN6f1tc3cqaJ5888COTm4gnjQ4G7VRB3-CnQ,569
-gmsg/gmsg.py,sha256=bPHA3Unsoe6XqpsY8rc5qnZ-rQGNcEBiJSrtgBJvXGk,3871
-gmsg-0.1.4.dist-info/LICENSE,sha256=4gnFnu1ft89RQUn-ohdbqKLhpQ6-wHtq2eAOs1p6X6M,1071
-gmsg-0.1.4.dist-info/METADATA,sha256=5hAkqmK7DnukSCFt5M7y7m8b9F49QL5gjHbG1s09WRw,609
-gmsg-0.1.4.dist-info/WHEEL,sha256=RaoafKOydTQ7I_I3JTrPCg6kUmTgtm4BornzOqyEfJ8,88
-gmsg-0.1.4.dist-info/entry_points.txt,sha256=LqLzIXT9IVenl_xEptCn4LqWHm34ypTaVMhoW5tFBSg,39
-gmsg-0.1.4.dist-info/RECORD,,