ai-cr 0.4.7__py3-none-any.whl → 0.5.0__py3-none-any.whl

ai_code_review/__main__.py

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

ai_code_review/bootstrap.py

@@ -1,7 +1,9 @@
 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
 
@@ -28,10 +30,33 @@ def bootstrap():
     """Bootstrap the application with the environment configuration."""
     setup_logging()
     logging.info("Bootstrapping...")
-    mc.configure(
-        DOT_ENV_FILE=ENV_CONFIG_FILE,
-        VALIDATE_CONFIG=False,
-        USE_LOGGING=True,
-        EMBEDDING_DB_TYPE=mc.EmbeddingDbType.NONE,
-    )
+    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 = [100, 15]

ai_code_review/cli.py

@@ -3,34 +3,79 @@ import logging
 import sys
 import os
 import shutil
+import requests
 
 import microcore as mc
 import async_typer
 import typer
-from .core import review
-from .report_struct import Report
+from ai_code_review.utils import parse_refs_pair
 from git import Repo
-import requests
 
+from .core import review
+from .report_struct import Report
 from .constants import ENV_CONFIG_FILE
 from .bootstrap import bootstrap
 from .project_config import ProjectConfig
-
-app = async_typer.AsyncTyper(
-    pretty_exceptions_show_locals=False,
-)
+from .utils import is_app_command_invocation
 
 
+app = async_typer.AsyncTyper(pretty_exceptions_show_locals=False)
+default_command_app = async_typer.AsyncTyper(pretty_exceptions_show_locals=False)
 if sys.platform == "win32":
     asyncio.set_event_loop_policy(asyncio.WindowsSelectorEventLoopPolicy())
 
 
+def main():
+    if is_app_command_invocation(app):
+        app()
+    else:
+        bootstrap()
+        default_command_app()
+
+
 @app.callback(invoke_without_command=True)
-def cli(ctx: typer.Context, filters=typer.Option("", "--filter", "-f", "--filters")):
+def cli(ctx: typer.Context):
     if ctx.invoked_subcommand != "setup":
         bootstrap()
-    if not ctx.invoked_subcommand:
-        asyncio.run(review(filters=filters))
+
+
+@default_command_app.async_command(name="review", help="Perform code review")
+@app.async_command(name="review", help="Perform code review")
+async def cmd_review(
+    refs: str = typer.Argument(
+        default=None,
+        help="Git refs to review, [what]..[against] e.g. 'HEAD..HEAD~1'"
+    ),
+    what: str = typer.Option(None, "--what", "-w", help="Git ref to review"),
+    against: str = typer.Option(
+        None,
+        "--against", "-vs", "--vs",
+        help="Git ref to compare against"
+    ),
+    filters: str = typer.Option(
+        "", "--filter", "-f", "--filters",
+        help="""
+        filter reviewed files by glob / fnmatch pattern(s),
+        e.g. 'src/**/*.py', may be comma-separated
+        """,
+    )
+):
+    _what, _against = parse_refs_pair(refs)
+    if _what:
+        if what:
+            raise typer.BadParameter(
+                "You cannot specify both 'refs' <WHAT>..<AGAINST> and '--what'. Use one of them."
+            )
+    else:
+        _what = what
+    if _against:
+        if against:
+            raise typer.BadParameter(
+                "You cannot specify both 'refs' <WHAT>..<AGAINST> and '--against'. Use one of them."
+            )
+    else:
+        _against = against
+    await review(what=_what, against=_against, filters=filters)
 
 
 @app.async_command(help="Configure LLM for local usage interactively")

ai_code_review/core.py

@@ -11,11 +11,18 @@ from .project_config import ProjectConfig
 from .report_struct import Report
 
 
-def get_diff(repo: Repo = None, against: str = "HEAD") -> PatchSet | list[PatchedFile]:
+def get_diff(
+    repo: Repo = None,
+    what: str = None,
+    against: str = None
+) -> PatchSet | list[PatchedFile]:
     repo = repo or Repo(".")
-    base = repo.remotes.origin.refs.HEAD.reference.name
-    logging.info(f"{base}...{against}")
-    diff_content = repo.git.diff(base, against)
+    if not against:
+        against = repo.remotes.origin.refs.HEAD.reference.name  # origin/main
+    if not what:
+        what = None  # working copy
+    logging.info(f"Reviewing {mc.ui.green(what or 'working copy')} vs {mc.ui.yellow(against)}")
+    diff_content = repo.git.diff(against, what)
     diff = PatchSet.from_string(diff_content)
     return diff
 
@@ -62,10 +69,14 @@ def make_cr_summary(cfg: ProjectConfig, report: Report, diff):
     ).to_llm() if cfg.summary_prompt else ""
 
 
