Script Processor
Purpose
Runs a user-configured script or command as a linter on discovered files. This is a generic linter that lets you plug in any script without writing a custom processor.
How It Works
Discovers files matching the configured extensions in the configured scan directory, then runs the configured linter command on each file (or batch of files). A non-zero exit code from the script fails the product.
This processor is disabled by default — you must set enabled = true and
provide a command in your rsconstruct.toml.
This processor supports batch mode, allowing multiple files to be checked in a single invocation for better performance.
Source Files
- Input: configured via
src_extensionsandsrc_dirs - Output: none (checker)
Configuration
[processor.script]
enabled = true
command = "python"
args = ["scripts/md_lint.py", "-q"]
src_extensions = [".md"]
src_dirs = ["marp"]
| Key | Type | Default | Description |
|---|---|---|---|
enabled | bool | false | Must be set to true to activate |
command | string | (required) | The command to run |
args | string[] | [] | Extra arguments passed before file paths |
src_extensions | string[] | [] | File extensions to scan for |
src_dirs | string[] | [""] | Directory to scan (empty = project root) |
dep_inputs | string[] | [] | Extra files whose changes trigger rebuilds |
dep_auto | string[] | [] | Auto-detected input files |
Batch support
The tool accepts multiple files on the command line. When batching is enabled (default), rsconstruct passes all files in a single invocation for better performance.