crackerjack 0.15.7__py3-none-any.whl → 0.15.9__py3-none-any.whl

crackerjack/.gitignore

@@ -1,4 +1,3 @@
-# Created by .ignore support plugin (hsz.mobi)
 /.idea
 /.pdm-python
 /.pdm.toml
@@ -11,6 +10,5 @@
 /tmp/
 /__pycache__/
 /*.pyc
-/.crackerjack.yaml
 /scratch/
 /.zencoder/

crackerjack/.pre-commit-config.yaml

@@ -1,6 +1,6 @@
 repos:
   - repo: https://github.com/pdm-project/pdm
-    rev: 2.24.0  # a PDM release exposing the hook
+    rev: 2.24.1  # a PDM release exposing the hook
     hooks:
       - id: pdm-lock-check
 #      - id: pdm-export
@@ -23,7 +23,7 @@ repos:
       - id: check-added-large-files
         name: check-added-large-files
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.11.6
+    rev: v0.11.7
     hooks:
       - id: ruff-format
       - id: ruff
@@ -71,11 +71,11 @@ repos:
       - id: bandit
         args: ["-c", "pyproject.toml"]
   - repo: https://github.com/RobertCraigie/pyright-python
-    rev: v1.1.399
+    rev: v1.1.400
     hooks:
       - id: pyright
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.11.6
+    rev: v0.11.7
     hooks:
       - id: ruff
       - id: ruff-format

crackerjack/__main__.py

@@ -32,6 +32,7 @@ class Options(BaseModel):
     clean: bool = False
     test: bool = False
     all: BumpOption | None = None
+    ai_agent: bool = False
 
     @classmethod
     @field_validator("publish", "bump", mode="before")
@@ -88,6 +89,12 @@ cli_options = {
         help="Run with `-x -t -p <micro|minor|major> -c` development options).",
         case_sensitive=False,
     ),
+    "ai_agent": typer.Option(
+        False,
+        "--ai-agent",
+        help="Enable AI agent mode with structured output.",
+        hidden=True,
+    ),
 }
 
 
@@ -104,6 +111,7 @@ def main(
     bump: BumpOption | None = cli_options["bump"],
     clean: bool = cli_options["clean"],
     test: bool = cli_options["test"],
+    ai_agent: bool = cli_options["ai_agent"],
 ) -> None:
     options = Options(
         commit=commit,
@@ -117,8 +125,14 @@ def main(
         clean=clean,
         test=test,
         all=all,
+        ai_agent=ai_agent,
     )
 
+    if ai_agent:
+        import os
+
+        os.environ["AI_AGENT"] = "1"
+
     runner = create_crackerjack_runner(console=console)
     runner.process(options)
 

crackerjack/crackerjack.py

@@ -1,7 +1,9 @@
 import io
+import os
 import platform
 import re
 import subprocess
+import time
 import tokenize
 import typing as t
 from contextlib import suppress
@@ -40,6 +42,7 @@ class OptionsProtocol(t.Protocol):
     publish: t.Any | None
     bump: t.Any | None
     all: t.Any | None
+    ai_agent: bool = False
 
 
 @dataclass
@@ -53,7 +56,7 @@ class CodeCleaner:
             if not str(file_path.parent).startswith("__"):
                 self.clean_file(file_path)
         if pkg_dir.parent.joinpath("__pycache__").exists():
-            pkg_dir.parent.joinpath("__pycache__").rmdir()
+            pkg_dir.parent.joinpath("__pycache__").unlink()
 
     def clean_file(self, file_path: Path) -> None:
         try:
@@ -486,22 +489,161 @@ class Crackerjack:
                 self.console.print("\nCleaning tests directory...\n")
                 self.code_cleaner.clean_files(tests_dir)
 
-    def _run_tests(self, options: OptionsProtocol) -> None:
-        if options.test:
-            self.console.print("\n\nRunning tests...\n")
-            test = ["pytest"]
-            if options.verbose:
-                test.append("-v")
-            result = self.execute_command(test, capture_output=True, text=True)
-            if result.stdout:
-                self.console.print(result.stdout)
-            if result.returncode > 0:
-                if result.stderr:
-                    self.console.print(result.stderr)
+    def _prepare_pytest_command(self, options: OptionsProtocol) -> list[str]:
+        """Prepare the pytest command with appropriate options."""
+        test = ["pytest"]
+        if options.verbose:
+            test.append("-v")
+
+        # Add optimized options for all packages to prevent hanging
+        test.extend(
+            [
+                "--no-cov",  # Disable coverage which can cause hanging
+                "--capture=fd",  # Capture stdout/stderr at file descriptor level
+                "--tb=short",  # Shorter traceback format
+                "--no-header",  # Reduce output noise
+                "--disable-warnings",  # Disable warning capture
+                "--durations=0",  # Show slowest tests to identify potential hanging tests
+                "--timeout=300",  # 5-minute timeout for tests
+            ]
+        )
+        return test
+
+    def _setup_test_environment(self) -> None:
+        """Set environment variables for test execution."""
+        # Set environment variables to improve asyncio behavior
+        os.environ["PYTHONASYNCIO_DEBUG"] = "0"  # Disable asyncio debug mode
+        os.environ["RUNNING_UNDER_CRACKERJACK"] = "1"  # Signal to conftest.py
+
+        # Set asyncio mode to strict to help prevent hanging
+        if "PYTEST_ASYNCIO_MODE" not in os.environ:
+            os.environ["PYTEST_ASYNCIO_MODE"] = "strict"
+
+    def _run_pytest_process(
+        self, test_command: list[str]
+    ) -> subprocess.CompletedProcess[str]:
+        """Run pytest as a subprocess with timeout handling and output capture."""
+        try:
+            # Use a timeout to ensure the process doesn't hang indefinitely
+            process = subprocess.Popen(
+                test_command,
+                stdout=subprocess.PIPE,
+                stderr=subprocess.PIPE,
+                text=True,
+                bufsize=1,
+                universal_newlines=True,
+            )
+
+            # Set a timeout (5 minutes)
+            timeout = 300
+            start_time = time.time()
+
+            stdout_data = []
+            stderr_data = []
+
+            # Read output while process is running, with timeout
+            while process.poll() is None:
+                if time.time() - start_time > timeout:
+                    self.console.print(
+                        "[red]Test execution timed out after 5 minutes. Terminating...[/red]"
+                    )
+                    process.terminate()
+                    try:
+                        process.wait(timeout=5)
+                    except subprocess.TimeoutExpired:
+                        process.kill()
+                    break
+
+                # Read output without blocking
+                if process.stdout:
+                    line = process.stdout.readline()
+                    if line:
+                        stdout_data.append(line)
+                        self.console.print(line, end="")
+
+                if process.stderr:
+                    line = process.stderr.readline()
+                    if line:
+                        stderr_data.append(line)
+                        self.console.print(f"[red]{line}[/red]", end="")
+
+                time.sleep(0.1)
+
+            # Get any remaining output
+            if process.stdout:
+                for line in process.stdout:
+                    stdout_data.append(line)
+                    self.console.print(line, end="")
+
+            if process.stderr:
+                for line in process.stderr:
+                    stderr_data.append(line)
+                    self.console.print(f"[red]{line}[/red]", end="")
+
+            returncode = process.returncode or 0
+            stdout = "".join(stdout_data)
+            stderr = "".join(stderr_data)
+
+            # Create a CompletedProcess object to match the expected interface
+            return subprocess.CompletedProcess(
+                args=test_command, returncode=returncode, stdout=stdout, stderr=stderr
+            )
+
+        except Exception as e:
+            self.console.print(f"[red]Error running tests: {e}[/red]")
+            return subprocess.CompletedProcess(test_command, 1, "", str(e))
+
+    def _report_test_results(
+        self, result: subprocess.CompletedProcess[str], ai_agent: str
+    ) -> None:
+        """Report test results and handle AI agent output if needed."""
+        if result.returncode > 0:
+            if result.stderr:
+                self.console.print(result.stderr)
+
+            if ai_agent:
+                # Use structured output for AI agents
+                self.console.print(
+                    '[json]{"status": "failed", "action": "tests", "returncode": '
+                    + str(result.returncode)
+                    + "}[/json]"
+                )
+            else:
                 self.console.print("\n\n❌ Tests failed. Please fix errors.\n")
-                raise SystemExit(1)
+            raise SystemExit(1)
+
+        if ai_agent:
+            # Use structured output for AI agents
+            self.console.print('[json]{"status": "success", "action": "tests"}[/json]')
+        else:
             self.console.print("\n\n✅ Tests passed successfully!\n")
 
+    def _run_tests(self, options: OptionsProtocol) -> None:
+        """Run tests if the test option is enabled."""
+        if options.test:
+            # Check if we're being called by an AI agent
+            ai_agent = os.environ.get("AI_AGENT", "")
+
+            if ai_agent:
+                # Use structured output for AI agents
+                self.console.print(
+                    '[json]{"status": "running", "action": "tests"}[/json]'
+                )
+            else:
+                self.console.print("\n\nRunning tests...\n")
+
+            # Prepare the test command
+            test_command = self._prepare_pytest_command(options)
+
+            # Set up the test environment
+            self._setup_test_environment()
+
+            # Run the tests
+            result = self._run_pytest_process(test_command)
+
+            # Report the results
+            self._report_test_results(result, ai_agent)
+
     def _bump_version(self, options: OptionsProtocol) -> None:
         for option in (options.publish, options.bump):
             if option:
@@ -546,22 +688,65 @@ class Crackerjack:
         return execute(cmd, **kwargs)
 
     def process(self, options: OptionsProtocol) -> None:
+        # Track actions performed for AI agent output
+        actions_performed = []
+
         if options.all:
             options.clean = True
             options.test = True
             options.publish = options.all
             options.commit = True
+
         self._setup_package()
+        actions_performed.append("setup_package")
+
         self._update_project(options)
+        actions_performed.append("update_project")
+
         self._update_precommit(options)
+        if options.update_precommit:
+            actions_performed.append("update_precommit")
+
         self._run_interactive_hooks(options)
+        if options.interactive:
+            actions_performed.append("run_interactive_hooks")
+
         self._clean_project(options)
+        if options.clean:
+            actions_performed.append("clean_project")
+
         self.project_manager.run_pre_commit()
+        actions_performed.append("run_pre_commit")
+
         self._run_tests(options)
+        if options.test:
+            actions_performed.append("run_tests")
+
         self._bump_version(options)
+        if options.bump or options.publish:
+            actions_performed.append("bump_version")
+
         self._publish_project(options)
+        if options.publish:
+            actions_performed.append("publish_project")
+
         self._commit_and_push(options)
-        self.console.print("\n🍺 Crackerjack complete!\n")
+        if options.commit:
+            actions_performed.append("commit_and_push")
+
+        # Check if we're being called by an AI agent
+        if getattr(options, "ai_agent", False):
+            # Use structured output for AI agents
+            import json
+
+            result = {
+                "status": "complete",
+                "package": self.pkg_name,
+                "actions": actions_performed,
+            }
+            self.console.print(f"[json]{json.dumps(result)}[/json]")
+        else:
+            self.console.print("\n🍺 Crackerjack complete!\n")
 
 
 def create_crackerjack_runner(

crackerjack/pyproject.toml

@@ -72,7 +72,7 @@ no-lines-before = [
 ]
 
 [tool.ruff.lint.mccabe]
-max-complexity = 12
+max-complexity = 13
 
 [tool.ruff.lint.pydocstyle]
 convention = "google"
@@ -101,6 +101,7 @@ exclude-deps = [
     "uv",
     "tomli-w",
     "google-crc32c",
+    "pytest-timeout",
 ]
 
 [tool.refurb]
@@ -149,7 +150,7 @@ pythonPlatform = "Darwin"
 
 [project]
 name = "crackerjack"
-version = "0.15.6"
+version = "0.15.8"
 description = "Default template for PDM package"
 requires-python = ">=3.13"
 readme = "README.md"
@@ -180,14 +181,15 @@ dependencies = [
     "pytest>=8.3.5",
     "pydantic>=2.11.3",
     "pdm-bump>=0.9.12",
-    "pdm>=2.24.0",
-    "uv>=0.6.14",
+    "pdm>=2.24.1",
+    "uv>=0.6.17",
     "pytest-cov>=6.1.1",
     "pytest-mock>=3.14.0",
     "tomli-w>=1.2.0",
     "pytest-asyncio>=0.26.0",
     "rich>=14.0.0",
     "typer>=0.15.2",
+    "pytest-timeout>=2.3.1",
 ]
 authors = [
     { name = "lesleslie", email = "les@wedgwoodwebworks.com" },

{crackerjack-0.15.7.dist-info → crackerjack-0.15.9.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: crackerjack
-Version: 0.15.7
+Version: 0.15.9
 Summary: Default template for PDM package
 Keywords: black,ruff,mypy,creosote,refurb
 Author-Email: lesleslie <les@wedgwoodwebworks.com>
@@ -27,20 +27,21 @@ Requires-Dist: pre-commit>=4.2.0
 Requires-Dist: pytest>=8.3.5
 Requires-Dist: pydantic>=2.11.3
 Requires-Dist: pdm-bump>=0.9.12
-Requires-Dist: pdm>=2.24.0
-Requires-Dist: uv>=0.6.14
+Requires-Dist: pdm>=2.24.1
+Requires-Dist: uv>=0.6.17
 Requires-Dist: pytest-cov>=6.1.1
 Requires-Dist: pytest-mock>=3.14.0
 Requires-Dist: tomli-w>=1.2.0
 Requires-Dist: pytest-asyncio>=0.26.0
 Requires-Dist: rich>=14.0.0
 Requires-Dist: typer>=0.15.2
+Requires-Dist: pytest-timeout>=2.3.1
 Description-Content-Type: text/markdown
 
 # Crackerjack: Elevate Your Python Development
 
 [![Code style: crackerjack](https://img.shields.io/badge/code%20style-crackerjack-000042)](https://github.com/lesleslie/crackerjack)
-[![Python Version](https://img.shields.io/badge/python-3.13-blue.svg)](https://www.python.org/downloads/)
+[![Python: 3.13+](https://img.shields.io/badge/python-3.13%2B-green)](https://www.python.org/downloads/)
 [![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
 [![uv](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/uv/main/assets/badge/v0.json)](https://github.com/astral-sh/uv)
 [![Checked with pyright](https://microsoft.github.io/pyright/img/pyright_badge.svg)](https://microsoft.github.io/pyright/)

{crackerjack-0.15.7.dist-info → crackerjack-0.15.9.dist-info}/RECORD

@@ -1,12 +1,12 @@
-crackerjack-0.15.7.dist-info/METADATA,sha256=1bdpFF2yF_9rktzsL5TnNXyAVreZ938C_UuqAA8IRSo,12863
-crackerjack-0.15.7.dist-info/WHEEL,sha256=tSfRZzRHthuv7vxpI4aehrdN9scLjk-dCJkPLzkHxGg,90
-crackerjack-0.15.7.dist-info/entry_points.txt,sha256=6OYgBcLyFCUgeqLgnvMyOJxPCWzgy7se4rLPKtNonMs,34
-crackerjack-0.15.7.dist-info/licenses/LICENSE,sha256=fDt371P6_6sCu7RyqiZH_AhT1LdN3sN1zjBtqEhDYCk,1531
+crackerjack-0.15.9.dist-info/METADATA,sha256=1I_OWQRrzahxxT8f5F8EieXlGDXSuAD0F9JGpMfhbco,12899
+crackerjack-0.15.9.dist-info/WHEEL,sha256=tSfRZzRHthuv7vxpI4aehrdN9scLjk-dCJkPLzkHxGg,90
+crackerjack-0.15.9.dist-info/entry_points.txt,sha256=6OYgBcLyFCUgeqLgnvMyOJxPCWzgy7se4rLPKtNonMs,34
+crackerjack-0.15.9.dist-info/licenses/LICENSE,sha256=fDt371P6_6sCu7RyqiZH_AhT1LdN3sN1zjBtqEhDYCk,1531
 crackerjack/.coverage,sha256=dLzPzp72qZEXohNfxnOAlRwvM9dqF06-HoFqfvXZd1U,53248
-crackerjack/.gitignore,sha256=ts3GBu94chiwTyOCNCMHau9M8XGrd1yajyHPAMo_Z84,219
+crackerjack/.gitignore,sha256=oho3dNx7a7y36_y9AsalCkssU4in0MMsNAANWdc-h1c,153
 crackerjack/.libcst.codemod.yaml,sha256=a8DlErRAIPV1nE6QlyXPAzTOgkB24_spl2E9hphuf5s,772
 crackerjack/.pdm.toml,sha256=dZe44HRcuxxCFESGG8SZIjmc-cGzSoyK3Hs6t4NYA8w,23
-crackerjack/.pre-commit-config.yaml,sha256=mpTonkoUwZAvITz6yzpsm-PTsKub8SUELz35V6leUlo,2456
+crackerjack/.pre-commit-config.yaml,sha256=69iH07bdH1eF45gNrJAp3LKQkmxTg38lniLg9U9oVq4,2456
 crackerjack/.pytest_cache/.gitignore,sha256=Ptcxtl0GFQwTji2tsL4Gl1UIiKa0frjEXsya26i46b0,37
 crackerjack/.pytest_cache/CACHEDIR.TAG,sha256=N9yI75oKvt2-gQU6bdj9-xOvthMEXqHrSlyBWnSjveQ,191
 crackerjack/.pytest_cache/README.md,sha256=c_1vzN2ALEGaay2YPWwxc7fal1WKxLWJ7ewt_kQ9ua0,302
@@ -23,6 +23,8 @@ crackerjack/.ruff_cache/0.11.2/4070660268492669020,sha256=FTRTUmvj6nZw_QQBp_WHI-
 crackerjack/.ruff_cache/0.11.3/9818742842212983150,sha256=U-4mT__a-OljovvAJvv5M6X7TCMa3dReLXx3kTNGgwU,224
 crackerjack/.ruff_cache/0.11.4/9818742842212983150,sha256=QF9j6-3MH_d0pDNotdbF2hlqCL66SxN8OLVKR3PZyZU,224
 crackerjack/.ruff_cache/0.11.6/3557596832929915217,sha256=yR2iXWDkSHVRw2eTiaCE8Eh34JPRUGc8vE3HYEEBk9k,224
+crackerjack/.ruff_cache/0.11.7/10386934055395314831,sha256=lBNwN5zAgM4OzbkXIOzCczUtfooATrD10htj9ASlFkc,224
+crackerjack/.ruff_cache/0.11.7/3557596832929915217,sha256=fKlwUbsvT3YIKV6UR-aA_i64lLignWeVfVu-MMmVbU0,207
 crackerjack/.ruff_cache/0.2.0/10047773857155985907,sha256=j9LNa_RQ4Plor7go1uTYgz17cEENKvZQ-dP6b9MX0ik,248
 crackerjack/.ruff_cache/0.2.1/8522267973936635051,sha256=u_aPBMibtAp_iYvLwR88GMAECMcIgHezxMyuapmU2P4,248
 crackerjack/.ruff_cache/0.2.2/18053836298936336950,sha256=Xb_ebP0pVuUfSqPEZKlhQ70so_vqkEfMYpuHQ06iR5U,248
@@ -51,7 +53,7 @@ crackerjack/.ruff_cache/0.9.9/12813592349865671909,sha256=tmr8_vhRD2OxsVuMfbJPdT
 crackerjack/.ruff_cache/0.9.9/8843823720003377982,sha256=e4ymkXfQsUg5e_mtO34xTsaTvs1uA3_fI216Qq9qCAM,136
 crackerjack/.ruff_cache/CACHEDIR.TAG,sha256=WVMVbX4MVkpCclExbq8m-IcOZIOuIZf5FrYw5Pk-Ma4,43
 crackerjack/__init__.py,sha256=r9SuEjHUrW99hFWifRk4ofmYPSgf9rblcnzqhdV5bP0,157
-crackerjack/__main__.py,sha256=iwoUyUB9j3e5lC5ViNAqW00eeoIx0xljNmWC04AiPaw,3707
-crackerjack/crackerjack.py,sha256=vyE3Ja42FmIlQMO10F1qBgl2KbSqMtTO4qs-HnW7kAk,22503
-crackerjack/pyproject.toml,sha256=cdAZIpMICUD8wQV1g6wYBZD-9OUl_3bq856BuU4tO10,4089
-crackerjack-0.15.7.dist-info/RECORD,,
+crackerjack/__main__.py,sha256=vgylaqzoqYUjYstAOQLOU-odCtYarb2oAFBQdzYdar0,4037
+crackerjack/crackerjack.py,sha256=IHe1JDIS3Ng_0VW4SjS0HNaKQrRLEu6KAr0bMOFZrro,29114
+crackerjack/pyproject.toml,sha256=uUQOPlQd4ULCUAMcurTger5BHxiZZJg3d6Z764HVXTQ,4140
+crackerjack-0.15.9.dist-info/RECORD,,