lintro 0.7.0__tar.gz → 0.8.0__tar.gz

{lintro-0.7.0/lintro.egg-info → lintro-0.8.0}/PKG-INFO

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

{lintro-0.7.0 → lintro-0.8.0}/assets/images/coverage-badge.svg

@@ -9,13 +9,13 @@
     </clipPath>
     <g clip-path="url(#a)">
         <path fill="#555" d="M0 0h63v20H0z"/>
-        <path fill="#e05d44" d="M63 0h36v20H63z"/>
+        <path fill="#4c1" d="M63 0h36v20H63z"/>
         <path fill="url(#b)" d="M0 0h99v20H0z"/>
     </g>
     <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">83.6%</text>
-        <text x="800" y="140" transform="scale(.1)" textLength="260">83.6%</text>
+        <text x="800" y="150" fill="#010101" fill-opacity=".3" transform="scale(.1)" textLength="260">83.9%</text>
+        <text x="800" y="140" transform="scale(.1)" textLength="260">83.9%</text>
     </g>
 </svg>

{lintro-0.7.0 → lintro-0.8.0}/lintro/__init__.py

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

{lintro-0.7.0 → lintro-0.8.0}/lintro/cli.py

@@ -9,6 +9,12 @@ from lintro.cli_utils.commands.list_tools import list_tools_command
 
 
 class LintroGroup(click.Group):
