lintro 0.6.3__tar.gz → 0.8.0__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lintro
-Version: 0.6.3
+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
@@ -50,21 +50,21 @@ Requires-Dist: toml==0.10.2
 Requires-Dist: defusedxml==0.7.1
 Provides-Extra: dev
 Requires-Dist: pytest==8.4.2; extra == "dev"
-Requires-Dist: pytest-cov==6.3.0; extra == "dev"
-Requires-Dist: pytest-mock==3.15.0; extra == "dev"
+Requires-Dist: pytest-cov==7.0.0; extra == "dev"
+Requires-Dist: pytest-mock==3.15.1; extra == "dev"
 Requires-Dist: pytest-xdist==3.8.0; extra == "dev"
-Requires-Dist: tox==4.30.1; extra == "dev"
+Requires-Dist: tox==4.30.3; extra == "dev"
 Requires-Dist: allure-pytest==2.15.0; extra == "dev"
 Requires-Dist: ruff; extra == "dev"
 Requires-Dist: mypy; extra == "dev"
 Requires-Dist: coverage-badge==1.1.2; extra == "dev"
-Requires-Dist: python-semantic-release==10.3.2; extra == "dev"
+Requires-Dist: python-semantic-release==10.4.1; extra == "dev"
 Requires-Dist: assertpy==1.1; extra == "dev"
 Requires-Dist: httpx==0.28.1; extra == "dev"
 Provides-Extra: test
 Requires-Dist: pytest==8.4.2; extra == "test"
-Requires-Dist: pytest-cov==6.3.0; extra == "test"
-Requires-Dist: pytest-mock==3.15.0; extra == "test"
+Requires-Dist: pytest-cov==7.0.0; extra == "test"
+Requires-Dist: pytest-mock==3.15.1; extra == "test"
 Requires-Dist: pytest-xdist==3.8.0; extra == "test"
 Requires-Dist: assertpy==1.1; extra == "test"
 Provides-Extra: typing
