crackerjack 0.21.7__py3-none-any.whl → 0.22.0__py3-none-any.whl

crackerjack/.pre-commit-config.yaml

@@ -14,11 +14,6 @@ repos:
       - id: check-added-large-files
         name: check-added-large-files
 
-  - repo: https://github.com/abravalheri/validate-pyproject
-    rev: v0.24.1
-    hooks:
-      - id: validate-pyproject
-
   - repo: https://github.com/tox-dev/pyproject-fmt
     rev: "v2.6.0"
     hooks:
@@ -34,7 +29,7 @@ repos:
           - keyring
 
   - repo: https://github.com/astral-sh/uv-pre-commit
-    rev: 0.7.15
+    rev: 0.7.16
     hooks:
       - id: uv-lock
         files: ^pyproject\.toml$
@@ -110,14 +105,3 @@ repos:
     rev: v1.1.402
     hooks:
       - id: pyright
-
-  #  - repo: https://github.com/pdoc3/pdoc
-  #    rev: master
-  #    hooks:
-  #      - id: pdoc
-  #        name: pdoc
-  #        entry: pdoc --html -f -o docs module1 module2 module3
-  #        language_version: python3.11
-  #        require_serial: true
-  #        types: [ python ]
-  #        always_run: true

crackerjack/__init__.py

@@ -1,4 +1,5 @@
 import typing as t
