lintro 0.13.2__tar.gz → 0.14.0__tar.gz

{lintro-0.13.2/lintro.egg-info → lintro-0.14.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lintro
-Version: 0.13.2
+Version: 0.14.0
 Summary: A unified CLI tool for code formatting, linting, and quality assurance
 Author-email: TurboCoder13 <turbocoder13@gmail.com>
 License: MIT License

{lintro-0.13.2 → lintro-0.14.0}/assets/images/coverage-badge.svg

@@ -15,7 +15,7 @@
     <g fill="#fff" text-anchor="middle" font-family="DejaVu Sans,Verdana,Geneva,sans-serif" font-size="110">
         <text x="325" y="150" fill="#010101" fill-opacity=".3" transform="scale(.1)" textLength="530">coverage</text>
         <text x="325" y="140" transform="scale(.1)" textLength="530">coverage</text>
-        <text x="800" y="150" fill="#010101" fill-opacity=".3" transform="scale(.1)" textLength="260">84.8%</text>
-        <text x="800" y="140" transform="scale(.1)" textLength="260">84.8%</text>
+        <text x="800" y="150" fill="#010101" fill-opacity=".3" transform="scale(.1)" textLength="260">84.7%</text>
+        <text x="800" y="140" transform="scale(.1)" textLength="260">84.7%</text>
     </g>
 </svg>

{lintro-0.13.2 → lintro-0.14.0}/lintro/__init__.py

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

lintro-0.14.0/lintro/parsers/__init__.py

@@ -0,0 +1,72 @@
+"""Parser modules for Lintro tools."""
+
+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",
+    "bandit",
+    "darglint",
+    "hadolint",
+    "prettier",
+    "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-0.14.0/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-0.14.0/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-0.14.0/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.2 → lintro-0.14.0/lintro.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lintro
-Version: 0.13.2
+Version: 0.14.0
 Summary: A unified CLI tool for code formatting, linting, and quality assurance
 Author-email: TurboCoder13 <turbocoder13@gmail.com>
 License: MIT License

{lintro-0.13.2 → lintro-0.14.0}/lintro.egg-info/SOURCES.txt

@@ -80,6 +80,9 @@ lintro/parsers/__init__.py
 lintro/parsers/actionlint/__init__.py
 lintro/parsers/actionlint/actionlint_issue.py
 lintro/parsers/actionlint/actionlint_parser.py
+lintro/parsers/bandit/__init__.py
+lintro/parsers/bandit/bandit_issue.py
+lintro/parsers/bandit/bandit_parser.py
 lintro/parsers/black/black_issue.py
 lintro/parsers/black/black_parser.py
 lintro/parsers/darglint/__init__.py

{lintro-0.13.2 → lintro-0.14.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "lintro"
-version = "0.13.2"
+version = "0.14.0"
 description = "A unified CLI tool for code formatting, linting, and quality assurance"
 keywords = [ "linting", "formatting", "code-quality", "cli", "python", "javascript", "yaml", "docker",]
 classifiers = [ "Development Status :: 4 - Beta", "Intended Audience :: Developers", "Operating System :: OS Independent", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.13", "Topic :: Software Development :: Quality Assurance", "Topic :: Software Development :: Libraries :: Python Modules", "Topic :: Utilities",]
@@ -38,7 +38,7 @@ Documentation = "https://github.com/TurboCoder13/py-lintro/docs"
 Source = "https://github.com/TurboCoder13/py-lintro"
 
 [tool.setuptools]
-packages = [ "lintro", "lintro.cli_utils", "lintro.cli_utils.commands", "lintro.enums", "lintro.exceptions", "lintro.formatters", "lintro.formatters.core", "lintro.formatters.styles", "lintro.formatters.tools", "lintro.models", "lintro.models.core", "lintro.parsers", "lintro.parsers.black", "lintro.parsers.darglint", "lintro.parsers.hadolint", "lintro.parsers.prettier", "lintro.parsers.ruff", "lintro.parsers.yamllint", "lintro.parsers.actionlint", "lintro.tools", "lintro.tools.core", "lintro.tools.implementations", "lintro.utils",]
+packages = [ "lintro", "lintro.cli_utils", "lintro.cli_utils.commands", "lintro.enums", "lintro.exceptions", "lintro.formatters", "lintro.formatters.core", "lintro.formatters.styles", "lintro.formatters.tools", "lintro.models", "lintro.models.core", "lintro.parsers", "lintro.parsers.actionlint", "lintro.parsers.bandit", "lintro.parsers.black", "lintro.parsers.darglint", "lintro.parsers.hadolint", "lintro.parsers.prettier", "lintro.parsers.ruff", "lintro.parsers.yamllint", "lintro.tools", "lintro.tools.core", "lintro.tools.implementations", "lintro.utils",]
 
 [tool.semantic_release]
 branch = "main"

{lintro-0.13.2 → lintro-0.14.0}/tests/unit/test_package_imports.py

@@ -13,6 +13,8 @@ is installed as a built distribution. However, these tests serve as:
 
 from __future__ import annotations
 
+import pytest
+
 
 def test_main_package_import() -> None:
     """Test that the main lintro package can be imported."""
@@ -148,3 +150,73 @@ def test_cross_package_imports() -> None:
     assert bandit is not None
     assert BanditTool is not None
     assert BanditTableDescriptor is not None
+
+
+def test_bandit_parser_direct_import() -> None:
+    """Test that bandit parser can be imported directly.
+
+    This test specifically catches circular import issues that would occur
+    when lintro is installed as a built package (wheel). The issue manifests
+    when trying to import bandit parser submodules before the formatters
+    have loaded, which triggers a specific circular dependency pattern.
+    """
+    # This import sequence triggers the circular import that was fixed
+    from lintro.parsers.bandit import bandit_issue, bandit_parser
+
+    assert bandit_issue is not None
+    assert bandit_parser is not None
+
+
+def test_parser_lazy_loading() -> None:
+    """Test that parser submodules are lazily loaded, not eagerly imported.
+
+    Verifies that accessing parser submodules through the parent package
+    works via __getattr__ and doesn't cause circular imports.
+    """
+    import lintro.parsers
+
+    # Access submodules via attribute access (triggers __getattr__)
+    bandit = lintro.parsers.bandit
+    actionlint = lintro.parsers.actionlint
+
+    assert bandit is not None
+    assert actionlint is not None
+
+
+def test_parser_lazy_loading_attribute_error() -> None:
+    """Test that accessing non-existent parser raises AttributeError.
+
+    Verifies that the __getattr__ error handling works correctly.
+    """
+    import lintro.parsers
+
+    # Accessing a non-existent submodule should raise AttributeError
+    with pytest.raises(AttributeError) as exc_info:
+        _ = lintro.parsers.nonexistent_parser
+
+    assert "nonexistent_parser" in str(exc_info.value)
+
+
+def test_parser_dir_function() -> None:
+    """Test that dir() works on parsers module.
+
+    Verifies that the __dir__ function returns all available submodules.
+    """
+    import lintro.parsers
+
+    # Get the directory listing of the parsers module
+    dir_listing = dir(lintro.parsers)
+
+    # All expected submodules should be in the directory
+    expected_modules = {
+        "actionlint",
+        "bandit",
+        "darglint",
+        "hadolint",
+        "prettier",
+        "ruff",
+        "yamllint",
+    }
+
+    for module in expected_modules:
+        assert module in dir_listing

lintro-0.13.2/lintro/parsers/__init__.py

@@ -1,21 +0,0 @@
-"""Parser modules for Lintro tools."""
-
-from . import (
-    actionlint,
-    bandit,
-    darglint,
-    hadolint,
-    prettier,
-    ruff,
-    yamllint,
-)
-
-__all__ = [
-    "actionlint",
-    "bandit",
-    "darglint",
-    "hadolint",
-    "prettier",
-    "ruff",
-    "yamllint",
-]