lintro 0.43.1

A unified CLI tool for code formatting, linting, and quality assurance

Lintro

A comprehensive CLI tool that unifies various code formatting, linting, and quality assurance tools under a single command-line interface.

🚀 Quick Start

pip install lintro          # Install
lintro check .              # Find issues
lintro format .             # Fix issues
lintro check --output-format grid   # Beautiful 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 for details on the 4-tier config system.

🛠️ Supported Tools

Tool	Language	Auto-fix
	⚙️ GitHub Actions	-
	🐍 Python	-
	🐍 Python	✅
	🦀 Rust	✅
	🔐 Secret Detection	-
	🐳 Dockerfile	-
	📝 Markdown	-
	🐍 Python	-
	🟨 JS/TS	✅
	🟨 JS/TS	✅
	🟨 JS/TS · 🧾 JSON	✅
	🐍 Python	-
	🐍 Python	✅
	🔒 Multi-language	-
	🐚 Shell Scripts	-
	🐚 Shell Scripts	✅
	🗃️ SQL	✅
	🧾 TOML	✅
	🟨 JS/TS	-
	🧾 YAML	-

📋 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
• Actionlint - GitHub Releases
• Semgrep - pipx install semgrep, pip install semgrep, or brew install semgrep
• Gitleaks - brew install gitleaks or GitHub Releases
• ShellCheck - brew install shellcheck or GitHub Releases
• shfmt - brew install shfmt or GitHub Releases
• SQLFluff - pip install sqlfluff
• Taplo - brew install taplo or GitHub Releases
• TypeScript - brew install typescript, bun add -g typescript, or npm install -g typescript

Check all tool versions with: lintro list-tools

📦 Installation

# PyPI (recommended)
pip install lintro

# Homebrew (macOS binary)
brew tap lgtm-hq/tap && brew install lintro-bin

# Docker (tools image - includes all external tools)
docker run --rm -v $(pwd):/code ghcr.io/lgtm-hq/py-lintro:latest check

# Docker (base image - minimal, no external tools)
docker run --rm -v $(pwd):/code ghcr.io/lgtm-hq/py-lintro:base check

See Getting Started for detailed installation options.

💻 Usage

# 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

# Auto-install Node.js dependencies (useful for TypeScript projects)
lintro check --tools tsc --auto-install

# Exclude directories
lintro check --exclude "node_modules,dist,venv"

# List available tools
lintro list-tools

🐳 Docker

# Run from GHCR (tools image - recommended)
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

# Base image (minimal, no external tools)
docker run --rm -v $(pwd):/code ghcr.io/lgtm-hq/py-lintro:base check

📚 Documentation

Guide	Description
Getting Started	Installation, first steps, requirements
Configuration	Tool configuration, options, presets
Docker Usage	Containerized development
GitHub Integration	CI/CD setup, workflows
Contributing	Development guide, adding tools
Troubleshooting	Common issues and solutions

Advanced: Tool Analysis | Architecture | Security

🔨 Development

# 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
• 💡 Feature Requests
• ❓ Questions
• 📖 Contributing Guide

📄 License

MIT License - see LICENSE for details.