+
 from .crackerjack import Crackerjack, create_crackerjack_runner
 from .errors import (
     CleaningError,

crackerjack/__main__.py

@@ -1,4 +1,5 @@
 from enum import Enum
+
 import typer
 from pydantic import BaseModel, field_validator
 from rich.console import Console
@@ -22,7 +23,6 @@ class BumpOption(str, Enum):
 class Options(BaseModel):
     commit: bool = False
     interactive: bool = False
-    doc: bool = False
     no_config_updates: bool = False
     publish: BumpOption | None = None
     bump: BumpOption | None = None
@@ -62,7 +62,6 @@ cli_options = {
         "--interactive",
         help="Use the interactive Rich UI for a better experience.",
     ),
-    "doc": typer.Option(False, "-d", "--doc", help="Generate documentation."),
     "no_config_updates": typer.Option(
         False, "-n", "--no-config-updates", help="Do not update configuration files."
     ),
@@ -145,7 +144,6 @@ cli_options = {
 def main(
     commit: bool = cli_options["commit"],
     interactive: bool = cli_options["interactive"],
-    doc: bool = cli_options["doc"],
     no_config_updates: bool = cli_options["no_config_updates"],
     update_precommit: bool = cli_options["update_precommit"],
     verbose: bool = cli_options["verbose"],
@@ -168,7 +166,6 @@ def main(
     options = Options(
         commit=commit,
         interactive=interactive,
-        doc=doc,
         no_config_updates=no_config_updates,
         update_precommit=update_precommit,
         verbose=verbose,

crackerjack/crackerjack.py

@@ -6,6 +6,7 @@ from pathlib import Path
 from subprocess import CompletedProcess
 from subprocess import run as execute
 from tomllib import loads
+
 from pydantic import BaseModel
 from rich.console import Console
 from tomli_w import dumps
@@ -31,7 +32,6 @@ class CommandRunner(t.Protocol):
 class OptionsProtocol(t.Protocol):
     commit: bool
     interactive: bool
-    doc: bool
     no_config_updates: bool
     verbose: bool
     update_precommit: bool
@@ -169,9 +169,12 @@ class CodeCleaner(BaseModel, arbitrary_types_allowed=True):
         cleaned_lines = []
         docstring_state = self._initialize_docstring_state()
         for i, line in enumerate(lines):
-            _, result_line = self._process_line(lines, i, line, docstring_state)
-            if result_line:
-                cleaned_lines.append(result_line)
+            handled, result_line = self._process_line(lines, i, line, docstring_state)
+            if handled:
+                if result_line is not None:
+                    cleaned_lines.append(result_line)
+            else:
+                cleaned_lines.append(line)
         return "\n".join(cleaned_lines)
 
     def _is_function_or_class_definition(self, stripped_line: str) -> bool:
@@ -287,13 +290,15 @@ class CodeCleaner(BaseModel, arbitrary_types_allowed=True):
         lines = code.split("\n")
         cleaned_lines = []
         function_tracker = {"in_function": False, "function_indent": 0}
+        import_tracker = {"in_imports": False, "last_import_type": None}
         for i, line in enumerate(lines):
             line = line.rstrip()
             stripped_line = line.lstrip()
             self._update_function_state(line, stripped_line, function_tracker)
+            self._update_import_state(line, stripped_line, import_tracker)
             if not line:
                 if self._should_skip_empty_line(
-                    i, lines, cleaned_lines, function_tracker
+                    i, lines, cleaned_lines, function_tracker, import_tracker
                 ):
                     continue
             cleaned_lines.append(line)
@@ -309,6 +314,113 @@ class CodeCleaner(BaseModel, arbitrary_types_allowed=True):
             function_tracker["in_function"] = False
             function_tracker["function_indent"] = 0
 
+    def _update_import_state(
+        self, line: str, stripped_line: str, import_tracker: dict[str, t.Any]
+    ) -> None:
+        if stripped_line.startswith(("import ", "from ")):
+            import_tracker["in_imports"] = True
+            if self._is_stdlib_import(stripped_line):
+                current_type = "stdlib"
+            elif self._is_local_import(stripped_line):
+                current_type = "local"
+            else:
+                current_type = "third_party"
+            import_tracker["last_import_type"] = current_type
+        elif stripped_line and not stripped_line.startswith("#"):
+            import_tracker["in_imports"] = False
+            import_tracker["last_import_type"] = None
+
+    def _is_stdlib_import(self, stripped_line: str) -> bool:
+        try:
+            if stripped_line.startswith("from "):
+                module = stripped_line.split()[1].split(".")[0]
+            else:
+                module = stripped_line.split()[1].split(".")[0]
+        except IndexError:
+            return False
+        stdlib_modules = {
+            "os",
+            "sys",
+            "re",
+            "json",
+            "datetime",
+            "time",
+            "pathlib",
+            "typing",
+            "collections",
+            "itertools",
+            "functools",
+            "operator",
+            "math",
+            "random",
+            "uuid",
+            "urllib",
+            "http",
+            "html",
+            "xml",
+            "email",
+            "csv",
+            "sqlite3",
+            "subprocess",
+            "threading",
+            "multiprocessing",
+            "asyncio",
+            "contextlib",
+            "dataclasses",
+            "enum",
+            "abc",
+            "io",
+            "tempfile",
+            "shutil",
+            "glob",
+            "pickle",
+            "copy",
+            "heapq",
+            "bisect",
+            "array",
+            "struct",
+            "zlib",
+            "hashlib",
+            "hmac",
+            "secrets",
+            "base64",
+            "binascii",
+            "codecs",
+            "locale",
+            "platform",
+            "socket",
+            "ssl",
+            "ipaddress",
+            "logging",
+            "warnings",
+            "inspect",
+            "ast",
+            "dis",
+            "tokenize",
+            "keyword",
+            "linecache",
+            "traceback",
+            "weakref",
+            "gc",
+            "ctypes",
+            "unittest",
+            "doctest",
+            "pdb",
+            "profile",
+            "cProfile",
+            "timeit",
+            "trace",
+            "calendar",
+            "decimal",
+            "fractions",
+            "statistics",
+            "tomllib",
+        }
+        return module in stdlib_modules
+
+    def _is_local_import(self, stripped_line: str) -> bool:
+        return stripped_line.startswith("from .") or " . " in stripped_line
+
     def _is_function_end(
         self, line: str, stripped_line: str, function_tracker: dict[str, t.Any]
     ) -> bool:
@@ -325,13 +437,44 @@ class CodeCleaner(BaseModel, arbitrary_types_allowed=True):
         lines: list[str],
         cleaned_lines: list[str],
         function_tracker: dict[str, t.Any],
+        import_tracker: dict[str, t.Any],
     ) -> bool:
         if line_idx > 0 and cleaned_lines and (not cleaned_lines[-1]):
             return True
+
+        if self._is_import_section_separator(line_idx, lines, import_tracker):
+            return False
+
         if function_tracker["in_function"]:
             return self._should_skip_function_empty_line(line_idx, lines)
         return False
 
+    def _is_import_section_separator(
+        self, line_idx: int, lines: list[str], import_tracker: dict[str, t.Any]
+    ) -> bool:
+        if not import_tracker["in_imports"]:
+            return False
+
+        next_line_idx = line_idx + 1
+        while next_line_idx < len(lines) and not lines[next_line_idx].strip():
+            next_line_idx += 1
+
+        if next_line_idx >= len(lines):
+            return False
+
+        next_line = lines[next_line_idx].strip()
+        if not next_line.startswith(("import ", "from ")):
+            return False
+
+        if self._is_stdlib_import(next_line):
+            next_type = "stdlib"
+        elif self._is_local_import(next_line):
+            next_type = "local"
+        else:
+            next_type = "third_party"
+
+        return import_tracker["last_import_type"] != next_type
+
     def _should_skip_function_empty_line(self, line_idx: int, lines: list[str]) -> bool:
         next_line_idx = line_idx + 1
         if next_line_idx >= len(lines):

crackerjack/errors.py

@@ -2,6 +2,7 @@ import sys
 import typing as t
 from enum import Enum
 from pathlib import Path
+
 from rich.console import Console
 from rich.panel import Panel
 

crackerjack/interactive.py

@@ -2,6 +2,7 @@ import time
 import typing as t
 from enum import Enum, auto
 from pathlib import Path
+
 from rich.box import ROUNDED
 from rich.console import Console
 from rich.layout import Layout
@@ -18,6 +19,7 @@ from rich.prompt import Confirm, Prompt
 from rich.table import Table
 from rich.text import Text
 from rich.tree import Tree
+
 from .errors import CrackerjackError, ErrorCode, handle_error
 
 

crackerjack/pyproject.toml

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

{crackerjack-0.21.7.dist-info → crackerjack-0.22.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: crackerjack
-Version: 0.21.7
+Version: 0.22.0
 Summary: Crackerjack: code quality toolkit
 Keywords: bandit,black,creosote,mypy,pyright,pytest,refurb,ruff
 Author-Email: lesleslie <les@wedgwoodwebworks.com>
@@ -102,7 +102,7 @@ If you're new to Crackerjack, follow these steps:
 
     Or use the interactive Rich UI:
     ```
-    python -m crackerjack --interactive
+    python -m crackerjack -i
     ```
 
 ---
@@ -160,7 +160,7 @@ Crackerjack automatically installs and manages these pre-commit hooks:
 3.  **Ruff:** [Ruff](https://github.com/astral-sh/ruff) for linting, code formatting, and general code style enforcement.
 4.  **Vulture:** [Vulture](https://github.com/jendrikseipp/vulture) to identify dead code.
 5.  **Creosote:** [Creosote](https://github.com/fredrikaverpil/creosote) to detect unused dependencies.
-6.  **Flynt:** [Flynt](https://github.com/ikamensh/flynt/) for converting string formatting to f-strings.
+6.  **Complexipy:** [Complexipy](https://github.com/rohaquinlop/complexipy-pre-commit) for analyzing code complexity.
 7.  **Codespell:** [Codespell](https://github.com/codespell-project/codespell) for correcting typos in the code.
 8.  **Autotyping:** [Autotyping](https://github.com/JelleZijlstra/autotyping) for adding type hints.
 9.  **Refurb:** [Refurb](https://github.com/dosisod/refurb) to suggest code improvements.
@@ -269,7 +269,7 @@ python -m crackerjack -t --benchmark-regression --benchmark-regression-threshold
 
     Or with the interactive Rich UI:
     ```
-    python -m crackerjack --interactive
+    python -m crackerjack -i
     ```
 
 ## Usage
@@ -301,7 +301,6 @@ class MyOptions:
         # Configuration options
         self.no_config_updates = False  # Skip updating config files
         self.update_precommit = False   # Update pre-commit hooks
-        self.doc = False                # Generate documentation (not implemented yet)
 
         # Process options
         self.clean = True            # Clean code (remove docstrings, comments, etc.)
@@ -347,7 +346,6 @@ runner.process(MyOptions())
 -   `-i`, `--interactive`: Run pre-commit hooks interactively when possible.
 -   `-n`, `--no-config-updates`: Skip updating configuration files (e.g., `pyproject.toml`).
 -   `-u`, `--update-precommit`: Update pre-commit hooks to the latest versions.
--   `-d`, `--doc`: Generate documentation.  (not yet implemented)
 -   `-v`, `--verbose`: Enable verbose output.
 -   `-p`, `--publish <micro|minor|major>`: Bump the project version and publish to PyPI using PDM.
 -   `-b`, `--bump <micro|minor|major>`: Bump the project version without publishing.
@@ -361,7 +359,7 @@ runner.process(MyOptions())
 -   `--benchmark-regression`: Fail tests if benchmarks regress beyond threshold.
 -   `--benchmark-regression-threshold`: Set threshold percentage for benchmark regression (default 5.0%).
 -   `-a`, `--all`: Run with `-x -t -p <micro|minor|major> -c` development options.
--   `--interactive`: Enable the interactive Rich UI for a more user-friendly experience with visual progress tracking and interactive prompts.
+-   `-i`, `--interactive`: Enable the interactive Rich UI for a more user-friendly experience with visual progress tracking and interactive prompts.
 -   `--ai-agent`: Enable AI agent mode with structured output (see [AI Agent Integration](#ai-agent-integration)).
 -   `--help`: Display help.
 
@@ -461,7 +459,7 @@ runner.process(MyOptions())
 
 - **Rich Interactive Mode** - Run with the interactive Rich UI:
   ```bash
-  python -m crackerjack --interactive
+  python -m crackerjack -i
   ```
 
 - **AI Integration** - Run with structured output for AI tools:
@@ -500,10 +498,10 @@ Crackerjack now offers an enhanced interactive experience through its Rich UI:
 - **Error Visualization:** Errors are presented in a structured, easy-to-understand format with recovery suggestions
 - **File Selection:** Interactive file browser for operations that require selecting files
 
-To use the Rich UI, run Crackerjack with the `--interactive` flag:
+To use the Rich UI, run Crackerjack with the `-i` flag:
 
 ```bash
-python -m crackerjack --interactive
+python -m crackerjack -i
 ```
 
 This launches an interactive terminal interface where you can:
@@ -542,7 +540,7 @@ python -m crackerjack -v
 For the most comprehensive error details with visual formatting, combine verbose mode with the Rich UI:
 
 ```bash
-python -m crackerjack --interactive -v
+python -m crackerjack -i -v
 ```
 
 ## Python 3.13+ Features
@@ -606,7 +604,7 @@ Crackerjack is designed with modern Python principles in mind:
 -   **bandit:** For finding security vulnerabilities.
 -   **vulture:** For dead code detection.
 -   **creosote:** For unused dependency detection.
--   **flynt:** For f-string conversion.
+-   **complexipy:** For code complexity analysis.
 -   **codespell:** For spelling correction.
 -   **autotyping:** For automatically adding type hints.
 -   **refurb:** For code improvement suggestions.

{crackerjack-0.21.7.dist-info → crackerjack-0.22.0.dist-info}/RECORD

@@ -1,12 +1,12 @@
-crackerjack-0.21.7.dist-info/METADATA,sha256=suf-qK6MQQTYL6v8ZXcTUT70x6ADX6u1Dd8YvhQSV60,26442
-crackerjack-0.21.7.dist-info/WHEEL,sha256=tSfRZzRHthuv7vxpI4aehrdN9scLjk-dCJkPLzkHxGg,90
-crackerjack-0.21.7.dist-info/entry_points.txt,sha256=6OYgBcLyFCUgeqLgnvMyOJxPCWzgy7se4rLPKtNonMs,34
-crackerjack-0.21.7.dist-info/licenses/LICENSE,sha256=fDt371P6_6sCu7RyqiZH_AhT1LdN3sN1zjBtqEhDYCk,1531
+crackerjack-0.22.0.dist-info/METADATA,sha256=nqIxAtAdYiUHDn2lfX8PAIeSO8ufSkPQ6qcVNEmXqpo,26251
+crackerjack-0.22.0.dist-info/WHEEL,sha256=tSfRZzRHthuv7vxpI4aehrdN9scLjk-dCJkPLzkHxGg,90
+crackerjack-0.22.0.dist-info/entry_points.txt,sha256=6OYgBcLyFCUgeqLgnvMyOJxPCWzgy7se4rLPKtNonMs,34
+crackerjack-0.22.0.dist-info/licenses/LICENSE,sha256=fDt371P6_6sCu7RyqiZH_AhT1LdN3sN1zjBtqEhDYCk,1531
 crackerjack/.gitignore,sha256=n8cD6U16L3XZn__PvhYm_F7-YeFHFucHCyxWj2NZCGs,259
 crackerjack/.libcst.codemod.yaml,sha256=a8DlErRAIPV1nE6QlyXPAzTOgkB24_spl2E9hphuf5s,772
 crackerjack/.pdm.toml,sha256=dZe44HRcuxxCFESGG8SZIjmc-cGzSoyK3Hs6t4NYA8w,23
 crackerjack/.pre-commit-config-ai.yaml,sha256=K8xXKMJcdhfXOk24L4XpK7H8YlvnZfOh4NVA6qvOz8I,3319
-crackerjack/.pre-commit-config.yaml,sha256=glBcQ4nwC28t4Ier2E69bUg8pNQ9YyCtHmD-fV6bRm0,3076
+crackerjack/.pre-commit-config.yaml,sha256=fLYBe846QI2Kgfjut0biMx4sjbZkJwc0Z9nvcNhGXD0,2643
 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
@@ -34,7 +34,7 @@ crackerjack/.ruff_cache/0.11.7/10386934055395314831,sha256=lBNwN5zAgM4OzbkXIOzCc
 crackerjack/.ruff_cache/0.11.7/3557596832929915217,sha256=fKlwUbsvT3YIKV6UR-aA_i64lLignWeVfVu-MMmVbU0,207
 crackerjack/.ruff_cache/0.11.8/530407680854991027,sha256=xAMAL3Vu_HR6M-h5ojCTaak0By5ii8u-14pXULLgLqw,224
 crackerjack/.ruff_cache/0.12.0/5056746222905752453,sha256=MqrIT5qymJcgAOBZyn-TvYoGCFfDFCgN9IwSULq8n14,256
-crackerjack/.ruff_cache/0.12.1/5056746222905752453,sha256=CHy2IV23GK0EauutmCmddO7Ck-fHMzbvpvZ1ZO9Cp8Y,256
+crackerjack/.ruff_cache/0.12.1/5056746222905752453,sha256=38wx4Qzd6e1GIHXu-oCJpPPNMXpUhTAGS3pPKW85138,256
 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
@@ -62,11 +62,11 @@ crackerjack/.ruff_cache/0.9.3/13948373885254993391,sha256=kGhtIkzPUtKAgvlKs3D8j4
 crackerjack/.ruff_cache/0.9.9/12813592349865671909,sha256=tmr8_vhRD2OxsVuMfbJPdT9fDFX-d5tfC5U9jgziyho,224
 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=LyIPEfjBcqWp7UVuJ-b7cc8oiFxrQqyL8RJ7g6c17Qs,838
-crackerjack/__main__.py,sha256=GP5GBbWK5lDTQanCHKVEyS3hDWvshwlrhWagzQlRuD4,6560
-crackerjack/crackerjack.py,sha256=jlepiHgMkvTyl83O8HUqC4mCsQbZIejerOHNQD15JcU,35854
-crackerjack/errors.py,sha256=xvXO3bk0VrxQz0lysIuVOju6SxxDgf04Wne1BedLFB8,4061
-crackerjack/interactive.py,sha256=ierA2jeUsigTJhKOcJJsjhBZm2WwsQpvow3Y5ppF7IE,16151
+crackerjack/__init__.py,sha256=8tBSPAru_YDuPpjz05cL7pNbZjYFoRT_agGd_FWa3gY,839
+crackerjack/__main__.py,sha256=lEyi83ChuehqEJgUQ6Ib4ByOofvmhi_0M7oFamMC_1I,6407
+crackerjack/crackerjack.py,sha256=lWA98K2uY4i4TnXN24pselsiJWSlQgQ6ztTXGn7n27Q,40032
+crackerjack/errors.py,sha256=QEPtVuMtKtQHuawgr1ToMaN1KbUg5h9-4mS33YB5Znk,4062
+crackerjack/interactive.py,sha256=y5QbyR2Wp8WkC_iC89ZqETm-wjAN9X5DK1L3yetpjN4,16153
 crackerjack/py313.py,sha256=buYE7LO11Q64ffowEhTZRFQoAGj_8sg3DTlZuv8M9eo,5890
-crackerjack/pyproject.toml,sha256=OIoNmIktC1abFPgePb95Zg9BDTGfRxXftK-KccWgalc,4988
-crackerjack-0.21.7.dist-info/RECORD,,
+crackerjack/pyproject.toml,sha256=UaUtLOyXoOvjesOY4lRj-hT4L5WjVbCH0C5fGoAMBXQ,4988
+crackerjack-0.22.0.dist-info/RECORD,,