crackerjack 0.20.1__py3-none-any.whl → 0.20.2__py3-none-any.whl

crackerjack/pyproject.toml

@@ -4,7 +4,7 @@ requires = [ "pdm-backend" ]
 
 [project]
 name = "crackerjack"
-version = "0.20.0"
+version = "0.20.1"
 description = "Crackerjack: code quality toolkit"
 readme = "README.md"
 keywords = [

{crackerjack-0.20.1.dist-info → crackerjack-0.20.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: crackerjack
-Version: 0.20.1
+Version: 0.20.2
 Summary: Crackerjack: code quality toolkit
 Keywords: bandit,black,creosote,mypy,pyright,pytest,refurb,ruff
 Author-Email: lesleslie <les@wedgwoodwebworks.com>
@@ -192,9 +192,35 @@ Crackerjack provides advanced testing capabilities powered by pytest:
 ### Standard Testing
 
 - **Parallel Test Execution:** Tests run in parallel by default using pytest-xdist for faster execution
-- **Timeout Protection:** All tests have a default 60-second timeout to prevent hanging tests
+- **Smart Parallelization:** Automatically adjusts the number of worker processes based on project size
+- **Timeout Protection:** Tests have dynamic timeouts based on project size to prevent hanging tests
 - **Coverage Reports:** Automatically generates test coverage reports with configurable thresholds
 
+### Advanced Test Configuration
+
+Crackerjack offers fine-grained control over test execution:
+
+- **Worker Control:** Set the number of parallel workers with `--test-workers` (0 = auto-detect, 1 = disable parallelization)
+- **Timeout Control:** Customize test timeouts with `--test-timeout` (in seconds)
+- **Project Size Detection:** Automatically detects project size and adjusts timeout and parallelization settings
+- **Deadlock Prevention:** Uses advanced threading techniques to prevent deadlocks in test output processing
+- **Progress Tracking:** Shows periodic heartbeat messages for long-running tests
+
+Example test execution options:
+```bash
+# Run tests with a single worker (no parallelization)
+python -m crackerjack -t --test-workers=1
+
+# Run tests with a specific number of workers (e.g., 4)
+python -m crackerjack -t --test-workers=4
+
+# Run tests with a custom timeout (5 minutes per test)
+python -m crackerjack -t --test-timeout=300
+
+# Combine options for maximum control
+python -m crackerjack -t --test-workers=2 --test-timeout=600
+```
+
 ### Benchmark Testing
 
 Crackerjack includes benchmark testing capabilities:
@@ -278,10 +304,16 @@ class MyOptions:
         # Process options
         self.clean = True            # Clean code (remove docstrings, comments, etc.)
         self.test = True             # Run tests using pytest
+        self.skip_hooks = False      # Skip running pre-commit hooks
+
+        # Test execution options
+        self.test_workers = 2        # Number of parallel workers (0 = auto-detect, 1 = disable parallelization)
+        self.test_timeout = 120      # Timeout in seconds for individual tests (0 = use default based on project size)
+
+        # Benchmark options
         self.benchmark = False       # Run tests in benchmark mode
         self.benchmark_regression = False  # Fail tests if benchmarks regress beyond threshold
         self.benchmark_regression_threshold = 5.0  # Threshold percentage for benchmark regression
-        self.skip_hooks = False      # Skip running pre-commit hooks
 
         # Version and publishing options
         self.publish = None          # Publish to PyPI (micro, minor, major)
@@ -321,6 +353,8 @@ runner.process(MyOptions())
 -   `-s`, `--skip-hooks`: Skip running pre-commit hooks (useful with `-t`).
 -   `-x`, `--clean`: Clean code by removing docstrings, line comments, and extra whitespace.
 -   `-t`, `--test`: Run tests using `pytest`.
+-   `--test-workers`: Set the number of parallel workers for testing (0 = auto-detect, 1 = disable parallelization).
+-   `--test-timeout`: Set the timeout in seconds for individual tests (0 = use default based on project size).
 -   `--benchmark`: Run tests in benchmark mode (disables parallel execution).
 -   `--benchmark-regression`: Fail tests if benchmarks regress beyond threshold.
 -   `--benchmark-regression-threshold`: Set threshold percentage for benchmark regression (default 5.0%).
@@ -356,6 +390,28 @@ runner.process(MyOptions())
   python -m crackerjack -t -s
   ```
 
+#### Test Execution Options
+
+- **Single-Process Testing** - Run tests sequentially (no parallelization):
+  ```bash
+  python -m crackerjack -t --test-workers=1
+  ```
+
+- **Customized Parallel Testing** - Run tests with a specific number of workers:
+  ```bash
+  python -m crackerjack -t --test-workers=4
+  ```
+
+- **Long-Running Tests** - Increase test timeout for complex tests:
+  ```bash
+  python -m crackerjack -t --test-timeout=600
+  ```
+
+- **Optimized for Large Projects** - Reduce workers and increase timeout for large codebases:
+  ```bash
+  python -m crackerjack -t --test-workers=2 --test-timeout=300
+  ```
+
 #### Version Management
 
 - **Bump and Publish** - Bump version and publish to PyPI:

{crackerjack-0.20.1.dist-info → crackerjack-0.20.2.dist-info}/RECORD

@@ -1,7 +1,7 @@
-crackerjack-0.20.1.dist-info/METADATA,sha256=dl2tB6kLCgYAilZFtJ6-dwGjBrOysINM3ODPIBfVRW0,24058
-crackerjack-0.20.1.dist-info/WHEEL,sha256=tSfRZzRHthuv7vxpI4aehrdN9scLjk-dCJkPLzkHxGg,90
-crackerjack-0.20.1.dist-info/entry_points.txt,sha256=6OYgBcLyFCUgeqLgnvMyOJxPCWzgy7se4rLPKtNonMs,34
-crackerjack-0.20.1.dist-info/licenses/LICENSE,sha256=fDt371P6_6sCu7RyqiZH_AhT1LdN3sN1zjBtqEhDYCk,1531
+crackerjack-0.20.2.dist-info/METADATA,sha256=JxIeMJ6WVmtpOW1CYU2eP6mLxb36wqiZNOIHYWcVZ8I,26354
+crackerjack-0.20.2.dist-info/WHEEL,sha256=tSfRZzRHthuv7vxpI4aehrdN9scLjk-dCJkPLzkHxGg,90
+crackerjack-0.20.2.dist-info/entry_points.txt,sha256=6OYgBcLyFCUgeqLgnvMyOJxPCWzgy7se4rLPKtNonMs,34
+crackerjack-0.20.2.dist-info/licenses/LICENSE,sha256=fDt371P6_6sCu7RyqiZH_AhT1LdN3sN1zjBtqEhDYCk,1531
 crackerjack/.gitignore,sha256=4DYG7ZoVEHR5Tv1gQliRWmsNku5Fw2_k756cG_t12Cg,185
 crackerjack/.libcst.codemod.yaml,sha256=a8DlErRAIPV1nE6QlyXPAzTOgkB24_spl2E9hphuf5s,772
 crackerjack/.pdm.toml,sha256=dZe44HRcuxxCFESGG8SZIjmc-cGzSoyK3Hs6t4NYA8w,23
@@ -23,7 +23,7 @@ crackerjack/.ruff_cache/0.11.12/16869036553936192448,sha256=pYYUCDrYh7fPq8xkFLxv
 crackerjack/.ruff_cache/0.11.12/1867267426380906393,sha256=2w4M0Lrjd9flwuq6uJxehTbm7FVUcK5sL2sz1gS2Yvo,256
 crackerjack/.ruff_cache/0.11.12/4240757255861806333,sha256=uph5uIRG-XnF7ywAEcCxqqgIkWALPCvJFcwCgnNfTI4,77
 crackerjack/.ruff_cache/0.11.12/4441409093023629623,sha256=eHrESew3XCFJ2WqmKvtGLO1r4mY5Q_mv7yGlDmM1sSc,153
-crackerjack/.ruff_cache/0.11.13/1867267426380906393,sha256=AbmV8fLx3w4rzckJWjY4fxme4qFC8RaJefGdR6WFJkM,256
+crackerjack/.ruff_cache/0.11.13/1867267426380906393,sha256=-JUoRdDv_1mo2i4m_u0dAa9ByNdbOSvEGWE_LiSl6tc,256
 crackerjack/.ruff_cache/0.11.2/4070660268492669020,sha256=FTRTUmvj6nZw_QQBp_WHI-h3_iqRejzL39api-9wTvs,224
 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
@@ -64,5 +64,5 @@ crackerjack/crackerjack.py,sha256=OWw-EyQzDZsoxH-snikhxuQL8t0Es4MD9bsGfu6zwv4,52
 crackerjack/errors.py,sha256=OtbmtA912kzDOWVo6JASuFbaMU-VhmQD_fUNsvnWCZc,4311
 crackerjack/interactive.py,sha256=Ay7_s3pc4ntc_3F_bRKBsWxmjor6nkN9v6tqqJe1iRw,15904
 crackerjack/py313.py,sha256=VgthlcpLL6nNDcg3evvEmGNYWCdMuojnMhow58ISEdY,6184
-crackerjack/pyproject.toml,sha256=UGmBtEKuo7DxmbiWwC1DQvOyhtCKXY_08j1T0lxGU3Q,4843
-crackerjack-0.20.1.dist-info/RECORD,,
+crackerjack/pyproject.toml,sha256=2SSoGzy_2YAUS7Tuf8nnShK3JTRCc0mBHEdm89QUQ4E,4843
+crackerjack-0.20.2.dist-info/RECORD,,