lintro 0.13.1__py3-none-any.whl → 0.13.3__py3-none-any.whl

lintro/__init__.py

@@ -1,3 +1,3 @@
 """Lintro - A unified CLI core for code formatting, linting, and quality assurance."""
 
-__version__ = "0.13.1"
+__version__ = "0.13.3"

lintro/parsers/__init__.py

@@ -1,14 +1,21 @@
 """Parser modules for Lintro tools."""
 
-from lintro.parsers import (
-    actionlint,
-    bandit,
-    darglint,
-    hadolint,
-    prettier,
-    ruff,
-    yamllint,
-)
+from __future__ import annotations
+
+from importlib import import_module
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    # Type checking imports
+    from lintro.parsers import (
+        actionlint,
+        bandit,
+        darglint,
+        hadolint,
+        prettier,
+        ruff,
+        yamllint,
+    )
 
 __all__ = [
     "actionlint",
@@ -19,3 +26,47 @@ __all__ = [
     "ruff",
     "yamllint",
 ]
+
+# Lazy-load parser submodules to avoid circular imports
+_SUBMODULES = {
+    "actionlint",
+    "bandit",
+    "darglint",
+    "hadolint",
+    "prettier",
+    "ruff",
+    "yamllint",
+}
+
+
+def __getattr__(name: str) -> object:
+    """Lazy-load parser submodules to avoid circular import issues.
+
+    This function is called when an attribute is accessed that doesn't exist
+    in the module. It allows accessing parser submodules without eagerly
+    importing them all at package initialization time.
+
+    Args:
+        name: The name of the attribute being accessed.
+
+    Returns:
+        The imported submodule.
+
+    Raises:
+        AttributeError: If the requested name is not a known submodule.
+    """
+    if name in _SUBMODULES:
+        module = import_module(f".{name}", __package__)
+        # Cache the module in this module's namespace for future access
+        globals()[name] = module
+        return module
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
+
+
+def __dir__() -> list[str]:
+    """Return list of available attributes for this module.
+
+    Returns:
+        List of submodule names and other module attributes.
+    """
+    return list(__all__)

lintro/parsers/bandit/__init__.py

@@ -0,0 +1,6 @@
+"""Bandit parser module."""
+
+from lintro.parsers.bandit.bandit_issue import BanditIssue
+from lintro.parsers.bandit.bandit_parser import parse_bandit_output
+
+__all__ = ["BanditIssue", "parse_bandit_output"]

lintro/parsers/bandit/bandit_issue.py

@@ -0,0 +1,49 @@
+"""Bandit issue model for security vulnerabilities."""
+
+from dataclasses import dataclass
+from typing import Any
+
+
+@dataclass
+class BanditIssue:
+    """Represents a security issue found by Bandit.
+
+    Attributes:
+        file: str: Path to the file containing the issue.
+        line: int: Line number where the issue was found.
+        col_offset: int: Column offset of the issue.
+        issue_severity: str: Severity level (LOW, MEDIUM, HIGH).
+        issue_confidence: str: Confidence level (LOW, MEDIUM, HIGH).
+        test_id: str: Bandit test ID (e.g., B602, B301).
+        test_name: str: Name of the test that found the issue.
+        issue_text: str: Description of the security issue.
+        more_info: str: URL with more information about the issue.
+        cwe: dict[str, Any] | None: CWE (Common Weakness Enumeration) information.
+        code: str: Code snippet containing the issue.
+        line_range: list[int]: Range of lines containing the issue.
+    """
+
+    file: str
+    line: int
+    col_offset: int
+    issue_severity: str
+    issue_confidence: str
+    test_id: str
+    test_name: str
+    issue_text: str
+    more_info: str
+    cwe: dict[str, Any] | None = None
+    code: str | None = None
+    line_range: list[int] | None = None
+
+    @property
+    def message(self) -> str:
+        """Get a human-readable message for the issue.
+
+        Returns:
+            str: Formatted issue message.
+        """
+        return (
+            f"[{self.test_id}:{self.test_name}] {self.issue_severity} severity, "
+            f"{self.issue_confidence} confidence: {self.issue_text}"
+        )

lintro/parsers/bandit/bandit_parser.py

@@ -0,0 +1,99 @@
+"""Bandit output parser for security issues."""
+
+from typing import Any
+
+from loguru import logger
+
+from lintro.parsers.bandit.bandit_issue import BanditIssue
+
+
+def parse_bandit_output(bandit_data: dict[str, Any]) -> list[BanditIssue]:
+    """Parse Bandit JSON output into BanditIssue objects.
+
+    Args:
+        bandit_data: dict[str, Any]: JSON data from Bandit output.
+
+    Returns:
+        list[BanditIssue]: List of parsed security issues.
+
+    Raises:
+        ValueError: If the bandit data structure is invalid.
+    """
+    if not isinstance(bandit_data, dict):
+        raise ValueError("Bandit data must be a dictionary")
+
+    results = bandit_data.get("results", [])
+    if not isinstance(results, list):
+        raise ValueError("Bandit results must be a list")
+
+    issues: list[BanditIssue] = []
+
+    for result in results:
+        if not isinstance(result, dict):
+            continue
+
+        try:
+            filename = result.get("filename", "")
+            line_number = result.get("line_number", 0)
+            col_offset = result.get("col_offset", 0)
+            issue_severity = result.get("issue_severity", "UNKNOWN")
+            issue_confidence = result.get("issue_confidence", "UNKNOWN")
+            test_id = result.get("test_id", "")
+            test_name = result.get("test_name", "")
+            issue_text = result.get("issue_text", "")
+            more_info = result.get("more_info", "")
+            cwe = result.get("issue_cwe")
+            code = result.get("code")
+            line_range = result.get("line_range")
+
+            # Validate critical fields; skip malformed entries
+            if not isinstance(filename, str):
+                logger.warning("Skipping issue with non-string filename")
+                continue
+            if not isinstance(line_number, int):
+                logger.warning("Skipping issue with non-integer line_number")
+                continue
+            if not isinstance(col_offset, int):
+                col_offset = 0
+
+            sev = (
+                str(issue_severity).upper() if issue_severity is not None else "UNKNOWN"
+            )
+            conf = (
+                str(issue_confidence).upper()
+                if issue_confidence is not None
+                else "UNKNOWN"
+            )
+
+            test_id = test_id if isinstance(test_id, str) else ""
+            test_name = test_name if isinstance(test_name, str) else ""
+            issue_text = issue_text if isinstance(issue_text, str) else ""
+            more_info = more_info if isinstance(more_info, str) else ""
+
+            # Normalize line_range to list[int] when provided
+            if isinstance(line_range, list):
+                line_range = [x for x in line_range if isinstance(x, int)] or None
+            else:
+                line_range = None
+
+            issue = BanditIssue(
+                file=filename,
+                line=line_number,
+                col_offset=col_offset,
+                issue_severity=sev,
+                issue_confidence=conf,
+                test_id=test_id,
+                test_name=test_name,
+                issue_text=issue_text,
+                more_info=more_info,
+                cwe=cwe if isinstance(cwe, dict) else None,
+                code=code if isinstance(code, str) else None,
+                line_range=line_range,
+            )
+            issues.append(issue)
+        except (KeyError, TypeError, ValueError) as e:
+            # Log warning but continue processing other issues
+            logger.warning(f"Failed to parse bandit issue: {e}")
+            continue
+
+    return issues

{lintro-0.13.1.dist-info → lintro-0.13.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lintro
-Version: 0.13.1
+Version: 0.13.3
 Summary: A unified CLI tool for code formatting, linting, and quality assurance
 Author-email: TurboCoder13 <turbocoder13@gmail.com>
 License: MIT License
@@ -36,7 +36,7 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development :: Quality Assurance
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Topic :: Utilities
-Requires-Python: ==3.13.7
+Requires-Python: >=3.13
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: click==8.1.8
@@ -169,8 +169,10 @@ grype sbom:main-*-py-lintro-sbom.spdx-2.3.json
 
 #### From PyPI (Recommended)
 
+⚠️ **Important**: Versions prior to 0.13.2 contain a circular import bug that prevents installation as a dependency. Please use version 0.13.2 or later.
+
 ```bash
-pip install lintro
+pip install lintro>=0.13.2
 ```
 
 #### Development Installation

{lintro-0.13.1.dist-info → lintro-0.13.3.dist-info}/RECORD

@@ -1,4 +1,4 @@
-lintro/__init__.py,sha256=F89nntJnkVRHhbPcAlOEZXvyp84TymPK1K0PqeTsHps,111
+lintro/__init__.py,sha256=ZVCneiMLQUPnjOrRwodLP-_g_80H9vl0J2ZVOe26gyU,111
 lintro/__main__.py,sha256=McxM6wEcEeCLBHZs0F8xzT1PxVqJYkjtaPq1_-Nug-0,106
 lintro/cli.py,sha256=0apxBcqVxBZdCeXGMyaSdJYSntMIiCFwPwan1jUmPzM,2520
 lintro/ascii-art/fail.txt,sha256=gshKngSrz5FvJdP6g7lPygpLsLsZZh4etBU_wR7PXOw,56396
@@ -44,10 +44,13 @@ lintro/models/core/__init__.py,sha256=mevoEG547VTotUsgyocEB72OknnGhExNWcfel7ZPLn
 lintro/models/core/tool.py,sha256=TWkVV_KOYziqCdq_f3Goft3PKWKByitsQ2VFiX6MVHM,2594
 lintro/models/core/tool_config.py,sha256=FCfKQ_bz2yBg_FJ5xEud7TdF0PZ3fPp1Yjty02rbHR8,1004
 lintro/models/core/tool_result.py,sha256=z5fexuCBt1ir0hvzojxVX-Abt6MNIT7_JvH5oyW_FlI,1319
-lintro/parsers/__init__.py,sha256=53UA1LuS21BL4xj8i81Qb59dKXe3jCFLBrDVqvvNHVQ,288
+lintro/parsers/__init__.py,sha256=Xb2NegNLAm10mlY8BJ6lOIAtVtoCmQfY5uA6mljEs-M,1663
 lintro/parsers/actionlint/__init__.py,sha256=N953d0kbJEOZE9cG4eq9BjiSErdk10GMrngV_tKjLvo,33
 lintro/parsers/actionlint/actionlint_issue.py,sha256=H_BQr04KAGHpVp1qKqETcWLi3i-u6atl7ccDae-jqX8,636
 lintro/parsers/actionlint/actionlint_parser.py,sha256=tvpPOi1dQrnpf7V2-3LMANH_UfDdecI4_AwDQpZOyU0,1898
+lintro/parsers/bandit/__init__.py,sha256=LMXIVOoW1wnS0mXbiVY-htdkUvb1clRSfSn7X3L2SSw,206
+lintro/parsers/bandit/bandit_issue.py,sha256=zdC6dLFmks_w9JjDWQ00BPSpCUUkilElby-Ut0PVLtE,1607
+lintro/parsers/bandit/bandit_parser.py,sha256=d4KRH_U_4Exv-Fxq63yyx7F484yorKr2p8caDPCyKHs,3591
 lintro/parsers/black/black_issue.py,sha256=RwrT7n8aw4Nybakv83eXoeUxZlDtHwicWKNfrHYIYOg,507
 lintro/parsers/black/black_parser.py,sha256=mCbEy4aTRtxC_SKKPNK6hThGEu8C0m9EnliFW__Sa3Y,2958
 lintro/parsers/darglint/__init__.py,sha256=r2ilRjf8WdHOvXIGsg4SmtYkRUR76DowWLA_n9sIOV0,55
@@ -88,9 +91,9 @@ lintro/utils/output_manager.py,sha256=oIE0g8LNVQcWSQOb1MbDVqGYPrOjBGuUZ4R80M1Rev
 lintro/utils/path_utils.py,sha256=NJP3vjVDcRBgUHtYNrpL0tRa0Sc3oQhGX3_2WWzdZE4,1395
 lintro/utils/tool_executor.py,sha256=PNUuWkQj4TWI9UHVvZUpWoDkU00MAd1o5_VhG-iviCo,26124
 lintro/utils/tool_utils.py,sha256=T3A5xf4zokUMPVzWzEn3f0M14EcDxoeRo-jf5yXEoyI,15613
-lintro-0.13.1.dist-info/licenses/LICENSE,sha256=CwaAnyD2psonDBBJjbqFUz00W8nQw-FGDlEGZReUV6A,1069
-lintro-0.13.1.dist-info/METADATA,sha256=dqEtf_tDuIE7ZyXZLrqFbeRU8QRTVhdk4j-N4C_hEXo,16030
-lintro-0.13.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-lintro-0.13.1.dist-info/entry_points.txt,sha256=SYSk35jFyNLEHyrofSJsRv4qFN9NsT4VWSbvnTS9ov0,43
-lintro-0.13.1.dist-info/top_level.txt,sha256=_D-7eyV6gNBOoIwHuf_h60wN_RWiw8GxB430Il9VKhU,7
-lintro-0.13.1.dist-info/RECORD,,
+lintro-0.13.3.dist-info/licenses/LICENSE,sha256=CwaAnyD2psonDBBJjbqFUz00W8nQw-FGDlEGZReUV6A,1069
+lintro-0.13.3.dist-info/METADATA,sha256=I4ZziqInQAn3pXWgGXNa4gShtnJZjhy7edUDyiH5eSo,16194
+lintro-0.13.3.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+lintro-0.13.3.dist-info/entry_points.txt,sha256=SYSk35jFyNLEHyrofSJsRv4qFN9NsT4VWSbvnTS9ov0,43
+lintro-0.13.3.dist-info/top_level.txt,sha256=_D-7eyV6gNBOoIwHuf_h60wN_RWiw8GxB430Il9VKhU,7
+lintro-0.13.3.dist-info/RECORD,,