lintro 0.13.0__tar.gz → 0.24.3__tar.gz

lintro-0.24.3/PKG-INFO

@@ -0,0 +1,289 @@
+Metadata-Version: 2.4
+Name: lintro
+Version: 0.24.3
+Summary: A unified CLI tool for code formatting, linting, and quality assurance
+Author-email: TurboCoder13 <turbocoder13@gmail.com>
+License: MIT License
+        
+        Copyright (c) 2024 TurboCoder13
+        
+        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/TurboCoder13/py-lintro
+Project-URL: Documentation, https://github.com/TurboCoder13/py-lintro/docs
+Project-URL: Source, https://github.com/TurboCoder13/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: darglint==1.8.1
+Requires-Dist: loguru==0.7.3
+Requires-Dist: packaging>=24.0
+Requires-Dist: pathspec>=0.12.0
+Requires-Dist: pydantic>=2.10.0
+Requires-Dist: rich>=14.0.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.0
+Requires-Dist: black>=25.0.0
+Requires-Dist: bandit>=1.8.0
+Requires-Dist: mypy>=1.14.1
+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.32.0; 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"
+Dynamic: license-file
+
+# Lintro
+
+<!-- markdownlint-disable MD033 MD013 -->
+<img src="https://raw.githubusercontent.com/TurboCoder13/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/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)
+[![Coverage](https://codecov.io/gh/TurboCoder13/py-lintro/branch/main/graph/badge.svg)](https://codecov.io/gh/TurboCoder13/py-lintro)
+
+<!-- Badges: Releases -->
+
+[![Release](https://img.shields.io/github/v/release/TurboCoder13/py-lintro?label=release)](https://github.com/TurboCoder13/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/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)
+[![SBOM](https://img.shields.io/badge/SBOM-CycloneDX-brightgreen)](docs/security/assurance.md)
+[![SBOM Status](https://img.shields.io/github/actions/workflow/status/TurboCoder13/py-lintro/sbom-on-main.yml?label=sbom&branch=main)](https://github.com/TurboCoder13/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 |
+| ------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------- | -------- |
+| [![Ruff](https://img.shields.io/badge/Ruff-lint%2Bformat-000?logo=ruff&logoColor=white)](https://github.com/astral-sh/ruff)                                   | 🐍 Python              | ✅       |
+| [![Black](https://img.shields.io/badge/Black-format-000000?logo=python&logoColor=white)](https://github.com/psf/black)                                        | 🐍 Python              | ✅       |
+| [![Mypy](https://img.shields.io/badge/Mypy-type%20checking-2d50a5?logo=python&logoColor=white)](https://mypy-lang.org/)                                       | 🐍 Python              | -        |
+| [![Bandit](https://img.shields.io/badge/Bandit-security-yellow?logo=python&logoColor=white)](https://github.com/PyCQA/bandit)                                 | 🐍 Python              | -        |
+| [![Prettier](https://img.shields.io/badge/Prettier-format-1a2b34?logo=prettier&logoColor=white)](https://prettier.io/)                                        | 🟨 JS/TS · 🧾 JSON     | ✅       |
+| [![Biome](https://img.shields.io/badge/Biome-lint-60A5FA?logo=biome&logoColor=white)](https://biomejs.dev/)                                                   | 🟨 JS/TS · 🧾 JSON/CSS | ✅       |
+| [![Yamllint](https://img.shields.io/badge/Yamllint-lint-cb171e?logo=yaml&logoColor=white)](https://github.com/adrienverge/yamllint)                           | 🧾 YAML                | -        |
+| [![Hadolint](https://img.shields.io/badge/Hadolint-lint-2496ED?logo=docker&logoColor=white)](https://github.com/hadolint/hadolint)                            | 🐳 Dockerfile          | -        |
+| [![Actionlint](https://img.shields.io/badge/Actionlint-lint-24292e?logo=github&logoColor=white)](https://github.com/rhysd/actionlint)                         | ⚙️ GitHub Actions      | -        |
+| [![Markdownlint](https://img.shields.io/badge/Markdownlint--cli2-lint-000000?logo=markdown&logoColor=white)](https://github.com/DavidAnson/markdownlint-cli2) | 📝 Markdown            | -        |
+| [![Clippy](https://img.shields.io/badge/Clippy-lint-000000?logo=rust&logoColor=white)](https://github.com/rust-lang/rust-clippy)                              | 🦀 Rust                | ✅       |
+| [![Darglint](https://img.shields.io/badge/Darglint-docstrings-3776AB?logo=python&logoColor=white)](https://github.com/terrencepreilly/darglint)               | 🐍 Python              | -        |
+
+<!-- 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
+- **Darglint** - 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`
+- **Hadolint** - [GitHub Releases](https://github.com/hadolint/hadolint/releases)
+- **Actionlint** - [GitHub Releases](https://github.com/rhysd/actionlint/releases)
+
+Check all tool versions with: `lintro list-tools`
+
+## 📦 Installation
+
+```bash
+# PyPI (recommended)
+pip install lintro
+
+# Homebrew (macOS binary)
+brew tap TurboCoder13/tap && brew install lintro-bin
+
+# Docker (includes all tools)
+docker run --rm -v $(pwd):/code ghcr.io/turbocoder13/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/turbocoder13/py-lintro:latest check
+
+# With formatting
+docker run --rm -v $(pwd):/code ghcr.io/turbocoder13/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/TurboCoder13/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/TurboCoder13/py-lintro/issues/new?template=bug_report.md)
+- 💡
+  [Feature Requests](https://github.com/TurboCoder13/py-lintro/issues/new?template=feature_request.md)
+- ❓
+  [Questions](https://github.com/TurboCoder13/py-lintro/issues/new?template=question.md)
+- 📖 [Contributing Guide](docs/contributing.md)
+
+## 📄 License
+
+MIT License - see [LICENSE](LICENSE) for details.

lintro-0.24.3/README.md

@@ -0,0 +1,205 @@
+# Lintro
+
+<!-- markdownlint-disable MD033 MD013 -->
+<img src="https://raw.githubusercontent.com/TurboCoder13/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/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)
+[![Coverage](https://codecov.io/gh/TurboCoder13/py-lintro/branch/main/graph/badge.svg)](https://codecov.io/gh/TurboCoder13/py-lintro)
+
+<!-- Badges: Releases -->
+
+[![Release](https://img.shields.io/github/v/release/TurboCoder13/py-lintro?label=release)](https://github.com/TurboCoder13/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/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)
+[![SBOM](https://img.shields.io/badge/SBOM-CycloneDX-brightgreen)](docs/security/assurance.md)
+[![SBOM Status](https://img.shields.io/github/actions/workflow/status/TurboCoder13/py-lintro/sbom-on-main.yml?label=sbom&branch=main)](https://github.com/TurboCoder13/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 |
+| ------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------- | -------- |
+| [![Ruff](https://img.shields.io/badge/Ruff-lint%2Bformat-000?logo=ruff&logoColor=white)](https://github.com/astral-sh/ruff)                                   | 🐍 Python              | ✅       |
+| [![Black](https://img.shields.io/badge/Black-format-000000?logo=python&logoColor=white)](https://github.com/psf/black)                                        | 🐍 Python              | ✅       |
+| [![Mypy](https://img.shields.io/badge/Mypy-type%20checking-2d50a5?logo=python&logoColor=white)](https://mypy-lang.org/)                                       | 🐍 Python              | -        |
+| [![Bandit](https://img.shields.io/badge/Bandit-security-yellow?logo=python&logoColor=white)](https://github.com/PyCQA/bandit)                                 | 🐍 Python              | -        |
+| [![Prettier](https://img.shields.io/badge/Prettier-format-1a2b34?logo=prettier&logoColor=white)](https://prettier.io/)                                        | 🟨 JS/TS · 🧾 JSON     | ✅       |
+| [![Biome](https://img.shields.io/badge/Biome-lint-60A5FA?logo=biome&logoColor=white)](https://biomejs.dev/)                                                   | 🟨 JS/TS · 🧾 JSON/CSS | ✅       |
+| [![Yamllint](https://img.shields.io/badge/Yamllint-lint-cb171e?logo=yaml&logoColor=white)](https://github.com/adrienverge/yamllint)                           | 🧾 YAML                | -        |
+| [![Hadolint](https://img.shields.io/badge/Hadolint-lint-2496ED?logo=docker&logoColor=white)](https://github.com/hadolint/hadolint)                            | 🐳 Dockerfile          | -        |
+| [![Actionlint](https://img.shields.io/badge/Actionlint-lint-24292e?logo=github&logoColor=white)](https://github.com/rhysd/actionlint)                         | ⚙️ GitHub Actions      | -        |
+| [![Markdownlint](https://img.shields.io/badge/Markdownlint--cli2-lint-000000?logo=markdown&logoColor=white)](https://github.com/DavidAnson/markdownlint-cli2) | 📝 Markdown            | -        |
+| [![Clippy](https://img.shields.io/badge/Clippy-lint-000000?logo=rust&logoColor=white)](https://github.com/rust-lang/rust-clippy)                              | 🦀 Rust                | ✅       |
+| [![Darglint](https://img.shields.io/badge/Darglint-docstrings-3776AB?logo=python&logoColor=white)](https://github.com/terrencepreilly/darglint)               | 🐍 Python              | -        |
+
+<!-- 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
+- **Darglint** - 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`
+- **Hadolint** - [GitHub Releases](https://github.com/hadolint/hadolint/releases)
+- **Actionlint** - [GitHub Releases](https://github.com/rhysd/actionlint/releases)
+
+Check all tool versions with: `lintro list-tools`
+
+## 📦 Installation
+
+```bash
+# PyPI (recommended)
+pip install lintro
+
+# Homebrew (macOS binary)
+brew tap TurboCoder13/tap && brew install lintro-bin
+
+# Docker (includes all tools)
+docker run --rm -v $(pwd):/code ghcr.io/turbocoder13/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/turbocoder13/py-lintro:latest check
+
+# With formatting
+docker run --rm -v $(pwd):/code ghcr.io/turbocoder13/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/TurboCoder13/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/TurboCoder13/py-lintro/issues/new?template=bug_report.md)
+- 💡
+  [Feature Requests](https://github.com/TurboCoder13/py-lintro/issues/new?template=feature_request.md)
+- ❓
+  [Questions](https://github.com/TurboCoder13/py-lintro/issues/new?template=question.md)
+- 📖 [Contributing Guide](docs/contributing.md)
+
+## 📄 License
+
+MIT License - see [LICENSE](LICENSE) for details.

{lintro-0.13.0 → lintro-0.24.3}/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">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">86.7%</text>
+        <text x="800" y="140" transform="scale(.1)" textLength="260">86.7%</text>
     </g>
 </svg>