ai-cr 1.0.0__py3-none-any.whl → 2.0.0__py3-none-any.whl

{ai_cr-1.0.0.dist-info → ai_cr-2.0.0.dist-info}/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025 Vitalii Stepanenko
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2025 Vitalii Stepanenko
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

ai_cr-2.0.0.dist-info/METADATA

@@ -0,0 +1,215 @@
+Metadata-Version: 2.3
+Name: ai-cr
+Version: 2.0.0
+Summary: AI code review tool that works with any language model provider. It detects issues in GitHub pull requests or local changes—instantly, reliably, and without vendor lock-in.
+License: MIT
+Keywords: static code analysis,code review,code quality,ai,coding,assistant,llm,github,automation,devops,developer tools,github actions,workflows,git
+Author: Nayjest
+Author-email: mail@vitaliy.in
+Requires-Python: >=3.11,<4.0
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development
+Requires-Dist: GitPython (>=3.1.44,<4.0.0)
+Requires-Dist: ai-microcore (==4.0.0)
+Requires-Dist: anthropic (>=0.52.2,<0.53.0)
+Requires-Dist: ghapi (>=1.0.6,<1.1.0)
+Requires-Dist: google-generativeai (>=0.8.5,<0.9.0)
+Requires-Dist: jira (>=3.8.0,<4.0.0)
+Requires-Dist: typer (>=0.16.0,<0.17.0)
+Requires-Dist: unidiff (>=0.7.5,<0.8.0)
+Project-URL: Homepage, https://github.com/Nayjest/Gito
+Project-URL: Repository, https://github.com/Nayjest/Gito
+Description-Content-Type: text/markdown
+
+<h1 align="center"><a href="#"><img alt="Gito: AI Code Reviewer" src="press-kit/logo/gito-ai-code-reviewer_logo-180.png" align="center" width="180"></a></h1>
+<p align="center">
+<a href="https://pypi.org/project/gito.bot/" target="_blank"><img src="https://img.shields.io/pypi/v/gito.bot" alt="PYPI Release"></a>
+<a href="https://github.com/Nayjest/Gito/actions/workflows/code-style.yml" target="_blank"><img src="https://github.com/Nayjest/Gito/actions/workflows/code-style.yml/badge.svg" alt="PyLint"></a>
+<a href="https://github.com/Nayjest/Gito/actions/workflows/tests.yml" target="_blank"><img src="https://github.com/Nayjest/Gito/actions/workflows/tests.yml/badge.svg" alt="Tests"></a>
+<img src="https://github.com/Nayjest/Gito/blob/main/coverage.svg" alt="Code Coverage">
+<a href="https://github.com/Nayjest/Gito/blob/main/LICENSE" target="_blank"><img src="https://img.shields.io/static/v1?label=license&message=MIT&color=d08aff" alt="License"></a>
+</p>
+
+**Gito** is an open-source **AI code reviewer** that works with any language model provider.
+It detects issues in GitHub pull requests or local changes—instantly, reliably, and without vendor lock-in.
+
+Get consistent, thorough code reviews in seconds—no waiting for human availability.
+
+## ✨ Why Gito?
+
+- [⚡] **Lightning Fast:** Get detailed code reviews in seconds, not days — powered by parallelized LLM processing  
+- [🔧] **Vendor Agnostic:** Works with any language model provider (OpenAI, Anthropic, Google, local models, etc.)  
+- [🌐] **Universal:** Supports all major programming languages and frameworks  
+- [🔍] **Comprehensive Analysis:** Detect issues across security, performance, maintainability, best practices, and much more  
+- [📈] **Consistent Quality:** Never tired, never biased—consistent review quality every time  
+- [🚀] **Easy Integration:** Automatically reviews pull requests via GitHub Actions and posts results as PR comments  
+- [🎛️] **Infinitely Flexible:** Adapt to any project's standards—configure review rules, severity levels, and focus areas, build custom workflows 
+
+## 🎯 Perfect For
+
+- Solo developers who want expert-level code review without the wait
+- Teams looking to catch issues before human review
+- Open source projects maintaining high code quality at scale
+- CI/CD pipelines requiring automated quality gates
+
+✨ See [code review in action](https://github.com/Nayjest/Gito/pull/39#issuecomment-2906968729) ✨
+
+## 🚀 Quickstart
+
+### 1. Review Pull Requests via GitHub Actions
+
+Create a `.github/workflows/gito-code-review.yml` file:
+
+```yaml
+name: "Gito: AI Code Review"
+on:
+  pull_request:
+    types: [opened, synchronize, reopened]
+  workflow_dispatch:
+    inputs:
+      pr_number:
+        description: "Pull Request number"
+        required: true
+jobs:
+  review:
+    runs-on: ubuntu-latest
+    permissions: { contents: read, pull-requests: write } # 'write' for leaving the summary comment
+    steps:
+    - uses: actions/checkout@v4
+      with: { fetch-depth: 0 }
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with: { python-version: "3.13" }
+    - name: Install AI Code Review tool
+      run: pip install gito.bot~=2.0
+    - name: Run AI code analysis
+      env:
+        LLM_API_KEY: ${{ secrets.LLM_API_KEY }}
+        LLM_API_TYPE: openai
+        MODEL: "gpt-4.1"
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        PR_NUMBER_FROM_WORKFLOW_DISPATCH: ${{ github.event.inputs.pr_number }}
+      run: |
+        gito --verbose review
+        gito github-comment --token ${{ secrets.GITHUB_TOKEN }}
+    - uses: actions/upload-artifact@v4
+      with:
+        name: ai-code-review-results
+        path: |
+          code-review-report.md
+          code-review-report.json
+```
+
+> ⚠️ Make sure to add `LLM_API_KEY` to your repository’s GitHub secrets.
+
+💪 Done!  
+PRs to your repository will now receive AI code reviews automatically. ✨  
+See [GitHub Setup Guide](https://github.com/Nayjest/Gito/blob/main/documentation/github_setup.md) for more details.
+
+### 2. Running Code Analysis Locally
+
+#### Initial Local Setup
+
+**Prerequisites:** [Python](https://www.python.org/downloads/) 3.11 / 3.12 / 3.13  
+
+**Step1:** Install [gito.bot](https://github.com/Nayjest/Gito) using [pip](https://en.wikipedia.org/wiki/Pip_(package_manager)).
+```bash
+pip install gito.bot
+```
+
+> **Troubleshooting:**  
+> pip may be also available via cli as `pip3` depending on your Python installation.
+
+**Step2:** Perform initial setup
+
+The following command will perform one-time setup using an interactive wizard.
+You will be prompted to enter LLM configuration details (API type, API key, etc).
+Configuration will be saved to `~/.gito/.env`.
+
+```bash
+gito setup
+```
+
+> **Troubleshooting:**  
+> On some systems, `gito` command may not became available immediately after installation.  
+> Try restarting your terminal or running `python -m gito` instead.
+
+
+#### Perform your first AI code review locally
+
+**Step1:** Navigate to your repository root directory.  
+**Step2:** Switch to the branch you want to review.  
+**Step3:** Run following command
+```bash
+gito review
+```
+
+> **Note:** This will analyze the current branch against the repository main branch by default.  
+> Files that are not staged for commit will be ignored.  
+> See `gito --help` for more options.
+
+**Reviewing remote repository**
+
+```bash
+gito remote git@github.com:owner/repo.git <FEATURE_BRANCH>..<MAIN_BRANCH>
+```
+Use interactive help for details:
+```bash
+gito remote --help
+```
+
+## 🔧 Configuration
+
+Change behavior via `.gito/config.toml`:
+
+- Prompt templates, filtering and post-processing using Python code snippets
+- Tagging, severity, and confidence settings
+- Custom AI awards for developer brilliance
+- Output customization
+
+You can override the default config by placing `.gito/config.toml` in your repo root.
+
+
+See default configuration [here](https://github.com/Nayjest/Gito/blob/main/gito/config.toml).
+
+More details can be found in [📖 Configuration Cookbook](https://github.com/Nayjest/Gito/blob/main/documentation/config_cookbook.md)
+
+## 💻 Development Setup
+
+Install dependencies:
+
+```bash
+make install
+```
+
+Format code and check style:
+
+```bash
+make black
+make cs
+```
+
+Run tests:
+
+```bash
+pytest
+```
+
+## 🤝 Contributing
+
+**Looking for a specific feature or having trouble?**  
+Contributions are welcome! ❤️  
+See [CONTRIBUTING.md](https://github.com/Nayjest/Gito/blob/main/CONTRIBUTING.md) for details.
+
+## 📝 License
+
+Licensed under the [MIT License](https://github.com/Nayjest/Gito/blob/main/LICENSE).
+
+© 2025 [Vitalii Stepanenko](mailto:mail@vitaliy.in)
+

ai_cr-2.0.0.dist-info/RECORD

@@ -0,0 +1,26 @@
+gito/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+gito/__main__.py,sha256=MSmt_5Xg84uHqzTN38JwgseJK8rsJn_11A8WD99VtEo,61
+gito/bootstrap.py,sha256=ceeoSCD8RX4xKxWri_n0xx00aTFS6xPUHhAs3rKVP5o,2337
+gito/cli.py,sha256=qFY1ObA0-Ep19bNSEcwjn6KIu2OOSWDj6QGe_o7Ujoc,6555
+gito/commands/__init__.py,sha256=B2uUQsLMEsHfNT1N3lWYm38WSuQIHFmjiGs2tdBuDBA,55
+gito/commands/fix.py,sha256=OS829xVrLMLQqlol9AoxJMZ9qaAWRCSbUkVNszK96ws,5305
+gito/commands/gh_post_review_comment.py,sha256=oZh3kSRBx3cSMozI2llDEOVZ2WeT_5msXMLLCiLina4,1984
+gito/commands/gh_react_to_comment.py,sha256=4uUb39FnM45DO-wESQq6pUlO5AFvh0FSluCCTxkl8_g,6442
+gito/commands/repl.py,sha256=wDHWl2VyRK32hLZHImrhqpQNkWV3u3358fwDiA6D3iA,521
+gito/config.toml,sha256=iK0CeP3mynTnWIEsCi_jA9Gtb_UdAqwLC5nWHSTc-zc,17367
+gito/constants.py,sha256=9G4sZbqLBg13FYieJqkq_hzek4-smmL4KKYF64tovQQ,698
+gito/core.py,sha256=tp-eB_FIsZ2wffTiMrRLc_9MaFaGIky_ExWHWTf1DTk,9341
+gito/gh_api.py,sha256=syhM8sbs_lLNG53bfRHQpusO818nwXCl4jDxVY__IK0,1204
+gito/issue_trackers.py,sha256=nfib6zhvmL_zjRDCdZ0d6rMT4ZFJ3PxO5UORaJzb6gk,1495
+gito/pipeline.py,sha256=Nq5VUVrXVDXVVYX6nVSMX1CyhoWsNtSeTOQyNgQAsdE,2672
+gito/pipeline_steps/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+gito/pipeline_steps/jira.py,sha256=cgRSHoU6j0lcK6hQfhg950PEmIu3uWLGMKZbW3-H3mg,1683
+gito/pipeline_steps/linear.py,sha256=stCuTWgVF3SG1XNmIdNwelTDQzKE9PnJLIOS27wKavw,2376
+gito/project_config.py,sha256=XdpXsRDFWBNNpktbZDp9p-nbijyKjG_oD6UWzGZSLjM,2580
+gito/report_struct.py,sha256=tLhdmCPse3Jbo56y752vuGlndWY2f2g_mNFQ-BmJZGw,4160
+gito/utils.py,sha256=HpterYtjceVhklJe0w1n7PIQJk8MJFUYi4FiG-CzMqg,6418
+ai_cr-2.0.0.dist-info/LICENSE,sha256=VbdF_GbbDK24JvdTfnsxa2M6jmhsxmRSFeHCx-lICGE,1075
+ai_cr-2.0.0.dist-info/METADATA,sha256=GNna_ERoyIWezF_SD-1eSG5EALMe1b5HeDOyiaGbIEE,7951
+ai_cr-2.0.0.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
+ai_cr-2.0.0.dist-info/entry_points.txt,sha256=Ua1DxkhJJ8TZuLgnH-IlWCkrre_0S0dq_GtYRaYupWk,38
+ai_cr-2.0.0.dist-info/RECORD,,

{ai_cr-1.0.0.dist-info → ai_cr-2.0.0.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: poetry-core 2.1.2
+Generator: poetry-core 2.1.3
 Root-Is-Purelib: true
 Tag: py3-none-any

ai_cr-2.0.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+gito=gito.cli:main
+

{ai_code_review → gito}/__main__.py

@@ -1,4 +1,4 @@
-from .cli import main
-
-if __name__ == "__main__":
-    main()
+from .cli import main
+
+if __name__ == "__main__":
+    main()

{ai_code_review → gito}/bootstrap.py

@@ -1,62 +1,66 @@
-import logging
-import os
-from datetime import datetime
-
-import microcore as mc
-from ai_code_review.utils import is_running_in_github_action
-
-from .constants import ENV_CONFIG_FILE
-
-
-def setup_logging():
-    class CustomFormatter(logging.Formatter):
-        def format(self, record):
-            dt = datetime.fromtimestamp(record.created).strftime("%Y-%m-%d %H:%M:%S")
-            message, level_name = record.getMessage(), record.levelname
-            if record.levelno == logging.WARNING:
-                message = mc.ui.yellow(message)
-                level_name = mc.ui.yellow(level_name)
-            if record.levelno >= logging.ERROR:
-                message = mc.ui.red(message)
-                level_name = mc.ui.red(level_name)
-            return f"{dt} {level_name}: {message}"
-
-    handler = logging.StreamHandler()
-    handler.setFormatter(CustomFormatter())
-    logging.basicConfig(level=logging.INFO, handlers=[handler])
-
-
-def bootstrap():
-    """Bootstrap the application with the environment configuration."""
-    setup_logging()
-    logging.info("Bootstrapping...")
-    try:
-        mc.configure(
-            DOT_ENV_FILE=ENV_CONFIG_FILE,
-            USE_LOGGING=True,
-            EMBEDDING_DB_TYPE=mc.EmbeddingDbType.NONE,
-        )
-    except mc.LLMConfigError as e:
-        msg = str(e)
-        if is_running_in_github_action():
-            ref = os.getenv("GITHUB_WORKFLOW_REF", "")
-            if ref:
-                # example value: 'owner/repo/.github/workflows/ai-code-review.yml@refs/pull/1/merge'
-                ref = ref.split("@")[0]
-                ref = ref.split(".github/workflows/")[-1]
-                ref = f" (.github/workflows/{ref})"
-            msg += (
-                f"\nPlease check your GitHub Action Secrets "
-                f"and `env` configuration section of the corresponding workflow step{ref}."
-            )
-        else:
-            msg += (
-                "\nPlease run 'ai-code-review setup' "
-                "to configure LLM API access (API keys, model, etc)."
-            )
-        print(mc.ui.red(msg))
-        raise SystemExit(2)
-    except Exception as e:
-        logging.error(f"Unexpected configuration error: {e}")
-        raise SystemExit(3)
-    mc.logging.LoggingConfig.STRIP_REQUEST_LINES = [300, 15]
+import logging
+import os
+from datetime import datetime
+
+import microcore as mc
+import typer
+
+from .utils import is_running_in_github_action
+from .constants import HOME_ENV_PATH, EXECUTABLE
+
+
+def setup_logging():
+    class CustomFormatter(logging.Formatter):
+        def format(self, record):
+            dt = datetime.fromtimestamp(record.created).strftime("%Y-%m-%d %H:%M:%S")
+            message, level_name = record.getMessage(), record.levelname
+            if record.levelno == logging.WARNING:
+                message = mc.ui.yellow(message)
+                level_name = mc.ui.yellow(level_name)
+            if record.levelno >= logging.ERROR:
+                message = mc.ui.red(message)
+                level_name = mc.ui.red(level_name)
+            return f"{dt} {level_name}: {message}"
+
+    handler = logging.StreamHandler()
+    handler.setFormatter(CustomFormatter())
+    logging.basicConfig(level=logging.INFO, handlers=[handler])
+
+
+def bootstrap():
+    """Bootstrap the application with the environment configuration."""
+    setup_logging()
+    logging.info("Bootstrapping...")
+    try:
+        mc.configure(
+            DOT_ENV_FILE=HOME_ENV_PATH,
+            USE_LOGGING=True,
+            EMBEDDING_DB_TYPE=mc.EmbeddingDbType.NONE,
+        )
+    except mc.LLMConfigError as e:
+        msg = str(e)
+        if is_running_in_github_action():
+            ref = os.getenv("GITHUB_WORKFLOW_REF", "")
+            if ref:
+                # example value: 'owner/repo/.github/workflows/ai-code-review.yml@refs/pull/1/merge'
+                ref = ref.split("@")[0]
+                ref = ref.split(".github/workflows/")[-1]
+                ref = f" (.github/workflows/{ref})"
+            msg += (
+                f"\nPlease check your GitHub Action Secrets "
+                f"and `env` configuration section of the corresponding workflow step{ref}."
+            )
+        else:
+            msg += (
+                f"\nPlease run '{EXECUTABLE} setup' "
+                "to configure LLM API access (API keys, model, etc)."
+            )
+        print(mc.ui.red(msg))
+        raise SystemExit(2)
+    except Exception as e:
+        logging.error(f"Unexpected configuration error: {e}")
+        raise SystemExit(3)
+    mc.logging.LoggingConfig.STRIP_REQUEST_LINES = [300, 15]
+
+
+app = typer.Typer(pretty_exceptions_show_locals=False)