| Name | stackspot-commit-helper JSON |
| Version |
0.1.5
JSON |
| download |
| home_page | None |
| Summary | Auto-commit tool integrated with Stackspot AI |
| upload_time | 2025-01-31 17:04:45 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | None |
| license | MIT |
| keywords |
git
commit
stackspot
ai
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# Stackspot Commit Helper
## Overview
The **Stackspot Commit Helper** is a Python tool that automates Git commit message generation using Stackspot AI. It analyzes your code changes and creates meaningful commit messages while handling the commit and push operations seamlessly.
## Features
- 🤖 **AI-Powered Commit Messages**: Generates contextual commit messages based on your code changes
- 🔄 **Automated Git Workflow**: Handles staging, commit and push operations
- 🔢 **Branch Number Integration**: Optional inclusion of branch numbers in commit messages
- ⚡ **Simple CLI Interface**: Easy to use command-line tool
- 🔐 **Secure Configuration**: Environment variable based configuration
## Stackspot Credentials
To use Stackspot's AI for commit message generation, you must set up credentials with the Stackspot Platform.
1. Create an account at Stackspot Platform.
2. Go to Stackspot AI.
3. Access Profile → Access Token.
4. Create new credentials and copy the following:
**Client ID**
**Client Secret**
**Realm**
## Installation
Install using pip:
```bash
pip install stackspot-commit-helper
```
After installation, set the following environment variables to configure the tool based on your system::
```bash
STACKSPOT_CLIENT_ID="your_client_id"
STACKSPOT_CLIENT_SECRET="your_client_secret"
STACKSPOT_REALM="your_realm"
QUICK_COMMAND_COMMIT="your_quick_command_name" # Optional: if your account has the 'generate-git-commit-message' command
```
## Usage
Once the tool is installed and configured, you can use it from the terminal:
**Commit and Push**
To run the tool and generate a commit message based on the code changes:
```bash
scommit
```
**Include Branch Number**
If you want to include the current branch number in your commit message, you can use the -b or --branch option:
```bash
scommit -b
```
This will prepend the branch number (if available) to the generated commit message, like [#123] - <commit_message>.
## Dependencies
**This tool requires the following Python packages:**
python-dotenv
– For loading environment variables from a .env file.
stackspot
– For interacting with Stackspot's AI services.
## Troubleshooting
**No Changes to Commit**
If the tool reports "No changes to commit", it means that there are no unstaged changes in your Git repository. Ensure that you have made changes before running the command.
**Stackspot API Error**
If there is an issue with the Stackspot API (e.g., invalid credentials or a failed execution), you will receive an error message. Make sure your Stackspot credentials are correct and try again.
## Contributing
Contributions are welcome! If you find a bug or have a feature request, feel free to open an issue or submit a pull request.
Raw data
{
"_id": null,
"home_page": null,
"name": "stackspot-commit-helper",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "git, commit, stackspot, ai",
"author": null,
"author_email": "Engeziellithon vieira <engeziellithonvieira@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/54/19/d30a3527530267a9be55ff6ac797844e3b45d2af73c90ae447dea4033620/stackspot_commit_helper-0.1.5.tar.gz",
"platform": null,
"description": "# Stackspot Commit Helper\r\n\r\n## Overview\r\n\r\nThe **Stackspot Commit Helper** is a Python tool that automates Git commit message generation using Stackspot AI. It analyzes your code changes and creates meaningful commit messages while handling the commit and push operations seamlessly.\r\n\r\n## Features\r\n\r\n- \ud83e\udd16 **AI-Powered Commit Messages**: Generates contextual commit messages based on your code changes\r\n- \ud83d\udd04 **Automated Git Workflow**: Handles staging, commit and push operations\r\n- \ud83d\udd22 **Branch Number Integration**: Optional inclusion of branch numbers in commit messages\r\n- \u26a1 **Simple CLI Interface**: Easy to use command-line tool\r\n- \ud83d\udd10 **Secure Configuration**: Environment variable based configuration\r\n\r\n## Stackspot Credentials\r\nTo use Stackspot's AI for commit message generation, you must set up credentials with the Stackspot Platform.\r\n\r\n1. Create an account at Stackspot Platform.\r\n2. Go to Stackspot AI.\r\n3. Access Profile \u2192 Access Token.\r\n4. Create new credentials and copy the following:\r\n\r\n **Client ID**\r\n\r\n **Client Secret**\r\n \r\n **Realm**\r\n\r\n## Installation\r\n\r\nInstall using pip:\r\n\r\n```bash\r\npip install stackspot-commit-helper\r\n```\r\n\r\nAfter installation, set the following environment variables to configure the tool based on your system::\r\n\r\n```bash\r\nSTACKSPOT_CLIENT_ID=\"your_client_id\"\r\nSTACKSPOT_CLIENT_SECRET=\"your_client_secret\"\r\nSTACKSPOT_REALM=\"your_realm\"\r\nQUICK_COMMAND_COMMIT=\"your_quick_command_name\" # Optional: if your account has the 'generate-git-commit-message' command\r\n```\r\n\r\n## Usage\r\nOnce the tool is installed and configured, you can use it from the terminal:\r\n\r\n**Commit and Push**\r\nTo run the tool and generate a commit message based on the code changes:\r\n\r\n```bash\r\nscommit\r\n```\r\n\r\n**Include Branch Number**\r\nIf you want to include the current branch number in your commit message, you can use the -b or --branch option:\r\n\r\n```bash\r\nscommit -b\r\n```\r\nThis will prepend the branch number (if available) to the generated commit message, like [#123] - <commit_message>.\r\n\r\n\r\n## Dependencies\r\n\r\n**This tool requires the following Python packages:**\r\n\r\npython-dotenv\r\n\u2013 For loading environment variables from a .env file.\r\n\r\nstackspot\r\n\u2013 For interacting with Stackspot's AI services.\r\n\r\n\r\n## Troubleshooting\r\n\r\n**No Changes to Commit**\r\n\r\nIf the tool reports \"No changes to commit\", it means that there are no unstaged changes in your Git repository. Ensure that you have made changes before running the command.\r\n\r\n**Stackspot API Error**\r\n\r\nIf there is an issue with the Stackspot API (e.g., invalid credentials or a failed execution), you will receive an error message. Make sure your Stackspot credentials are correct and try again.\r\n\r\n## Contributing\r\nContributions are welcome! If you find a bug or have a feature request, feel free to open an issue or submit a pull request.\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Auto-commit tool integrated with Stackspot AI",
"version": "0.1.5",
"project_urls": null,
"split_keywords": [
"git",
" commit",
" stackspot",
" ai"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "78cd18bcdc0f8d1b1a9a5165da2fb50e24fddcc7a66a39d7849b2a060e074fd3",
"md5": "9d571834579b1fe03944e4a3c299f526",
"sha256": "2f19b360974054e3b687e016dda2186da2efbb45998895b50a6939543cfe4420"
},
"downloads": -1,
"filename": "stackspot_commit_helper-0.1.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "9d571834579b1fe03944e4a3c299f526",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 8871,
"upload_time": "2025-01-31T17:04:43",
"upload_time_iso_8601": "2025-01-31T17:04:43.584537Z",
"url": "https://files.pythonhosted.org/packages/78/cd/18bcdc0f8d1b1a9a5165da2fb50e24fddcc7a66a39d7849b2a060e074fd3/stackspot_commit_helper-0.1.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "5419d30a3527530267a9be55ff6ac797844e3b45d2af73c90ae447dea4033620",
"md5": "39622f3a0e5cabcc34e839b5739eaffe",
"sha256": "8445e8a3e642157af278933ad8d4852afddfad7da7ffb25a39715ea96f6a8e15"
},
"downloads": -1,
"filename": "stackspot_commit_helper-0.1.5.tar.gz",
"has_sig": false,
"md5_digest": "39622f3a0e5cabcc34e839b5739eaffe",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 7811,
"upload_time": "2025-01-31T17:04:45",
"upload_time_iso_8601": "2025-01-31T17:04:45.563832Z",
"url": "https://files.pythonhosted.org/packages/54/19/d30a3527530267a9be55ff6ac797844e3b45d2af73c90ae447dea4033620/stackspot_commit_helper-0.1.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-31 17:04:45",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "stackspot-commit-helper"
}
