lintro 0.42.5__tar.gz

lintro-0.42.5/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 lgtm-hq
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE. 

lintro-0.42.5/MANIFEST.in

@@ -0,0 +1,17 @@
+include LICENSE
+include README.md
+include pyproject.toml
+
+# Include assets directory and its contents
+recursive-include assets *
+recursive-include lintro/ascii-art *
+
+# Include any additional documentation
+recursive-include docs *.md
+
+# Include test files for development
+recursive-include tests *.py
+recursive-include test_samples *.py
+recursive-include test_samples *.yml
+recursive-include test_samples *.js
+recursive-include test_samples Dockerfile.* 

lintro-0.42.5/PKG-INFO

@@ -0,0 +1,313 @@
+Metadata-Version: 2.4
+Name: lintro
+Version: 0.42.5
+Summary: A unified CLI tool for code formatting, linting, and quality assurance
+Author-email: lgtm-hq <turbocoder13@gmail.com>
+License: MIT License
+        
+        Copyright (c) 2024 lgtm-hq
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE. 
+Project-URL: Homepage, https://github.com/lgtm-hq/py-lintro
+Project-URL: Documentation, https://github.com/lgtm-hq/py-lintro/docs
+Project-URL: Source, https://github.com/lgtm-hq/py-lintro
+Keywords: linting,formatting,code-quality,cli,python,javascript,yaml,docker
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+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.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click==8.1.8
+Requires-Dist: coverage-badge==1.1.2
+Requires-Dist: loguru==0.7.3
+Requires-Dist: packaging>=25.0
+Requires-Dist: pathspec>=0.12.1
+Requires-Dist: pydantic>=2.12.5
+Requires-Dist: rich>=14.2.0
+Requires-Dist: tabulate==0.9.0
+Requires-Dist: yamllint==1.37.1
+Requires-Dist: httpx==0.28.1
+Requires-Dist: defusedxml==0.7.1
+Requires-Dist: ruff>=0.14.10
+Requires-Dist: black>=25.12.0
+Requires-Dist: bandit>=1.9.2
+Requires-Dist: mypy>=1.19.1
+Requires-Dist: pydoclint>=0.8.3
+Provides-Extra: dev
+Requires-Dist: pytest==9.0.2; 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: pytest-sugar==1.1.1; extra == "dev"
+Requires-Dist: tox==4.34.1; extra == "dev"
+Requires-Dist: allure-pytest==2.15.3; 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.5.3; extra == "dev"
+Requires-Dist: assertpy==1.1; extra == "dev"
+Requires-Dist: httpx==0.28.1; extra == "dev"
+Provides-Extra: test
+Requires-Dist: pytest==9.0.2; 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
+Requires-Dist: types-setuptools==80.9.0.20251223; extra == "typing"
+Requires-Dist: types-tabulate==0.9.0.20241207; extra == "typing"
+Provides-Extra: tools
+Requires-Dist: semgrep>=1.85.0; extra == "tools"
+Requires-Dist: sqlfluff>=4.0.0; extra == "tools"
+Dynamic: license-file
+
+# Lintro
+
+<!-- markdownlint-disable MD033 MD013 -->
+<img src="https://raw.githubusercontent.com/lgtm-hq/py-lintro/main/assets/images/lintro.png" alt="Lintro Logo" style="width:100%;max-width:800px;height:auto;display:block;margin:0 auto 24px auto;">
+<!-- markdownlint-enable MD033 MD013 -->
+
+A comprehensive CLI tool that unifies various code formatting, linting, and quality
+assurance tools under a single command-line interface.
+
+<!-- Badges: Build & Quality -->
+
+[![Tests](https://img.shields.io/github/actions/workflow/status/lgtm-hq/py-lintro/test-and-coverage.yml?label=tests&branch=main&logo=githubactions&logoColor=white)](https://github.com/lgtm-hq/py-lintro/actions/workflows/test-and-coverage.yml?query=branch%3Amain)
+[![CI](https://img.shields.io/github/actions/workflow/status/lgtm-hq/py-lintro/ci-lintro-analysis.yml?label=ci&branch=main&logo=githubactions&logoColor=white)](https://github.com/lgtm-hq/py-lintro/actions/workflows/ci-lintro-analysis.yml?query=branch%3Amain)
+[![Docker](https://img.shields.io/github/actions/workflow/status/lgtm-hq/py-lintro/docker-build-publish.yml?label=docker&logo=docker&branch=main)](https://github.com/lgtm-hq/py-lintro/actions/workflows/docker-build-publish.yml?query=branch%3Amain)
+[![Coverage](https://codecov.io/gh/lgtm-hq/py-lintro/branch/main/graph/badge.svg)](https://codecov.io/gh/lgtm-hq/py-lintro)
+
+<!-- Badges: Releases -->
+
+[![Release](https://img.shields.io/github/v/release/lgtm-hq/py-lintro?label=release)](https://github.com/lgtm-hq/py-lintro/releases/latest)
+[![PyPI](https://img.shields.io/pypi/v/lintro?label=pypi)](https://pypi.org/project/lintro/)
+[![Python](https://img.shields.io/badge/python-3.11+-blue)](https://www.python.org/downloads/)
+[![License](https://img.shields.io/badge/license-MIT-green)](LICENSE)
+
+<!-- Badges: Security & Supply Chain -->
+
+[![CodeQL](https://github.com/lgtm-hq/py-lintro/actions/workflows/codeql.yml/badge.svg?branch=main)](https://github.com/lgtm-hq/py-lintro/actions/workflows/codeql.yml?query=branch%3Amain)
+[![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/lgtm-hq/py-lintro/badge)](https://scorecard.dev/viewer/?uri=github.com/lgtm-hq/py-lintro)
+[![OpenSSF Best Practices](https://www.bestpractices.dev/projects/11142/badge)](https://www.bestpractices.dev/projects/11142)
+[![SBOM](https://img.shields.io/badge/SBOM-CycloneDX-brightgreen)](docs/security/assurance.md)
+[![SBOM Status](https://img.shields.io/github/actions/workflow/status/lgtm-hq/py-lintro/sbom-on-main.yml?label=sbom&branch=main)](https://github.com/lgtm-hq/py-lintro/actions/workflows/sbom-on-main.yml?query=branch%3Amain)
+
+## 🚀 Quick Start
+
+```bash
+pip install lintro          # Install
+lintro check .              # Find issues
+lintro format .             # Fix issues
+lintro check --output-format grid   # Beautiful output
+```
+
+<!-- TODO: Add screenshot of grid output -->
+
+## ✨ Why Lintro?
+
+- **🎯 Unified Interface** - One command for all your linting and formatting tools
+- **📊 Consistent Output** - Beautiful, standardized output formats across all tools
+- **🔧 Auto-fixing** - Automatically fix issues where possible
+- **🐳 Docker Ready** - Run in isolated containers for consistent environments
+- **📈 Rich Reporting** - Multiple formats: grid, JSON, HTML, CSV, Markdown
+- **⚡ Fast** - Optimized parallel execution
+
+## 🔌 Works With Your Existing Configs
+
+Lintro respects your native tool configurations. If you have a `.prettierrc`,
+`pyproject.toml [tool.ruff]`, or `.yamllint`, Lintro uses them automatically - no
+migration required.
+
+- **Native configs are detected** - Your existing `.prettierrc`, `.eslintrc`, etc. work
+  as-is
+- **Enforce settings override consistently** - Set `line_length: 88` once, applied
+  everywhere
+- **Fallback defaults when needed** - Tools without native configs use sensible defaults
+
+See the [Configuration Guide](docs/configuration.md) for details on the 4-tier config
+system.
+
+## 🛠️ Supported Tools
+
+<!-- markdownlint-disable MD013 MD060 -->
+
+| Tool                                                                                                                                                          | Language            | Auto-fix |
+| ------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------- | -------- |
+| [![Actionlint](https://img.shields.io/badge/Actionlint-lint-24292e?logo=github&logoColor=white)](https://github.com/rhysd/actionlint)                         | ⚙️ GitHub Actions   | -        |
+| [![Bandit](https://img.shields.io/badge/Bandit-security-yellow?logo=python&logoColor=white)](https://github.com/PyCQA/bandit)                                 | 🐍 Python           | -        |
+| [![Black](https://img.shields.io/badge/Black-format-000000?logo=python&logoColor=white)](https://github.com/psf/black)                                        | 🐍 Python           | ✅       |
+| [![Clippy](https://img.shields.io/badge/Clippy-lint-000000?logo=rust&logoColor=white)](https://github.com/rust-lang/rust-clippy)                              | 🦀 Rust             | ✅       |
+| [![Gitleaks](https://img.shields.io/badge/Gitleaks-secrets-dc2626?logo=git&logoColor=white)](https://gitleaks.io/)                                            | 🔐 Secret Detection | -        |
+| [![Hadolint](https://img.shields.io/badge/Hadolint-lint-2496ED?logo=docker&logoColor=white)](https://github.com/hadolint/hadolint)                            | 🐳 Dockerfile       | -        |
+| [![Markdownlint](https://img.shields.io/badge/Markdownlint--cli2-lint-000000?logo=markdown&logoColor=white)](https://github.com/DavidAnson/markdownlint-cli2) | 📝 Markdown         | -        |
+| [![Mypy](https://img.shields.io/badge/Mypy-type%20checking-2d50a5?logo=python&logoColor=white)](https://mypy-lang.org/)                                       | 🐍 Python           | -        |
+| [![Oxfmt](https://img.shields.io/badge/Oxfmt-format-e05d44?logo=javascript&logoColor=white)](https://oxc.rs/)                                                 | 🟨 JS/TS            | ✅       |
+| [![Oxlint](https://img.shields.io/badge/Oxlint-lint-e05d44?logo=javascript&logoColor=white)](https://oxc.rs/)                                                 | 🟨 JS/TS            | ✅       |
+| [![Prettier](https://img.shields.io/badge/Prettier-format-1a2b34?logo=prettier&logoColor=white)](https://prettier.io/)                                        | 🟨 JS/TS · 🧾 JSON  | ✅       |
+| [![pydoclint](https://img.shields.io/badge/pydoclint-docstrings-3776AB?logo=python&logoColor=white)](https://github.com/jsh9/pydoclint)                       | 🐍 Python           | -        |
+| [![Ruff](https://img.shields.io/badge/Ruff-lint%2Bformat-000?logo=ruff&logoColor=white)](https://github.com/astral-sh/ruff)                                   | 🐍 Python           | ✅       |
+| [![Semgrep](https://img.shields.io/badge/Semgrep-security-5b21b6?logo=semgrep&logoColor=white)](https://semgrep.dev/)                                         | 🔒 Multi-language   | -        |
+| [![ShellCheck](https://img.shields.io/badge/ShellCheck-lint-4EAA25?logo=gnubash&logoColor=white)](https://www.shellcheck.net/)                                | 🐚 Shell Scripts    | -        |
+| [![shfmt](https://img.shields.io/badge/shfmt-format-4EAA25?logo=gnubash&logoColor=white)](https://github.com/mvdan/sh)                                        | 🐚 Shell Scripts    | ✅       |
+| [![SQLFluff](https://img.shields.io/badge/SQLFluff-lint%2Bformat-4b5563?logo=database&logoColor=white)](https://sqlfluff.com/)                                | 🗃️ SQL              | ✅       |
+| [![Taplo](https://img.shields.io/badge/Taplo-lint%2Bformat-9b4dca?logo=toml&logoColor=white)](https://taplo.tamasfe.dev/)                                     | 🧾 TOML             | ✅       |
+| [![TypeScript](https://img.shields.io/badge/TypeScript-type%20check-3178c6?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)                 | 🟨 JS/TS            | -        |
+| [![Yamllint](https://img.shields.io/badge/Yamllint-lint-cb171e?logo=yaml&logoColor=white)](https://github.com/adrienverge/yamllint)                           | 🧾 YAML             | -        |
+
+<!-- markdownlint-enable MD013 MD060 -->
+
+## 📋 Requirements
+
+### Python Version
+
+**Python 3.11+** is required. Lintro uses modern Python features not available in older
+versions.
+
+### Bundled Tools
+
+These Python tools are automatically installed with Lintro:
+
+- **Ruff** - Fast Python linter and formatter
+- **Black** - Python code formatter
+- **Bandit** - Python security linter
+- **Mypy** - Python static type checker
+- **Yamllint** - YAML linter
+- **pydoclint** - Python docstring linter
+
+### Optional External Tools
+
+For full functionality, install these additional tools:
+
+- **Prettier** - `npm install -g prettier`
+- **Markdownlint-cli2** - `npm install -g markdownlint-cli2`
+- **Oxlint** - `bun add -g oxlint` or `npm install -g oxlint`
+- **Oxfmt** - `bun add -g oxfmt` or `npm install -g oxfmt`
+- **Hadolint** - [GitHub Releases](https://github.com/hadolint/hadolint/releases)
+- **Actionlint** - [GitHub Releases](https://github.com/rhysd/actionlint/releases)
+- **Semgrep** - `pipx install semgrep`, `pip install semgrep`, or `brew install semgrep`
+- **Gitleaks** - `brew install gitleaks` or
+  [GitHub Releases](https://github.com/gitleaks/gitleaks/releases)
+- **ShellCheck** - `brew install shellcheck` or
+  [GitHub Releases](https://github.com/koalaman/shellcheck/releases)
+- **shfmt** - `brew install shfmt` or
+  [GitHub Releases](https://github.com/mvdan/sh/releases)
+- **SQLFluff** - `pip install sqlfluff`
+- **Taplo** - `brew install taplo` or
+  [GitHub Releases](https://github.com/tamasfe/taplo/releases)
+- **TypeScript** - `brew install typescript`, `bun add -g typescript`, or
+  `npm install -g typescript`
+
+Check all tool versions with: `lintro list-tools`
+
+## 📦 Installation
+
+```bash
+# PyPI (recommended)
+pip install lintro
+
+# Homebrew (macOS binary)
+brew tap lgtm-hq/tap && brew install lintro-bin
+
+# Docker (includes all tools)
+docker run --rm -v $(pwd):/code ghcr.io/lgtm-hq/py-lintro:latest check
+```
+
+See [Getting Started](docs/getting-started.md) for detailed installation options.
+
+## 💻 Usage
+
+```bash
+# Check all files
+lintro check .
+
+# Auto-fix issues
+lintro format .
+
+# Grid output with grouping
+lintro check --output-format grid --group-by file
+
+# Run specific tools
+lintro check --tools ruff,prettier,mypy
+
+# Exclude directories
+lintro check --exclude "node_modules,dist,venv"
+
+# List available tools
+lintro list-tools
+```
+
+### 🐳 Docker
+
+```bash
+# Run from GHCR
+docker run --rm -v $(pwd):/code ghcr.io/lgtm-hq/py-lintro:latest check
+
+# With formatting
+docker run --rm -v $(pwd):/code ghcr.io/lgtm-hq/py-lintro:latest check --output-format grid
+```
+
+## 📚 Documentation
+
+| Guide                                            | Description                             |
+| ------------------------------------------------ | --------------------------------------- |
+| [Getting Started](docs/getting-started.md)       | Installation, first steps, requirements |
+| [Configuration](docs/configuration.md)           | Tool configuration, options, presets    |
+| [Docker Usage](docs/docker.md)                   | Containerized development               |
+| [GitHub Integration](docs/github-integration.md) | CI/CD setup, workflows                  |
+| [Contributing](docs/contributing.md)             | Development guide, adding tools         |
+| [Troubleshooting](docs/troubleshooting.md)       | Common issues and solutions             |
+
+**Advanced:** [Tool Analysis](docs/tool-analysis/) | [Architecture](docs/architecture/)
+| [Security](docs/security/)
+
+## 🔨 Development
+
+```bash
+# Clone and install
+git clone https://github.com/lgtm-hq/py-lintro.git
+cd py-lintro
+uv sync --dev
+
+# Run tests
+./scripts/local/run-tests.sh
+
+# Run lintro on itself
+./scripts/local/local-lintro.sh check --output-format grid
+```
+
+## 🤝 Community
+
+- 🐛
+  [Bug Reports](https://github.com/lgtm-hq/py-lintro/issues/new?template=bug_report.md)
+- 💡
+  [Feature Requests](https://github.com/lgtm-hq/py-lintro/issues/new?template=feature_request.md)
+- ❓ [Questions](https://github.com/lgtm-hq/py-lintro/issues/new?template=question.md)
+- 📖 [Contributing Guide](docs/contributing.md)
+
+## 📄 License
+
+MIT License - see [LICENSE](LICENSE) for details.

lintro-0.42.5/README.md

@@ -0,0 +1,226 @@
+# Lintro
+
+<!-- markdownlint-disable MD033 MD013 -->
+<img src="https://raw.githubusercontent.com/lgtm-hq/py-lintro/main/assets/images/lintro.png" alt="Lintro Logo" style="width:100%;max-width:800px;height:auto;display:block;margin:0 auto 24px auto;">
+<!-- markdownlint-enable MD033 MD013 -->
+
+A comprehensive CLI tool that unifies various code formatting, linting, and quality
+assurance tools under a single command-line interface.
+
+<!-- Badges: Build & Quality -->
+
+[![Tests](https://img.shields.io/github/actions/workflow/status/lgtm-hq/py-lintro/test-and-coverage.yml?label=tests&branch=main&logo=githubactions&logoColor=white)](https://github.com/lgtm-hq/py-lintro/actions/workflows/test-and-coverage.yml?query=branch%3Amain)
+[![CI](https://img.shields.io/github/actions/workflow/status/lgtm-hq/py-lintro/ci-lintro-analysis.yml?label=ci&branch=main&logo=githubactions&logoColor=white)](https://github.com/lgtm-hq/py-lintro/actions/workflows/ci-lintro-analysis.yml?query=branch%3Amain)
+[![Docker](https://img.shields.io/github/actions/workflow/status/lgtm-hq/py-lintro/docker-build-publish.yml?label=docker&logo=docker&branch=main)](https://github.com/lgtm-hq/py-lintro/actions/workflows/docker-build-publish.yml?query=branch%3Amain)
+[![Coverage](https://codecov.io/gh/lgtm-hq/py-lintro/branch/main/graph/badge.svg)](https://codecov.io/gh/lgtm-hq/py-lintro)
+
+<!-- Badges: Releases -->
+
+[![Release](https://img.shields.io/github/v/release/lgtm-hq/py-lintro?label=release)](https://github.com/lgtm-hq/py-lintro/releases/latest)
+[![PyPI](https://img.shields.io/pypi/v/lintro?label=pypi)](https://pypi.org/project/lintro/)
+[![Python](https://img.shields.io/badge/python-3.11+-blue)](https://www.python.org/downloads/)
+[![License](https://img.shields.io/badge/license-MIT-green)](LICENSE)
+
+<!-- Badges: Security & Supply Chain -->
+
+[![CodeQL](https://github.com/lgtm-hq/py-lintro/actions/workflows/codeql.yml/badge.svg?branch=main)](https://github.com/lgtm-hq/py-lintro/actions/workflows/codeql.yml?query=branch%3Amain)
+[![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/lgtm-hq/py-lintro/badge)](https://scorecard.dev/viewer/?uri=github.com/lgtm-hq/py-lintro)
+[![OpenSSF Best Practices](https://www.bestpractices.dev/projects/11142/badge)](https://www.bestpractices.dev/projects/11142)
+[![SBOM](https://img.shields.io/badge/SBOM-CycloneDX-brightgreen)](docs/security/assurance.md)
+[![SBOM Status](https://img.shields.io/github/actions/workflow/status/lgtm-hq/py-lintro/sbom-on-main.yml?label=sbom&branch=main)](https://github.com/lgtm-hq/py-lintro/actions/workflows/sbom-on-main.yml?query=branch%3Amain)
+
+## 🚀 Quick Start
+
+```bash
+pip install lintro          # Install
+lintro check .              # Find issues
+lintro format .             # Fix issues
+lintro check --output-format grid   # Beautiful output
+```
+
+<!-- TODO: Add screenshot of grid output -->
+
+## ✨ Why Lintro?
+
+- **🎯 Unified Interface** - One command for all your linting and formatting tools
+- **📊 Consistent Output** - Beautiful, standardized output formats across all tools
+- **🔧 Auto-fixing** - Automatically fix issues where possible
+- **🐳 Docker Ready** - Run in isolated containers for consistent environments
+- **📈 Rich Reporting** - Multiple formats: grid, JSON, HTML, CSV, Markdown
+- **⚡ Fast** - Optimized parallel execution
+
+## 🔌 Works With Your Existing Configs
+
+Lintro respects your native tool configurations. If you have a `.prettierrc`,
+`pyproject.toml [tool.ruff]`, or `.yamllint`, Lintro uses them automatically - no
+migration required.
+
+- **Native configs are detected** - Your existing `.prettierrc`, `.eslintrc`, etc. work
+  as-is
+- **Enforce settings override consistently** - Set `line_length: 88` once, applied
+  everywhere
+- **Fallback defaults when needed** - Tools without native configs use sensible defaults
+
+See the [Configuration Guide](docs/configuration.md) for details on the 4-tier config
+system.
+
+## 🛠️ Supported Tools
+
+<!-- markdownlint-disable MD013 MD060 -->
+
+| Tool                                                                                                                                                          | Language            | Auto-fix |
+| ------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------- | -------- |
+| [![Actionlint](https://img.shields.io/badge/Actionlint-lint-24292e?logo=github&logoColor=white)](https://github.com/rhysd/actionlint)                         | ⚙️ GitHub Actions   | -        |
+| [![Bandit](https://img.shields.io/badge/Bandit-security-yellow?logo=python&logoColor=white)](https://github.com/PyCQA/bandit)                                 | 🐍 Python           | -        |
+| [![Black](https://img.shields.io/badge/Black-format-000000?logo=python&logoColor=white)](https://github.com/psf/black)                                        | 🐍 Python           | ✅       |
+| [![Clippy](https://img.shields.io/badge/Clippy-lint-000000?logo=rust&logoColor=white)](https://github.com/rust-lang/rust-clippy)                              | 🦀 Rust             | ✅       |
+| [![Gitleaks](https://img.shields.io/badge/Gitleaks-secrets-dc2626?logo=git&logoColor=white)](https://gitleaks.io/)                                            | 🔐 Secret Detection | -        |
+| [![Hadolint](https://img.shields.io/badge/Hadolint-lint-2496ED?logo=docker&logoColor=white)](https://github.com/hadolint/hadolint)                            | 🐳 Dockerfile       | -        |
+| [![Markdownlint](https://img.shields.io/badge/Markdownlint--cli2-lint-000000?logo=markdown&logoColor=white)](https://github.com/DavidAnson/markdownlint-cli2) | 📝 Markdown         | -        |
+| [![Mypy](https://img.shields.io/badge/Mypy-type%20checking-2d50a5?logo=python&logoColor=white)](https://mypy-lang.org/)                                       | 🐍 Python           | -        |
+| [![Oxfmt](https://img.shields.io/badge/Oxfmt-format-e05d44?logo=javascript&logoColor=white)](https://oxc.rs/)                                                 | 🟨 JS/TS            | ✅       |
+| [![Oxlint](https://img.shields.io/badge/Oxlint-lint-e05d44?logo=javascript&logoColor=white)](https://oxc.rs/)                                                 | 🟨 JS/TS            | ✅       |
+| [![Prettier](https://img.shields.io/badge/Prettier-format-1a2b34?logo=prettier&logoColor=white)](https://prettier.io/)                                        | 🟨 JS/TS · 🧾 JSON  | ✅       |
+| [![pydoclint](https://img.shields.io/badge/pydoclint-docstrings-3776AB?logo=python&logoColor=white)](https://github.com/jsh9/pydoclint)                       | 🐍 Python           | -        |
+| [![Ruff](https://img.shields.io/badge/Ruff-lint%2Bformat-000?logo=ruff&logoColor=white)](https://github.com/astral-sh/ruff)                                   | 🐍 Python           | ✅       |
+| [![Semgrep](https://img.shields.io/badge/Semgrep-security-5b21b6?logo=semgrep&logoColor=white)](https://semgrep.dev/)                                         | 🔒 Multi-language   | -        |
+| [![ShellCheck](https://img.shields.io/badge/ShellCheck-lint-4EAA25?logo=gnubash&logoColor=white)](https://www.shellcheck.net/)                                | 🐚 Shell Scripts    | -        |
+| [![shfmt](https://img.shields.io/badge/shfmt-format-4EAA25?logo=gnubash&logoColor=white)](https://github.com/mvdan/sh)                                        | 🐚 Shell Scripts    | ✅       |
+| [![SQLFluff](https://img.shields.io/badge/SQLFluff-lint%2Bformat-4b5563?logo=database&logoColor=white)](https://sqlfluff.com/)                                | 🗃️ SQL              | ✅       |
+| [![Taplo](https://img.shields.io/badge/Taplo-lint%2Bformat-9b4dca?logo=toml&logoColor=white)](https://taplo.tamasfe.dev/)                                     | 🧾 TOML             | ✅       |
+| [![TypeScript](https://img.shields.io/badge/TypeScript-type%20check-3178c6?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)                 | 🟨 JS/TS            | -        |
+| [![Yamllint](https://img.shields.io/badge/Yamllint-lint-cb171e?logo=yaml&logoColor=white)](https://github.com/adrienverge/yamllint)                           | 🧾 YAML             | -        |
+
+<!-- markdownlint-enable MD013 MD060 -->
+
+## 📋 Requirements
+
+### Python Version
+
+**Python 3.11+** is required. Lintro uses modern Python features not available in older
+versions.
+
+### Bundled Tools
+
+These Python tools are automatically installed with Lintro:
+
+- **Ruff** - Fast Python linter and formatter
+- **Black** - Python code formatter
+- **Bandit** - Python security linter
+- **Mypy** - Python static type checker
+- **Yamllint** - YAML linter
+- **pydoclint** - Python docstring linter
+
+### Optional External Tools
+
+For full functionality, install these additional tools:
+
+- **Prettier** - `npm install -g prettier`
+- **Markdownlint-cli2** - `npm install -g markdownlint-cli2`
+- **Oxlint** - `bun add -g oxlint` or `npm install -g oxlint`
+- **Oxfmt** - `bun add -g oxfmt` or `npm install -g oxfmt`
+- **Hadolint** - [GitHub Releases](https://github.com/hadolint/hadolint/releases)
+- **Actionlint** - [GitHub Releases](https://github.com/rhysd/actionlint/releases)
+- **Semgrep** - `pipx install semgrep`, `pip install semgrep`, or `brew install semgrep`
+- **Gitleaks** - `brew install gitleaks` or
+  [GitHub Releases](https://github.com/gitleaks/gitleaks/releases)
+- **ShellCheck** - `brew install shellcheck` or
+  [GitHub Releases](https://github.com/koalaman/shellcheck/releases)
+- **shfmt** - `brew install shfmt` or
+  [GitHub Releases](https://github.com/mvdan/sh/releases)
+- **SQLFluff** - `pip install sqlfluff`
+- **Taplo** - `brew install taplo` or
+  [GitHub Releases](https://github.com/tamasfe/taplo/releases)
+- **TypeScript** - `brew install typescript`, `bun add -g typescript`, or
+  `npm install -g typescript`
+
+Check all tool versions with: `lintro list-tools`
+
+## 📦 Installation
+
+```bash
+# PyPI (recommended)
+pip install lintro
+
+# Homebrew (macOS binary)
+brew tap lgtm-hq/tap && brew install lintro-bin
+
+# Docker (includes all tools)
+docker run --rm -v $(pwd):/code ghcr.io/lgtm-hq/py-lintro:latest check
+```
+
+See [Getting Started](docs/getting-started.md) for detailed installation options.
+
+## 💻 Usage
+
+```bash
+# Check all files
+lintro check .
+
+# Auto-fix issues
+lintro format .
+
+# Grid output with grouping
+lintro check --output-format grid --group-by file
+
+# Run specific tools
+lintro check --tools ruff,prettier,mypy
+
+# Exclude directories
+lintro check --exclude "node_modules,dist,venv"
+
+# List available tools
+lintro list-tools
+```
+
+### 🐳 Docker
+
+```bash
+# Run from GHCR
+docker run --rm -v $(pwd):/code ghcr.io/lgtm-hq/py-lintro:latest check
+
+# With formatting
+docker run --rm -v $(pwd):/code ghcr.io/lgtm-hq/py-lintro:latest check --output-format grid
+```
+
+## 📚 Documentation
+
+| Guide                                            | Description                             |
+| ------------------------------------------------ | --------------------------------------- |
+| [Getting Started](docs/getting-started.md)       | Installation, first steps, requirements |
+| [Configuration](docs/configuration.md)           | Tool configuration, options, presets    |
+| [Docker Usage](docs/docker.md)                   | Containerized development               |
+| [GitHub Integration](docs/github-integration.md) | CI/CD setup, workflows                  |
+| [Contributing](docs/contributing.md)             | Development guide, adding tools         |
+| [Troubleshooting](docs/troubleshooting.md)       | Common issues and solutions             |
+
+**Advanced:** [Tool Analysis](docs/tool-analysis/) | [Architecture](docs/architecture/)
+| [Security](docs/security/)
+
+## 🔨 Development
+
+```bash
+# Clone and install
+git clone https://github.com/lgtm-hq/py-lintro.git
+cd py-lintro
+uv sync --dev
+
+# Run tests
+./scripts/local/run-tests.sh
+
+# Run lintro on itself
+./scripts/local/local-lintro.sh check --output-format grid
+```
+
+## 🤝 Community
+
+- 🐛
+  [Bug Reports](https://github.com/lgtm-hq/py-lintro/issues/new?template=bug_report.md)
+- 💡
+  [Feature Requests](https://github.com/lgtm-hq/py-lintro/issues/new?template=feature_request.md)
+- ❓ [Questions](https://github.com/lgtm-hq/py-lintro/issues/new?template=question.md)
+- 📖 [Contributing Guide](docs/contributing.md)
+
+## 📄 License
+
+MIT License - see [LICENSE](LICENSE) for details.

lintro-0.42.5/assets/images/coverage-badge.svg

@@ -0,0 +1,21 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" width="99" height="20">
+    <linearGradient id="b" x2="0" y2="100%">
+        <stop offset="0" stop-color="#bbb" stop-opacity=".1"/>
+        <stop offset="1" stop-opacity=".1"/>
+    </linearGradient>
+    <clipPath id="a">
+        <rect width="99" height="20" rx="3" fill="#fff"/>
+    </clipPath>
+    <g clip-path="url(#a)">
+        <path fill="#555" d="M0 0h63v20H0z"/>
+        <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">86.7%</text>
+        <text x="800" y="140" transform="scale(.1)" textLength="260">86.7%</text>
+    </g>
+</svg>