+    """Custom Click group with enhanced help rendering.
+
+    This group prints command aliases alongside their canonical names to make
+    the CLI help output more discoverable.
+    """
+
     def format_commands(
         self,
         ctx: click.Context,

lintro-0.8.0/lintro/enums/__init__.py

@@ -0,0 +1 @@
+"""Enumeration types used throughout the Lintro codebase."""

{lintro-0.7.0 → lintro-0.8.0}/lintro/enums/darglint_strictness.py

@@ -6,6 +6,8 @@ from enum import StrEnum, auto
 
 
 class DarglintStrictness(StrEnum):
+    """Strictness levels recognized by Darglint checks."""
+
     SHORT = auto()
     LONG = auto()
     FULL = auto()
@@ -14,6 +16,14 @@ class DarglintStrictness(StrEnum):
 def normalize_darglint_strictness(
     value: str | DarglintStrictness,
 ) -> DarglintStrictness:
+    """Normalize a strictness value, defaulting to FULL on error.
+
+    Args:
+        value: String or enum member representing strictness.
+
+    Returns:
+        DarglintStrictness: Normalized strictness enum value.
+    """
     if isinstance(value, DarglintStrictness):
         return value
     try:

{lintro-0.7.0 → lintro-0.8.0}/lintro/enums/hadolint_enums.py

@@ -6,6 +6,8 @@ from enum import StrEnum, auto
 
 
 class HadolintFormat(StrEnum):
+    """Supported output formats for Hadolint."""
+
     TTY = auto()
     JSON = auto()
     CHECKSTYLE = auto()
@@ -18,6 +20,8 @@ class HadolintFormat(StrEnum):
 
 
 class HadolintFailureThreshold(StrEnum):
+    """Hadolint failure thresholds used to gate exit status."""
+
     ERROR = auto()
     WARNING = auto()
     INFO = auto()
@@ -27,6 +31,15 @@ class HadolintFailureThreshold(StrEnum):
 
 
 def normalize_hadolint_format(value: str | HadolintFormat) -> HadolintFormat:
+    """Normalize user input to a HadolintFormat.
+
+    Args:
+        value: Existing enum member or string name of the format.
+
+    Returns:
+        HadolintFormat: Canonical enum value, defaulting to ``TTY`` when
+        parsing fails.
+    """
     if isinstance(value, HadolintFormat):
         return value
     try:
@@ -38,6 +51,15 @@ def normalize_hadolint_format(value: str | HadolintFormat) -> HadolintFormat:
 def normalize_hadolint_threshold(
     value: str | HadolintFailureThreshold,
 ) -> HadolintFailureThreshold:
+    """Normalize user input to a HadolintFailureThreshold.
+
+    Args:
+        value: Existing enum member or string name of the threshold.
+
+    Returns:
+        HadolintFailureThreshold: Canonical enum value, defaulting to ``INFO``
+        when parsing fails.
+    """
     if isinstance(value, HadolintFailureThreshold):
         return value
     try:

{lintro-0.7.0 → lintro-0.8.0}/lintro/enums/yamllint_format.py

@@ -6,6 +6,8 @@ from enum import StrEnum, auto
 
 
 class YamllintFormat(StrEnum):
+    """Output styles supported by Yamllint's CLI."""
+
     PARSABLE = auto()
     STANDARD = auto()
     COLORED = auto()
@@ -14,6 +16,15 @@ class YamllintFormat(StrEnum):
 
 
 def normalize_yamllint_format(value: str | YamllintFormat) -> YamllintFormat:
+    """Normalize a value to a YamllintFormat enum member.
+
+    Args:
+        value: Existing enum member or string name of the format.
+
+    Returns:
+        YamllintFormat: Canonical enum value, defaulting to ``PARSABLE`` when
+        parsing fails.
+    """
     if isinstance(value, YamllintFormat):
         return value
     try:

lintro-0.8.0/lintro/exceptions/__init__.py

@@ -0,0 +1 @@
+"""Project-specific exception classes and error helpers."""

lintro-0.8.0/lintro/formatters/__init__.py

@@ -0,0 +1 @@
+"""Formatters for converting tool outputs into human-friendly tables."""

lintro-0.8.0/lintro/formatters/core/__init__.py

@@ -0,0 +1 @@
+"""Core formatting abstractions for tool-agnostic table rendering."""

{lintro-0.7.0 → lintro-0.8.0}/lintro/formatters/core/output_style.py

@@ -1,8 +1,19 @@
+"""Output style abstraction for rendering tabular data.
+
+Defines a minimal interface consumed by format-specific implementations.
+"""
+
 from abc import ABC, abstractmethod
 from typing import Any
 
 
 class OutputStyle(ABC):
+    """Abstract base class for output style renderers.
+
+    Implementations convert tabular data into a concrete textual
+    representation (e.g., grid, markdown, plain).
+    """
+
     @abstractmethod
     def format(
         self,

{lintro-0.7.0 → lintro-0.8.0}/lintro/formatters/core/table_descriptor.py

@@ -1,8 +1,16 @@
+"""Interfaces for describing table columns and rows for tool issues."""
+
 from abc import ABC, abstractmethod
 from typing import Any
 
 
 class TableDescriptor(ABC):
+    """Describe how to extract tabular data for a tool's issues.
+
+    Concrete implementations define column ordering and how to map issue
+    objects into a list of column values.
+    """
+
     @abstractmethod
     def get_columns(self) -> list[str]:
         """Return the list of column names in order."""

{lintro-0.7.0 → lintro-0.8.0}/lintro/formatters/styles/csv.py

@@ -1,3 +1,5 @@
+"""CSV output style implementation."""
+
 import csv
 import io
 from typing import Any

{lintro-0.7.0 → lintro-0.8.0}/lintro/formatters/styles/grid.py

@@ -1,3 +1,5 @@
+"""Grid output style implementation."""
+
 from typing import Any
 
 from lintro.formatters.core.output_style import OutputStyle

{lintro-0.7.0 → lintro-0.8.0}/lintro/formatters/styles/html.py

@@ -1,3 +1,5 @@
+"""HTML output style implementation."""
+
 from typing import Any
 
 from lintro.formatters.core.output_style import OutputStyle

{lintro-0.7.0 → lintro-0.8.0}/lintro/formatters/styles/json.py

@@ -1,3 +1,5 @@
+"""JSON output style implementation."""
+
 import json
 from datetime import datetime
 from typing import Any

{lintro-0.7.0 → lintro-0.8.0}/lintro/formatters/styles/markdown.py

@@ -1,3 +1,5 @@
+"""Markdown output style implementation."""
+
 from typing import Any
 
 from lintro.formatters.core.output_style import OutputStyle

{lintro-0.7.0 → lintro-0.8.0}/lintro/formatters/styles/plain.py

@@ -1,3 +1,5 @@
+"""Plain text output style implementation."""
+
 from typing import Any
 
 from lintro.formatters.core.output_style import OutputStyle

{lintro-0.7.0 → lintro-0.8.0}/lintro/formatters/tools/black_formatter.py

@@ -2,14 +2,12 @@
 
 from __future__ import annotations
 
-from lintro.formatters.core.table_descriptor import TableDescriptor
 from lintro.formatters.styles.csv import CsvStyle
 from lintro.formatters.styles.grid import GridStyle
 from lintro.formatters.styles.html import HtmlStyle
 from lintro.formatters.styles.json import JsonStyle
 from lintro.formatters.styles.markdown import MarkdownStyle
 from lintro.formatters.styles.plain import PlainStyle
-from lintro.parsers.black.black_issue import BlackIssue
 from lintro.utils.path_utils import normalize_file_path_for_display
 
 FORMAT_MAP = {
@@ -22,11 +20,26 @@ FORMAT_MAP = {
 }
 
 
-class BlackTableDescriptor(TableDescriptor):
+class BlackTableDescriptor:
+    """Column layout for Black issues in tabular output."""
+
     def get_columns(self) -> list[str]:
+        """Return ordered column headers for Black output rows.
+
+        Returns:
+            list[str]: Column names for the formatted table.
+        """
         return ["File", "Message"]
 
-    def get_rows(self, issues: list[BlackIssue]) -> list[list[str]]:
+    def get_rows(self, issues: list) -> list[list[str]]:
+        """Return formatted rows for Black issues.
+
+        Args:
+            issues: Parsed Black issues to render.
+
+        Returns:
+            list[list[str]]: Table rows with normalized file paths and messages.
+        """
         rows: list[list[str]] = []
         for issue in issues:
             rows.append(
@@ -38,7 +51,16 @@ class BlackTableDescriptor(TableDescriptor):
         return rows
 
 
-def format_black_issues(issues: list[BlackIssue], format: str = "grid") -> str:
+def format_black_issues(issues, format: str) -> str:
+    """Format Black issues according to the chosen style.
+
+    Args:
+        issues: Parsed Black issues.
+        format: Output style identifier.
+
+    Returns:
+        str: Rendered table string.
+    """
     descriptor = BlackTableDescriptor()
     formatter = FORMAT_MAP.get(format, GridStyle())
     columns = descriptor.get_columns()

{lintro-0.7.0 → lintro-0.8.0}/lintro/formatters/tools/darglint_formatter.py

@@ -21,13 +21,28 @@ FORMAT_MAP = {
 
 
 class DarglintTableDescriptor(TableDescriptor):
+    """Describe columns and rows for Darglint issues."""
+
     def get_columns(self) -> list[str]:
+        """Return column headers for the Darglint issues table.
+
+        Returns:
+            list[str]: Column names for the formatted table.
+        """
         return ["File", "Line", "Code", "Message"]
 
     def get_rows(
         self,
         issues: list[DarglintIssue],
     ) -> list[list[str]]:
+        """Return rows for the Darglint table.
+
+        Args:
+            issues: Parsed Darglint issues to format.
+
+        Returns:
+            list[list[str]]: Table rows with normalized path, line, code, message.
+        """
         rows = []
         for issue in issues:
             rows.append(
@@ -52,7 +67,7 @@ def format_darglint_issues(
         format: Output format (plain, grid, markdown, html, json, csv).
 
     Returns:
-        Formatted string representation of the issues.
+        str: Formatted string representation of the issues.
     """
     descriptor = DarglintTableDescriptor()
     columns = descriptor.get_columns()

{lintro-0.7.0 → lintro-0.8.0}/lintro/formatters/tools/hadolint_formatter.py

@@ -19,6 +19,11 @@ class HadolintTableDescriptor(TableDescriptor):
     """Describe hadolint issue columns and row extraction."""
 
     def get_columns(self) -> list[str]:
+        """Return ordered column headers for the Hadolint table.
+
+        Returns:
+            list[str]: Column names for the formatted table.
+        """
         return [
             "File",
             "Line",
@@ -32,6 +37,14 @@ class HadolintTableDescriptor(TableDescriptor):
         self,
         issues: list[HadolintIssue],
     ) -> list[list[Any]]:
+        """Return rows for the Hadolint issues table.
+
+        Args:
+            issues: Parsed Hadolint issues to render.
+
+        Returns:
+            list[list[Any]]: Table rows with normalized file path and fields.
+        """
         rows: list[list[Any]] = []
         for issue in issues:
             rows.append(

{lintro-0.7.0 → lintro-0.8.0}/lintro/formatters/tools/prettier_formatter.py

@@ -21,13 +21,28 @@ FORMAT_MAP = {
 
 
 class PrettierTableDescriptor(TableDescriptor):
+    """Describe columns and rows for Prettier issues."""
+
     def get_columns(self) -> list[str]:
+        """Return ordered column headers for the Prettier table.
+
+        Returns:
+            list[str]: Column names for the formatted table.
+        """
         return ["File", "Line", "Column", "Code", "Message"]
 
     def get_rows(
         self,
         issues: list[PrettierIssue],
     ) -> list[list[str]]:
+        """Return rows for the Prettier issues table.
+
+        Args:
+            issues: Parsed Prettier issues to render.
+
+        Returns:
+            list[list[str]]: Table rows with normalized file path and fields.
+        """
         rows = []
         for issue in issues:
             rows.append(

{lintro-0.7.0 → lintro-0.8.0}/lintro/formatters/tools/ruff_formatter.py

@@ -21,13 +21,28 @@ FORMAT_MAP = {
 
 
 class RuffTableDescriptor(TableDescriptor):
+    """Describe columns and rows for Ruff issues."""
+
     def get_columns(self) -> list[str]:
+        """Return ordered column headers for the Ruff table.
+
+        Returns:
+            list[str]: Column names for the formatted table.
+        """
         return ["File", "Line", "Column", "Code", "Message"]
 
     def get_rows(
         self,
         issues: list[RuffIssue | RuffFormatIssue],
     ) -> list[list[str]]:
+        """Return rows for the Ruff issues table.
+
+        Args:
+            issues: Parsed Ruff issues to render.
+
+        Returns:
+            list[list[str]]: Table rows with normalized file path and fields.
+        """
         rows = []
         for issue in issues:
             if isinstance(issue, RuffIssue):
@@ -69,7 +84,7 @@ def format_ruff_issues(
         format: Output format (plain, grid, markdown, html, json, csv).
 
     Returns:
-        Formatted string (one or two tables depending on format).
+        str: Formatted string (one or two tables depending on format).
     """
     descriptor = RuffTableDescriptor()
     formatter = FORMAT_MAP.get(format, GridStyle())

{lintro-0.7.0 → lintro-0.8.0}/lintro/formatters/tools/yamllint_formatter.py

@@ -19,6 +19,11 @@ class YamllintTableDescriptor(TableDescriptor):
     """Describe yamllint issue columns and row extraction."""
 
     def get_columns(self) -> list[str]:
+        """Return ordered column headers for the Yamllint table.
+
+        Returns:
+            list[str]: Column names for the formatted table.
+        """
         return [
             "File",
             "Line",
@@ -32,6 +37,14 @@ class YamllintTableDescriptor(TableDescriptor):
         self,
         issues: list[YamllintIssue],
     ) -> list[list[Any]]:
+        """Return rows for the Yamllint issues table.
+
+        Args:
+            issues: Parsed Yamllint issues to render.
+
+        Returns:
+            list[list[Any]]: Table rows with normalized file path and fields.
+        """
         rows: list[list[Any]] = []
         for issue in issues:
             rows.append(
@@ -61,7 +74,7 @@ def format_yamllint_issues(
         tool_name: Tool name for JSON metadata.
 
     Returns:
-        Rendered string for the issues table.
+        str: Rendered string for the issues table.
     """
     descriptor = YamllintTableDescriptor()
     columns = descriptor.get_columns()

lintro-0.8.0/lintro/models/__init__.py

@@ -0,0 +1 @@
+"""Model package containing issue types and configuration structures."""

lintro-0.8.0/lintro/models/core/__init__.py

@@ -0,0 +1 @@
+"""Core data models used across tool integrations."""

lintro-0.8.0/lintro/models/core/tool_config.py

@@ -0,0 +1,27 @@
+"""Core model for tool configuration used by Lintro tools."""
+
+from dataclasses import dataclass, field
+
+from lintro.enums.tool_type import ToolType
+
+
+@dataclass
+class ToolConfig:
+    """Configuration container for a tool.
+
+    This dataclass defines the static configuration associated with a tool,
+    including its priority, file targeting, type flags, and default options.
+
+    Attributes:
+        priority: int: Priority used when ordering tools.
+        conflicts_with: list[str]: Names of tools that conflict with this one.
+        file_patterns: list[str]: Glob patterns to select applicable files.
+        tool_type: ToolType: Bitmask describing tool capabilities.
+        options: dict[str, object]: Default tool options applied at runtime.
+    """
+
+    priority: int = 0
+    conflicts_with: list[str] = field(default_factory=list)
+    file_patterns: list[str] = field(default_factory=list)
+    tool_type: ToolType = ToolType.LINTER
+    options: dict[str, object] = field(default_factory=dict)

lintro-0.8.0/lintro/parsers/darglint/__init__.py

@@ -0,0 +1 @@
+"""Parsing utilities and types for Darglint output."""

lintro-0.8.0/lintro/parsers/darglint/darglint_issue.py

@@ -0,0 +1,20 @@
+"""Typed structure representing a single Darglint issue."""
+
+from dataclasses import dataclass
+
+
+@dataclass
+class DarglintIssue:
+    """Simple container for Darglint findings.
+
+    Attributes:
+        file: File path where the issue occurred.
+        line: Line number of the issue.
+        code: Darglint error code.
+        message: Human-readable description of the issue.
+    """
+
+    file: str
+    line: int
+    code: str
+    message: str

lintro-0.8.0/lintro/parsers/prettier/__init__.py

@@ -0,0 +1 @@
+"""Parsing utilities and types for Prettier output."""

lintro-0.8.0/lintro/parsers/prettier/prettier_issue.py

@@ -0,0 +1,22 @@
+"""Typed structure representing a single Prettier issue."""
+
+from dataclasses import dataclass
+
+
+@dataclass
+class PrettierIssue:
+    """Simple container for Prettier findings.
+
+    Attributes:
+        file: File path where the issue occurred.
+        line: Line number, if provided by Prettier.
+        code: Tool-specific code identifying the rule.
+        message: Human-readable description of the issue.
+        column: Column number, if provided by Prettier.
+    """
+
+    file: str
+    line: int | None
+    code: str
+    message: str
+    column: int | None = None

{lintro-0.7.0 → lintro-0.8.0}/lintro/parsers/ruff/ruff_parser.py

@@ -129,8 +129,12 @@ def parse_ruff_format_check_output(output: str) -> list[str]:
     if not output:
         return []
     files = []
-    for line in output.splitlines():
-        line = line.strip()
+    import re
+
+    ansi_re = re.compile(r"\x1b\[[0-9;]*m")
+    for raw in output.splitlines():
+        # Strip ANSI color codes for stable parsing across environments
+        line = ansi_re.sub("", raw).strip()
         # Ruff format --check output: 'Would reformat: path/to/file.py' or
         # 'Would reformat path/to/file.py'
         if line.startswith("Would reformat: "):

lintro-0.8.0/lintro/parsers/yamllint/__init__.py

@@ -0,0 +1 @@
+"""Parsing utilities and types for Yamllint output."""

lintro-0.8.0/lintro/tools/core/__init__.py

@@ -0,0 +1 @@
+"""Base classes and utilities for tool implementations."""

{lintro-0.7.0 → lintro-0.8.0}/lintro/tools/core/tool_base.py

@@ -147,6 +147,9 @@ class BaseTool(ABC):
             TimeoutExpired: If command times out.
             FileNotFoundError: If command executable is not found.
         """
+        # Validate command arguments for safety prior to execution
+        self._validate_subprocess_command(cmd=cmd)
+
         try:
             result = subprocess.run(  # nosec B603 - args list, shell=False
                 cmd,
@@ -157,7 +160,6 @@ class BaseTool(ABC):
                     "timeout",
                     self._default_timeout,
                 ),
-                check=False,
                 cwd=cwd,
             )
             return result.returncode == 0, result.stdout + result.stderr
@@ -184,6 +186,31 @@ class BaseTool(ABC):
                 f"Please ensure it is installed and in your PATH.",
             ) from e
 
+    def _validate_subprocess_command(self, cmd: list[str]) -> None:
+        """Validate a subprocess command argument list for safety.
+
+        Ensures that the command is a non-empty list of strings and that no
+        argument contains shell metacharacters that could enable command
+        injection when passed to subprocess (even with ``shell=False``).
+
+        Args:
+            cmd: list[str]: Command and arguments to validate.
+
+        Raises:
+            ValueError: If the command list is empty, contains non-strings,
+                or contains unsafe characters.
+        """
+        if not cmd or not isinstance(cmd, list):
+            raise ValueError("Command must be a non-empty list of strings")
+
+        unsafe_chars: set[str] = {";", "&", "|", ">", "<", "`", "$", "\\", "\n", "\r"}
+
+        for arg in cmd:
+            if not isinstance(arg, str):
+                raise ValueError("All command arguments must be strings")
+            if any(ch in arg for ch in unsafe_chars):
+                raise ValueError("Unsafe character detected in command argument")
+
     def set_options(self, **kwargs) -> None:
         """Set core options.
 
@@ -233,11 +260,10 @@ class BaseTool(ABC):
         self,
         paths: list[str],
     ) -> str | None:
-        """Return the common parent directory for the given paths, or None if not
-        applicable.
+        """Return the common parent directory for the given paths.
 
         Args:
-            paths: list[str]: List of file paths to find common parent directory for.
+            paths: list[str]: Paths to compute a common parent directory for.
 
         Returns:
             str | None: Common parent directory path, or None if not applicable.
@@ -300,10 +326,10 @@ class BaseTool(ABC):
         if tool_name in python_tools_prefer_uv:
             if shutil.which(tool_name):
                 return [tool_name]
-            if shutil.which("uv"):
-                return ["uv", "run", tool_name]
             if shutil.which("uvx"):
                 return ["uvx", tool_name]
+            if shutil.which("uv"):
+                return ["uv", "run", tool_name]
             return [tool_name]
 
         # Default: prefer direct system executable (node/binary tools like

lintro-0.8.0/lintro/tools/implementations/__init__.py

@@ -0,0 +1 @@
+"""Concrete tool integrations (Ruff, Black, Prettier, etc.)."""