Shellcheck

This project is a static analysis tool and linter designed to improve the quality, reliability, and portability of shell scripts. By performing deep structural analysis, it identifies common programming pitfalls, syntax errors, and security vulnerabilities before scripts are executed. It functions as an automated code reviewer that enforces best practices and helps developers maintain consistent, robust code across different operating environments.

The tool distinguishes itself through its dialect-aware grammar resolution, which adapts its parsing logic based on the specific shell interpreter detected. It utilizes a sophisticated engine that constructs an abstract syntax tree to evaluate logic, quoting, and portability concerns. Developers can exert granular control over the analysis process by using inline directives to suppress specific warnings or configure how the tool resolves external source files.

The project covers a comprehensive surface of diagnostic capabilities, ranging from fundamental syntax validation to complex logic checks. It provides guidance on idiomatic script construction, including safe file handling, efficient arithmetic operations, and proper command substitution. These features collectively ensure that scripts adhere to POSIX standards and remain compatible across various shell implementations.

The tool is distributed as a command-line utility, allowing for integration into development workflows to provide immediate feedback on script integrity.

Features

Static Analysis Tools - Provides automated feedback to improve code reliability and maintainability.

Linters & Formatters - Enforces POSIX compliance and identifies common syntax errors or logic flaws within shell script files.

Portability Checkers - Ensures shell scripts remain compatible across different operating systems and shell interpreters by detecting non-standard or dialect-specific syntax.

Shell Scripting Best Practices - Process files using shell globbing patterns instead of command substitution to safely handle filenames containing spaces, wildcards, or special characters.

Shell Scripting Linters - Identifies inefficient pipe usage in shell scripts to optimize command execution and prevent redundant data processing.

Static Analysis Tools - Traverses the parsed tree structure to identify patterns, logic errors, and non-portable syntax constructs.

Compatibility Testers - Identify non-portable script features that conflict with the specified shebang to ensure scripts remain compatible with the intended interpreter.

Automation and Linting Tools - Static analysis tool for shell scripts.

Console Applications - Static analysis tool for identifying issues in shell scripts.

Linting And Formatting - Static analysis tool for shell scripts.

Shell Environment - Static analysis tool for shell scripts.

Shell Script Development - Static analysis tool to detect bugs in shell scripts.

Shells and Scripting - Static analysis tool for identifying shell script errors.

Security Scanners - Prevents common security vulnerabilities like command injection and improper variable expansion by identifying unsafe coding patterns in shell scripts.

Shell Security Hardening - Quote all arguments and array-expansion variables to prevent unintended word splitting and globbing when processing script arguments containing spaces or special characters.

Code Quality Tools - Enforces best practices and consistent coding standards across shell scripts to improve maintainability and reduce common runtime failures.

Parsers & Lexers - Processes source code into an abstract syntax tree by recursively matching grammar rules against tokens.

Automated Code Review - Inspects scripts for common pitfalls and suggests idiomatic improvements to ensure consistent and robust code execution.

Cross-Platform Utilities - Detects non-standard or dialect-specific syntax to ensure scripts remain compatible across different operating systems and shell interpreters.

Shell Script Optimizers - Remove redundant echo commands wrapping shell command substitutions to improve script performance and preserve exit codes.

Shell Scripting Utilities - Wrap invisible terminal control codes in prompt strings with specific delimiters to ensure the shell correctly calculates line length and prevents display wrapping issues.

Shells & Scripting - Store the result of a shell command in a variable by wrapping the command in parentheses preceded by a dollar sign for later use in scripts.

Shell Scripting Best Practices - Provides patterns for processing file contents line by line to prevent common shell scripting errors like unintended word splitting.

Static Analysis - Allows explicit definition of sourced file paths to enable accurate static analysis of shell scripts.

koalamanshellcheck

Features

Star history