Skip to content

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_absent for a path. equals / matches / if_present don’t apply.
  • Useful for forbidding a key: a postinstall script in package.json, a [patch] table in Cargo.toml, or write-all permissions in a workflow.
OptionTypeRequiredDefaultDescription
pathstringyesJSONPath 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.

The rule fires on this repository:

config.ini
config.ini
[server]
port = 8080
debug = true

With this .alint.yml:

version: 1
rules:
- 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:

Terminal window
--- config.ini -----------------------------------------------------------------
x error no-debug
debug is set in a production .ini; remove it.
Summary (1 violation):
x 1 error
0 passing * 1 failing

This repository is compliant:

config.ini
config.ini
[server]
port = 8080

With this .alint.yml:

version: 1
rules:
- id: no-debug
kind: ini_path_absent
paths: "config.ini"
path: "$['server']['debug']"
level: error

alint check reports:

Terminal window
v All 1 rule(s) passed.