@@ -88,12 +88,12 @@ Lintro is a unified command-line interface that brings together multiple code qu
 [![Tests](https://img.shields.io/github/actions/workflow/status/TurboCoder13/py-lintro/test-and-coverage.yml?label=tests&branch=main&logo=githubactions&logoColor=white)](https://github.com/TurboCoder13/py-lintro/actions/workflows/test-and-coverage.yml?query=branch%3Amain)
 [![CI](https://img.shields.io/github/actions/workflow/status/TurboCoder13/py-lintro/ci-lintro-analysis.yml?label=ci&branch=main&logo=githubactions&logoColor=white)](https://github.com/TurboCoder13/py-lintro/actions/workflows/ci-lintro-analysis.yml?query=branch%3Amain)
 [![Docker](https://img.shields.io/github/actions/workflow/status/TurboCoder13/py-lintro/docker-build-publish.yml?label=docker&logo=docker&branch=main)](https://github.com/TurboCoder13/py-lintro/actions/workflows/docker-build-publish.yml?query=branch%3Amain)
+[![SBOM (main)](<https://img.shields.io/github/actions/workflow/status/TurboCoder13/py-lintro/sbom-on-main.yml?label=sbom%20(main)&branch=main>)](https://github.com/TurboCoder13/py-lintro/actions/workflows/sbom-on-main.yml?query=branch%3Amain)
+[![Release pipeline (tags)](<https://img.shields.io/github/actions/workflow/status/TurboCoder13/py-lintro/publish-pypi-on-tag.yml?label=release%20pipeline%20(tags)&event=push>)](https://github.com/TurboCoder13/py-lintro/actions/workflows/publish-pypi-on-tag.yml?query=event%3Apush)
 [![PyPI](https://img.shields.io/pypi/v/lintro?label=pypi)](https://pypi.org/project/lintro/)
 
 [![CodeQL](https://github.com/TurboCoder13/py-lintro/actions/workflows/codeql.yml/badge.svg?branch=main)](https://github.com/TurboCoder13/py-lintro/actions/workflows/codeql.yml?query=branch%3Amain)
-[![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/TurboCoder13/py-lintro/badge)](https://scorecard.dev/viewer/?uri=github.com/TurboCoder13/py-lintro)
-
-[![OpenSSF Best Practices](https://www.bestpractices.dev/projects/11142/badge)](https://www.bestpractices.dev/projects/11142)
+[![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/TurboCoder13/py-lintro/badge)](https://scorecard.dev/viewer/?uri=github.com/TurboCoder13/py-lintro) [![SBOM](https://img.shields.io/badge/SBOM-enabled-brightgreen)](docs/security/assurance.md) [![Download SBOM](https://img.shields.io/badge/SBOM-download_latest-blue?logo=github)](https://github.com/TurboCoder13/py-lintro/actions/workflows/sbom-on-main.yml) [![OpenSSF Best Practices](https://www.bestpractices.dev/projects/11142/badge)](https://www.bestpractices.dev/projects/11142)
 
 ### Why Lintro?
 
@@ -114,6 +114,42 @@ Lintro is a unified command-line interface that brings together multiple code qu
 - **Docker support** for containerized environments
 - **CI/CD integration** with GitHub Actions
 
+## Security & Compliance
+
+Lintro follows modern security best practices and provides comprehensive supply chain transparency:
+
+- **SBOM Generation**: Automated Software Bill of Materials on every push to main
+- **Formats**: CycloneDX 1.6 and SPDX 2.3 (industry standards)
+- **Compliance**: Meets Executive Order 14028 requirements for federal software
+- **Download**: [Latest SBOM artifacts](https://github.com/TurboCoder13/py-lintro/actions/workflows/sbom-on-main.yml)
+- **Documentation**: See [Security Assurance](docs/security/assurance.md) for details
+
+### What's in the SBOM?
+
+The SBOM provides a complete inventory of all dependencies:
+
+- All Python packages with exact versions
+- All npm packages (like Prettier)
+- All GitHub Actions dependencies (pinned by SHA)
+- Transitive dependencies
+- License information
+
+### For Enterprise Users
+
+Download SBOMs for security auditing and compliance:
+
+```bash
+# Download latest SBOM artifacts
+gh run download -R TurboCoder13/py-lintro \
+  --name sbom-artifacts \
+  $(gh run list -R TurboCoder13/py-lintro \
+    -w "Security - SBOM Generation" -L 1 \
+    --json databaseId -q '.[0].databaseId')
+
+# Scan for vulnerabilities (requires grype)
+grype sbom:main-*-py-lintro-sbom.spdx-2.3.json
+```
+
 ## Supported Tools
 
 | Tool                                                                                                                                                | Language            | Auto-fix |

{lintro-0.6.3 → lintro-0.8.0}/README.md

@@ -14,12 +14,12 @@ Lintro is a unified command-line interface that brings together multiple code qu
 [![Tests](https://img.shields.io/github/actions/workflow/status/TurboCoder13/py-lintro/test-and-coverage.yml?label=tests&branch=main&logo=githubactions&logoColor=white)](https://github.com/TurboCoder13/py-lintro/actions/workflows/test-and-coverage.yml?query=branch%3Amain)
 [![CI](https://img.shields.io/github/actions/workflow/status/TurboCoder13/py-lintro/ci-lintro-analysis.yml?label=ci&branch=main&logo=githubactions&logoColor=white)](https://github.com/TurboCoder13/py-lintro/actions/workflows/ci-lintro-analysis.yml?query=branch%3Amain)
 [![Docker](https://img.shields.io/github/actions/workflow/status/TurboCoder13/py-lintro/docker-build-publish.yml?label=docker&logo=docker&branch=main)](https://github.com/TurboCoder13/py-lintro/actions/workflows/docker-build-publish.yml?query=branch%3Amain)
+[![SBOM (main)](<https://img.shields.io/github/actions/workflow/status/TurboCoder13/py-lintro/sbom-on-main.yml?label=sbom%20(main)&branch=main>)](https://github.com/TurboCoder13/py-lintro/actions/workflows/sbom-on-main.yml?query=branch%3Amain)
+[![Release pipeline (tags)](<https://img.shields.io/github/actions/workflow/status/TurboCoder13/py-lintro/publish-pypi-on-tag.yml?label=release%20pipeline%20(tags)&event=push>)](https://github.com/TurboCoder13/py-lintro/actions/workflows/publish-pypi-on-tag.yml?query=event%3Apush)
 [![PyPI](https://img.shields.io/pypi/v/lintro?label=pypi)](https://pypi.org/project/lintro/)
 
 [![CodeQL](https://github.com/TurboCoder13/py-lintro/actions/workflows/codeql.yml/badge.svg?branch=main)](https://github.com/TurboCoder13/py-lintro/actions/workflows/codeql.yml?query=branch%3Amain)
-[![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/TurboCoder13/py-lintro/badge)](https://scorecard.dev/viewer/?uri=github.com/TurboCoder13/py-lintro)
-
-[![OpenSSF Best Practices](https://www.bestpractices.dev/projects/11142/badge)](https://www.bestpractices.dev/projects/11142)
+[![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/TurboCoder13/py-lintro/badge)](https://scorecard.dev/viewer/?uri=github.com/TurboCoder13/py-lintro) [![SBOM](https://img.shields.io/badge/SBOM-enabled-brightgreen)](docs/security/assurance.md) [![Download SBOM](https://img.shields.io/badge/SBOM-download_latest-blue?logo=github)](https://github.com/TurboCoder13/py-lintro/actions/workflows/sbom-on-main.yml) [![OpenSSF Best Practices](https://www.bestpractices.dev/projects/11142/badge)](https://www.bestpractices.dev/projects/11142)
 
 ### Why Lintro?
 
@@ -40,6 +40,42 @@ Lintro is a unified command-line interface that brings together multiple code qu
 - **Docker support** for containerized environments
 - **CI/CD integration** with GitHub Actions
 
+## Security & Compliance
+
+Lintro follows modern security best practices and provides comprehensive supply chain transparency:
+
+- **SBOM Generation**: Automated Software Bill of Materials on every push to main
+- **Formats**: CycloneDX 1.6 and SPDX 2.3 (industry standards)
+- **Compliance**: Meets Executive Order 14028 requirements for federal software
+- **Download**: [Latest SBOM artifacts](https://github.com/TurboCoder13/py-lintro/actions/workflows/sbom-on-main.yml)
+- **Documentation**: See [Security Assurance](docs/security/assurance.md) for details
+
+### What's in the SBOM?
+
+The SBOM provides a complete inventory of all dependencies:
+
+- All Python packages with exact versions
+- All npm packages (like Prettier)
+- All GitHub Actions dependencies (pinned by SHA)
+- Transitive dependencies
+- License information
+
+### For Enterprise Users
+
+Download SBOMs for security auditing and compliance:
+
+```bash
+# Download latest SBOM artifacts
+gh run download -R TurboCoder13/py-lintro \
+  --name sbom-artifacts \
+  $(gh run list -R TurboCoder13/py-lintro \
+    -w "Security - SBOM Generation" -L 1 \
+    --json databaseId -q '.[0].databaseId')
+
+# Scan for vulnerabilities (requires grype)
+grype sbom:main-*-py-lintro-sbom.spdx-2.3.json
+```
+
 ## Supported Tools
 
 | Tool                                                                                                                                                | Language            | Auto-fix |

{lintro-0.6.3 → 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.7%</text>
-        <text x="800" y="140" transform="scale(.1)" textLength="260">83.7%</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.6.3 → lintro-0.8.0}/docs/README.md

@@ -30,7 +30,6 @@ Welcome to the Lintro documentation! This hub provides comprehensive guides for
 - **[Style Guide](style-guide.md)** - Coding standards and best practices
 - **[Coverage Setup](coverage-setup.md)** - Test coverage configuration reference
 - **[Self-Use Documentation](lintro-self-use.md)** - How Lintro uses itself
-- **[Removed CLI Options](removed_cli_options.md)** - Deprecated features reference
 
 ## 🚀 Quick Links
 
@@ -171,10 +170,12 @@ docker run --rm -v "$(pwd):/code" lintro:latest check
 
 ## 🆕 Recent Updates
 
+- **Security audit framework** - Comprehensive security verification for workflows and scripts
+- **DRY consolidation** - Reduced duplicate patterns across workflows and actions
+- **Shell-free design** - Moved inline shell commands to dedicated scripts
+- **Environment standardization** - Consistent variable usage across all workflows
 - **Documentation restructure** - Improved organization and navigation
-- **New tool analysis** - Detailed comparisons with core tools
-- **Enhanced GitHub integration** - More workflow examples
-- **Comprehensive configuration guide** - All tools covered
+- **Enhanced tool analysis** - Detailed comparisons with core tools
 
 ## 🤝 Contributing to Documentation
 

lintro-0.8.0/docs/security/assurance.md

@@ -0,0 +1,79 @@
+# Security Assurance (Overview)
+
+This assurance note explains how `py-lintro` meets its documented security requirements and provides pointers to evidence.
+
+## Requirements Coverage
+
+- Governance and Roles — see `GOVERNANCE.md`
+- Contribution Integrity — DCO sign-offs required; see `DCO.md` and CI checks
+- Responsible Disclosure — see `SECURITY.md`
+- Branch Protection — enforced via Allstar (`.allstar/branch_protection.yaml`)
+- Dependency Hygiene — Renovate, Dependency Review CI, `uv.lock`
+- Static/SAST — Ruff, Bandit, CodeQL; policy checks for workflows (Actionlint)
+- Container and Dockerfile — Hadolint
+- SBOM (Software Bill of Materials) — Automated generation in CycloneDX 1.6 and SPDX 2.3 formats
+  - Workflow: `.github/workflows/sbom-on-main.yml`
+  - Generated on every push to main branch
+  - Includes all Python, npm, and GitHub Actions dependencies
+  - Artifacts available via GitHub Actions (90-day retention)
+  - Meets Executive Order 14028 federal software requirements
+- Documentation and Versioning — `README.md`, `CHANGELOG.md`, semantic releases
+
+## Evidence Pointers
+
+- CI Workflows: `.github/workflows/*.yml`
+- Allstar Policy: `.allstar/branch_protection.yaml`
+- Scorecard: badge in `README.md`
+- Coverage: `coverage.xml` and README badge
+
+## SBOM (Supply Chain Transparency)
+
+py-lintro automatically generates Software Bill of Materials (SBOM) for supply chain security:
+
+### What is Generated
+
+- **CycloneDX 1.6 JSON**: Industry-standard format for dependency tracking
+- **SPDX 2.3 JSON**: Linux Foundation standard for license compliance
+- **Complete inventory**: All direct and transitive dependencies
+- **Cryptographic hashes**: For verification and integrity checking
+
+### How to Access
+
+1. **Via GitHub Actions UI**:
+   - Navigate to [SBOM workflow runs](https://github.com/TurboCoder13/py-lintro/actions/workflows/sbom-on-main.yml)
+   - Select the latest successful run
+   - Download "sbom-artifacts" from the Artifacts section
+
+2. **Via GitHub CLI**:
+
+   ```bash
+   gh run download -R TurboCoder13/py-lintro --name sbom-artifacts
+   ```
+
+3. **Via API**:
+   ```bash
+   gh api repos/TurboCoder13/py-lintro/actions/artifacts \
+     --jq '.artifacts[] | select(.name=="sbom-artifacts") | .archive_download_url'
+   ```
+
+### Use Cases
+
+- **Security Scanning**: Feed into vulnerability scanners (Grype, Snyk, etc.)
+- **License Compliance**: Audit all dependency licenses
+- **Supply Chain Security**: Track all software components
+- **Federal Compliance**: Meets EO 14028 requirements
+- **Enterprise Procurement**: Satisfy security questionnaires
+
+### File Naming Convention
+
+SBOM files are named: `{branch}-{commit-sha}-py-lintro-sbom.{format}.json`
+
+Example: `main-3b97378f3438-py-lintro-sbom.cyclonedx-1.6.json`
+
+This ensures traceability to exact codebase versions.
+
+## Continuous Improvement
+
+- Periodic updates via Renovate
+- Automated analyses (Scorecard, CodeQL)
+- Maintainer reviews for all changes

{lintro-0.6.3 → 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.6.3"
+__version__ = "0.8.0"

{lintro-0.6.3 → 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.6.3 → 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.6.3 → 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.6.3 → 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.6.3 → 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.6.3 → 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.6.3 → 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.6.3 → 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.6.3 → 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.6.3 → 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.6.3 → 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.6.3 → 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.6.3 → 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.6.3 → 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.6.3 → 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.6.3 → 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(