ini_path_absent
Assert a JSONPath query over the document matches nothing; one file-level violation if present.
Semantics:
- The query must select zero nodes. Any match fires exactly one violation for the file — never per-match, so a
$[?…]filter that fans out over every top-level key still yields a single violation. - The existence sibling of the value-checking kinds; mirrors
file_absentfor a path.equals/matches/if_presentdon’t apply. - Useful for forbidding a key: a
postinstallscript inpackage.json, a[patch]table inCargo.toml, orwrite-allpermissions in a workflow.
Options
Section titled “Options”| Option | Type | Required | Default | Description |
|---|---|---|---|---|
path | string | yes | JSONPath expression rooted at $. The rule fires one violation per file if the query matches any node (the path must be absent). |
Plus the common paths, level, id, and when fields. This table is generated from the JSON Schema; option types and defaults are authoritative.
Example
Section titled “Example”An .ini that leaves debug enabled
Section titled “An .ini that leaves debug enabled”The rule fires on this repository:
config.ini[server]port = 8080debug = trueWith this .alint.yml:
version: 1rules: - id: no-debug kind: ini_path_absent paths: "config.ini" path: "$['server']['debug']" level: error message: >- debug is set in a production .ini; remove it.alint check reports:
--- config.ini ----------------------------------------------------------------- x error no-debug debug is set in a production .ini; remove it.
Summary (1 violation): x 1 error 0 passing * 1 failingAn .ini with no debug flag
Section titled “An .ini with no debug flag”This repository is compliant:
config.ini[server]port = 8080With this .alint.yml:
version: 1rules: - id: no-debug kind: ini_path_absent paths: "config.ini" path: "$['server']['debug']" level: erroralint check reports:
v All 1 rule(s) passed.