-async def review(filters: str | list[str] = ""):
+async def review(
+    what: str = None,
+    against: str = None,
+    filters: str | list[str] = ""
+):
     cfg = ProjectConfig.load()
     repo = Repo(".")
-    diff = get_diff(repo=repo, against="HEAD")
+    diff = get_diff(repo=repo, what=what, against=against)
     diff = filter_diff(diff, filters)
     if not diff:
         logging.error("Nothing to review")
@@ -78,7 +89,7 @@ async def review(filters: str | list[str] = ""):
                 cfg.max_code_tokens
                 - mc.tokenizing.num_tokens_from_string(str(file_diff)),
             )
-            if file_diff.target_file != DEV_NULL
+            if file_diff.target_file != DEV_NULL and not file_diff.is_added_file
             else ""
         )
         for file_diff in diff

ai_code_review/utils.py

@@ -1,4 +1,8 @@
+import sys
+import os
 from pathlib import Path
+import typer
+
 
 _EXT_TO_HINT: dict[str, str] = {
     # scripting & languages
@@ -61,11 +65,20 @@ _EXT_TO_HINT: dict[str, str] = {
 }
 
 
-def syntax_hint(file_name: str) -> str:
+def syntax_hint(file_path: str | Path) -> str:
     """
-    Get the syntax hint for a file based on its extension.
+    Returns a syntax highlighting hint based on the file's extension or name.
+
+    This can be used to annotate code blocks for rendering with syntax highlighting,
+    e.g., using Markdown-style code blocks: ```<syntax_hint>\n<code>\n```.
+
+    Args:
+      file_path (str | Path): Path to the file.
+
+    Returns:
+      str: A syntax identifier suitable for code highlighting (e.g., 'python', 'json').
     """
-    p = Path(file_name)
+    p = Path(file_path)
     ext = p.suffix.lower()
     if not ext:
         name = p.name.lower()
@@ -73,3 +86,31 @@ def syntax_hint(file_name: str) -> str:
             return "dockerfile"
         return ""
     return _EXT_TO_HINT.get(ext, ext.lstrip("."))
+
+
+def is_running_in_github_action():
+    return os.getenv("GITHUB_ACTIONS") == "true"
+
+
+def is_app_command_invocation(app: typer.Typer) -> bool:
+    """
+    Checks if the current script is being invoked as a command in a target Typer application.
+    """
+    return (
+        (first_arg := next((a for a in sys.argv[1:] if not a.startswith('-')), None))
+        and first_arg in (
+            cmd.name or cmd.callback.__name__.replace('_', '-')
+            for cmd in app.registered_commands
+        )
+        or '--help' in sys.argv
+    )
+
+
+def parse_refs_pair(refs: str):
+    SEPARATOR = '..'
+    if not refs:
+        return None, None
+    if SEPARATOR not in refs:
+        return refs, None
+    what, against = refs.split(SEPARATOR)
+    return what or None, against or None

{ai_cr-0.4.7.dist-info → ai_cr-0.5.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: ai-cr
-Version: 0.4.7
+Version: 0.5.0
 Summary: LLM-agnostic GitHub AI Code Review Tool with integration to GitHub actions
 License: MIT
 Keywords: static code analysis,code review,code quality,ai,coding,assistant,llm,github,automation,devops,developer tools,github actions,workflows,git
@@ -16,8 +16,8 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development
 Requires-Dist: GitPython (==3.1.44)
-Requires-Dist: ai-microcore (==4.0.0.dev16)
-Requires-Dist: anthropic (==0.49.0)
+Requires-Dist: ai-microcore (==4.0.0.dev18)
+Requires-Dist: anthropic (==0.52.2)
 Requires-Dist: async-typer (==0.1.8)
 Requires-Dist: google-generativeai (==0.8.5)
 Requires-Dist: typer (==0.9.4)
@@ -70,7 +70,7 @@ jobs:
       uses: actions/setup-python@v5
       with: { python-version: "3.13" }
     - name: Install AI Code Review tool
-      run: pip install ai-code-review==0.4.1
+      run: pip install ai-code-review==0.5.0
     - name: Run AI code analysis
       env:
         LLM_API_KEY: ${{ secrets.LLM_API_KEY }}
@@ -151,7 +151,9 @@ pytest
 
 ## 🤝 Contributing
 
-We ❤️ contributions! See [CONTRIBUTING.md](https://github.com/Nayjest/ai-code-review/blob/main/CONTRIBUTING.md).
+**Looking for a specific feature or having trouble?**  
+Contributions are welcome! ❤️  
+See [CONTRIBUTING.md](https://github.com/Nayjest/ai-code-review/blob/main/CONTRIBUTING.md) for details.
 
 ## 📝 License
 

ai_cr-0.5.0.dist-info/RECORD

@@ -0,0 +1,15 @@
+ai_code_review/.ai-code-review.toml,sha256=z-3iliCvkkpdAr9l_yUyM-IbgRm9hbAA3CIV6ocuurY,10378
+ai_code_review/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+ai_code_review/__main__.py,sha256=MSmt_5Xg84uHqzTN38JwgseJK8rsJn_11A8WD99VtEo,61
+ai_code_review/bootstrap.py,sha256=b9BlhRgliwsjmWRCCZcsTivsOw9AbXOf8_AZYjQTx-c,2336
+ai_code_review/cli.py,sha256=L1utFMHs4D9HVcuJ1VC96PEvP6q26UHsfCz_Lq49VMg,4893
+ai_code_review/constants.py,sha256=K9mNxTq9seTG3aVm__3r1lXb5oCOQjH24Cl3hfX9FsE,281
+ai_code_review/core.py,sha256=WMGU2zwZTJ1P6PkUId-RJP7KHQbzB31GKSnI5wsedcA,4177
+ai_code_review/project_config.py,sha256=RDbplmncALKw0zgqSG8POofi300z0DPvtF33wt7_1Sk,3651
+ai_code_review/report_struct.py,sha256=N-EnNMwBY9LyJ9sdFHpUzn2fwBvxo5TZYYiJagBl8Po,3488
+ai_code_review/utils.py,sha256=UzFp2ShNzQvsydxJ98bdr_j2rBUHcm62pPtl6hBuZD4,2914
+ai_cr-0.5.0.dist-info/entry_points.txt,sha256=u0N5NroPYEGqmDGaGqFmiijJ5swzpe7EyKBupnkp1FY,49
+ai_cr-0.5.0.dist-info/LICENSE,sha256=XATf3zv-CppUSJqI18KLhwnPEomUXEl5WbBzFyb9OSU,1096
+ai_cr-0.5.0.dist-info/METADATA,sha256=k3FaB6nbVV0xbgZYPg_VQ6zMauB65Xy6CLWI4qFOMF0,5609
+ai_cr-0.5.0.dist-info/WHEEL,sha256=fGIA9gx4Qxk2KDKeNJCbOEwSrmLtjWCwzBz351GyrPQ,88
+ai_cr-0.5.0.dist-info/RECORD,,

ai_cr-0.5.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+ai-cr=ai_code_review.cli:main
+

ai_cr-0.4.7.dist-info/RECORD

@@ -1,14 +0,0 @@
-ai_code_review/.ai-code-review.toml,sha256=z-3iliCvkkpdAr9l_yUyM-IbgRm9hbAA3CIV6ocuurY,10378
-ai_code_review/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-ai_code_review/bootstrap.py,sha256=vhAWjrfhkyyA504YusXhBlndsXd_bg2RP9hQbfnvM1M,1280
-ai_code_review/cli.py,sha256=lulkEEUmQ1Fn3j3aQ0ZXc6aPHPcQDsr4YqA_C6gFFH4,3409
-ai_code_review/constants.py,sha256=K9mNxTq9seTG3aVm__3r1lXb5oCOQjH24Cl3hfX9FsE,281
-ai_code_review/core.py,sha256=LhstEanCpMD0rVEYja0EQ4GuwB47RXGJJNOTkD6WqYk,3888
-ai_code_review/project_config.py,sha256=RDbplmncALKw0zgqSG8POofi300z0DPvtF33wt7_1Sk,3651
-ai_code_review/report_struct.py,sha256=N-EnNMwBY9LyJ9sdFHpUzn2fwBvxo5TZYYiJagBl8Po,3488
-ai_code_review/utils.py,sha256=DLzX9kILl5ABAsuwqFJk_3kItjgzzeTUrgZ3RMnDgAY,1713
-ai_cr-0.4.7.dist-info/entry_points.txt,sha256=fQYGUz6CVCClhei9kNCTtJUX6ia-dTca6p1sZ9pnst8,48
-ai_cr-0.4.7.dist-info/LICENSE,sha256=XATf3zv-CppUSJqI18KLhwnPEomUXEl5WbBzFyb9OSU,1096
-ai_cr-0.4.7.dist-info/METADATA,sha256=QCXyksLtb1v8Jl8K5DE3p3nU6Nh-IEZv9XhI4G5vCf0,5530
-ai_cr-0.4.7.dist-info/WHEEL,sha256=fGIA9gx4Qxk2KDKeNJCbOEwSrmLtjWCwzBz351GyrPQ,88
-ai_cr-0.4.7.dist-info/RECORD,,

ai_cr-0.4.7.dist-info/entry_points.txt

@@ -1,3 +0,0 @@
-[console_scripts]
-ai-cr=ai_code_review.cli:app
-