salt-lint
A command-line utility that checks for best practices in SaltStack.
Decision gist · record as of 2026-08-14
Yes. salt-lint is a stable, actively maintained tool with low install friction, no known vulnerabilities, and a permissive MIT license. It fills a clear need for SaltStack users who want automated quality checks on state files. Install it if you manage Salt configurations and want to catch style and logic issues before they reach production.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.6 or later; pyyaml and pathspec must be installed (handled automatically by pip).
- Low install friction with only two runtime dependencies (pyyaml, pathspec).
- Actively maintained as of 2026-05-06 with stable production status.
License · maintenance · safety
MIT (permissive) — MIT license permits free use, modification, and distribution with minimal restrictions—suitable for both open-source and commercial projects.
last release 2023-02-09 (1282 days) · last repo commit 2026-05-06 · 160 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 504,744 downloads/mo, #6,295 on PyPI
Alternatives
Verify before relying
pip install salt-lint
salt-lint /path/to/sls/files/
# Or check a single file:
salt-lint mystate.sls- Whether the rule set (e.g., rules 901–915 for deprecated states) remains current with recent Salt versions.
- Performance characteristics when linting large SLS file collections or deeply nested state definitions.
What it is and what it does
salt-lint is a command-line linter for SaltStack state files (SLS format), designed to catch style violations, structural issues, and anti-patterns that could lead to runtime problems or maintenance headaches. It runs a set of numbered rules—covering indentation, quoting, Jinja templating, deprecated state options, and naming conventions—and reports violations with file location and severity. The tool depends on pyyaml for parsing YAML and pathspec for file filtering, making it a lightweight addition to a Salt development workflow.
You run it as a CLI tool against a directory or individual SLS files, and it outputs violations in a format suitable for CI/CD pipelines or editor integration. The project is modeled on ansible-lint and has been actively maintained since 2019, with support for modern Python versions (3.6–3.11) and regular rule additions to catch new categories of mistakes.
Use it for
- Enforce consistent formatting and style across a team's SaltStack state files before deployment.
- Catch deprecated Salt state options and syntax errors early in development or CI/CD pipelines.
- Validate SLS file naming and structure to prevent runtime reference failures in Salt.
- Integrate into pre-commit hooks or CI workflows to block commits with linting violations.
- Identify common Jinja templating mistakes and missing spaces in variable interpolation.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes.
salt-lint is a stable, actively maintained tool with low install friction, no known vulnerabilities, and a permissive MIT license. It fills a clear need for SaltStack users who want automated quality checks on state files. Install it if you manage Salt configurations and want to catch style and logic issues before they reach production.
Install
salt-lint on PyPI
Before you install
Low install friction with only two runtime dependencies (pyyaml, pathspec). Actively maintained as of 2026-05-06 with stable production status.
Requires Python 3.6 or later; pyyaml and pathspec must be installed (handled automatically by pip).
License in practice
MIT license permits free use, modification, and distribution with minimal restrictions—suitable for both open-source and commercial projects.
Quickstart
pip install salt-lint
salt-lint /path/to/sls/files/
# Or check a single file:
salt-lint mystate.slsVerify before relying
- Whether the rule set (e.g., rules 901–915 for deprecated states) remains current with recent Salt versions.
- Performance characteristics when linting large SLS file collections or deeply nested state definitions.
Package facts
| License | MIT permissive |
| Python support | Supports the current Python release >=3.6 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 2 packagespyyamlpathspec |
| Maintenance | Actively maintained 1,282 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 504,744 / month, #6,295 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableEnvironment :: ConsoleIntended Audience :: DevelopersIntended Audience :: Information TechnologyIntended Audience :: System AdministratorsLicense :: OSI Approved :: MIT LicenseOperating System :: OS IndependentProgramming Language :: PythonProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.6Programming Language :: Python :: 3.7Programming Language :: Python :: 3.8Programming Language :: Python :: 3.9Topic :: Software Development :: Bug TrackingTopic :: Software Development :: Quality AssuranceTopic :: Software Development :: TestingTopic :: Utilities |
Evidence: salt_lint-0.9.2-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “salt state file linter”
- salt-lintsalt-lint checks Salt State files (SLS) for best practices and…
- saltext.vaultA Salt extension that integrates HashiCorp Vault (or OpenBao) with…
- saltSalt is an event-driven automation engine for deploying, configuring,…
Give your agent the search over MCP, or paste the wish link into any chat.
More Software Development packages
Provides backported and experimental type hints for Python 3.9+, allowing use of newer typing features on older Python versions and enabling early experimentation with type system PEPs before they enter the standard library.
NumPy provides an N-dimensional array object and a comprehensive suite of mathematical, linear algebra, Fourier transform, and random number functions for scientific computing in Python.
FastAPI is a Python web framework for building REST APIs using type hints, with automatic request validation, serialization, and interactive API documentation.
Provides a way to document function parameters, class attributes, return types, and variables inline using Python's `Annotated` type hint syntax instead of traditional docstrings.
Typer builds command-line applications from Python functions using type hints, automatically generating help text, argument parsing, and shell completion.
Install it if you are building CLIs in Python.
Distlib provides low-level packaging utilities for building, distributing, and managing Python software—including metadata handling, version specifiers, wheel support, script installation, and dependency resolution.
See also ansible-lint · salt · gitlint-core · taplo · ick · yamllint · gitlint · rstcheck · j2lint · dotenv-linter