How ansible/ansible-lint works
ansible-lint is a command-line quality checker for Ansible content. The principal workflow is: a developer invokes the CLI, the application configures a lint run, the runner discovers and loads files, rule checks produce violations, and formatters report results. Separate branches cover syntax checking, schema validation, skip handling, and automatic fixes. The map uses the supplied excerpts and SOURCE INDEX references; some internal calls and the implementations of several documented rule families were not sampled, so their links are omitted where evidence is insufficient.
Main entry points: app.py Lint application · runner.py Lint runner · __init__.py Rule collection · output.py Result output
Components 20
Invocation and configuration
- Command interface
src/ansiblelint/cli.py - Lint application
src/ansiblelint/app.py - Lint options
src/ansiblelint/config.py
Lint analysis
- File discovery
src/ansiblelint/file_utils.py - YAML handling
src/ansiblelint/yaml_utils.py - Lint runner
src/ansiblelint/runner.py - Rule collection
src/ansiblelint/rules/__init__.py - Rule engine
src/ansiblelint/_internal/rules.py - Rule checks
src/ansiblelint/rules
Results and fixes
- Autofix transformer
src/ansiblelint/transformer.py - Violation records
src/ansiblelint/errors.py - Result output
src/ansiblelint/output.py - Output formatters
src/ansiblelint/formatters/__init__.py - Run summary
src/ansiblelint/stats.py
Validation support
- Syntax check
src/ansiblelint/rules/syntax_check.py - Skip handling
src/ansiblelint/skip_utils.py - Schema validation
src/ansiblelint/schemas/main.py
Other components
- Developer
- Ansible runtime
- yamllint library
Connections 19
- Developer → Command interface: invokes
README.md - Command interface → Lint application: starts
src/ansiblelint/__main__.py - Lint application → Lint options: configures
src/ansiblelint/app.py - Lint application → Lint runner: runs
src/ansiblelint/app.py - Lint runner → File discovery: expands files
src/ansiblelint/runner.py - Lint runner → Rule collection: runs rules
src/ansiblelint/runner.py - Rule collection → Rule engine: uses base rules
src/ansiblelint/rules/__init__.py - Rule collection → Rule checks: loads checks
src/ansiblelint/rules/no_handler.py - Lint runner → Syntax check: checks syntax
src/ansiblelint/runner.py - Lint application → YAML handling: uses YAML helpers
src/ansiblelint/app.py - Lint application → Skip handling: uses skip handling
src/ansiblelint/app.py - Lint application → Schema validation: dispatches validation
- Lint runner → Violation records: collects violations
src/ansiblelint/runner.py - Lint application → Autofix transformer: applies fixes
src/ansiblelint/__main__.py - Lint application → Result output: emits results
src/ansiblelint/app.py - Result output → Output formatters: formats results
src/ansiblelint/app.py - Result output → Run summary: summarizes run
src/ansiblelint/app.py - Rule checks → Ansible runtime: checks content
README.md - YAML handling → yamllint library: uses parsing support
README.md