lintro 0.13.1__tar.gz → 0.13.3__tar.gz

{lintro-0.13.1/lintro.egg-info → lintro-0.13.3}/PKG-INFO

@@ -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 → lintro-0.13.3}/README.md

@@ -95,8 +95,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 → lintro-0.13.3}/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.2%</text>
-        <text x="800" y="140" transform="scale(.1)" textLength="260">84.2%</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.1 → lintro-0.13.3}/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-0.13.3/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.13.3/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.13.3/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.13.3/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 → lintro-0.13.3/lintro.egg-info}/PKG-INFO

@@ -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 → lintro-0.13.3}/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
@@ -147,6 +150,7 @@ tests/integration/__init__.py
 tests/integration/conftest.py
 tests/integration/test_actionlint_integration.py
 tests/integration/test_bandit_integration.py
+tests/integration/test_built_package.py
 tests/integration/test_darglint_integration.py
 tests/integration/test_hadolint_integration.py
 tests/integration/test_prettier_integration.py
@@ -188,6 +192,7 @@ tests/unit/test_enums_and_normalizers.py
 tests/unit/test_exceptions.py
 tests/unit/test_formatters_tables.py
 tests/unit/test_output_manager_reports.py
+tests/unit/test_package_imports.py
 tests/unit/test_parsers_actionlint.py
 tests/unit/test_ruff_parser_additional.py
 tests/unit/test_ruff_parser_more.py

{lintro-0.13.1 → lintro-0.13.3}/pyproject.toml

@@ -4,11 +4,11 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "lintro"
-version = "0.13.1"
+version = "0.13.3"
 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",]
-requires-python = "==3.13.7"
+requires-python = ">=3.13"
 dependencies = [ "click==8.1.8", "coverage-badge==1.1.2", "darglint==1.8.1", "loguru==0.7.3", "tabulate==0.9.0", "yamllint==1.37.1", "httpx==0.28.1", "toml==0.10.2", "defusedxml==0.7.1",]
 [[project.authors]]
 name = "TurboCoder13"
@@ -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.3/tests/integration/test_built_package.py

@@ -0,0 +1,112 @@
+"""Integration test for built package installation.
+
+This module tests that lintro can be installed as a built wheel distribution
+and imported successfully, catching circular import issues that only manifest
+when the package is installed (not in editable mode).
+"""
+
+from __future__ import annotations
+
+import subprocess
+import sys
+import tempfile
+from pathlib import Path
+
+import pytest
+from assertpy import assert_that
+
+
+@pytest.mark.slow
+def test_built_wheel_imports() -> None:
+    """Test that lintro can be built and imported as a wheel.
+
+    This test:
+    1. Builds lintro as a wheel
+    2. Installs it in a fresh virtual environment
+    3. Attempts to import critical modules
+    4. Verifies no circular import errors occur
+
+    This catches issues that only manifest when lintro is installed as a
+    dependency (built distribution) rather than in editable mode.
+    """
+    project_root = Path(__file__).parent.parent.parent
+
+    with tempfile.TemporaryDirectory() as tmpdir:
+        tmpdir_path = Path(tmpdir)
+        venv_path = tmpdir_path / "test_venv"
+        dist_dir = tmpdir_path / "dist"
+
+        # Step 1: Build the wheel
+        build_result = subprocess.run(
+            ["uv", "build", "--out-dir", str(dist_dir)],
+            cwd=str(project_root),
+            capture_output=True,
+            text=True,
+            timeout=60,
+        )
+        assert_that(build_result.returncode).is_equal_to(0)
+        assert_that(dist_dir.exists()).is_true()
+
+        # Find the built wheel
+        wheels = list(dist_dir.glob("*.whl"))
+        assert_that(wheels).is_not_empty()
+        wheel_path = wheels[0]
+
+        # Step 2: Create a fresh virtual environment
+        venv_result = subprocess.run(
+            [sys.executable, "-m", "venv", str(venv_path)],
+            capture_output=True,
+            text=True,
+            timeout=30,
+        )
+        assert_that(venv_result.returncode).is_equal_to(0)
+
+        # Determine the Python executable in the venv
+        if sys.platform == "win32":
+            python_exe = venv_path / "Scripts" / "python.exe"
+        else:
+            python_exe = venv_path / "bin" / "python"
+
+        assert_that(python_exe.exists()).is_true()
+
+        # Step 3: Install the wheel in the venv
+        install_result = subprocess.run(
+            [str(python_exe), "-m", "pip", "install", str(wheel_path)],
+            capture_output=True,
+            text=True,
+            timeout=60,
+        )
+        assert_that(install_result.returncode).is_equal_to(0)
+
+        # Step 4: Test importing lintro modules (this is where circular imports fail)
+        test_imports = [
+            "import lintro",
+            "import lintro.parsers",
+            "from lintro.parsers import bandit",
+            "from lintro.parsers.actionlint.actionlint_parser import parse_actionlint_output",  # noqa: E501
+            "from lintro.tools.implementations.tool_actionlint import ActionlintTool",
+            "from lintro.cli import cli",
+        ]
+
+        for import_statement in test_imports:
+            import_result = subprocess.run(
+                [str(python_exe), "-c", import_statement],
+                capture_output=True,
+                text=True,
+                timeout=10,
+            )
+            assert_that(import_result.returncode).described_as(
+                f"Import failed: {import_statement}\n"
+                f"stdout: {import_result.stdout}\n"
+                f"stderr: {import_result.stderr}",
+            ).is_equal_to(0)
+
+        # Step 5: Test that lintro CLI works
+        cli_result = subprocess.run(
+            [str(python_exe), "-m", "lintro", "--version"],
+            capture_output=True,
+            text=True,
+            timeout=10,
+        )
+        assert_that(cli_result.returncode).is_equal_to(0)
+        assert_that(cli_result.stdout).contains("lintro")