Skip to content

registry_paths_resolve

A manifest file enumerates path entries; each must resolve to an on-disk artefact. extract pulls the entry list via a structured query (toml / json / yaml / xml / dotenv / properties / ini / hcl RFC 9535 JSONPath), a line list (lines, optional comment prefix), or a regex capture (regex, group 1). expect (any / file / dir) and must_contain constrain the resolved kind; exclude_query subtracts entries; entries_are_globs expands each entry as a glob. Non-literal entries (interpolation / antiquotation) are skipped, not failed. Optional orphans adds the reverse-completeness check: on-disk artefacts under the space glob that no entry references (the “new crate not wired into the workspace” detector). Cross-file: reads one manifest, resolves against the file index.

OptionTypeRequiredDefaultDescription
basestringnullResolve entries relative to: registry_dir (default), lint_root, or an explicit path.
entries_are_globsbooleanfalseExpand each extracted entry as a glob rather than treating it as a single literal path; a glob that matches nothing is a violation.
exclude_querystringnullA structured query selecting entries to subtract from the extracted list before resolution is checked.
expectone of any | file | dirConstrain the kind each entry must resolve to on disk: any (default), file, or dir.
extractextract specyesExactly one of: toml/json/yaml/xml/dotenv/properties/ini/hcl (RFC 9535 JSONPath string), lines (object; optional comment prefix, default #), regex (string; capture group 1 is the path).
must_containstringnullWhen an entry resolves to a directory, that directory must contain this named child (e.g. Cargo.toml), else the entry is a violation.
orphansOrphansSpecEnable the reverse-completeness check (see OrphansSpec).
sourcestringyesThe manifest/registry file (path, or a glob to run once per matching manifest) that enumerates the path entries.

Plus the common level, id, and when fields. This rule analyses the whole repository, so it takes no paths. This table is generated from the JSON Schema; option types and defaults are authoritative.

A declared workspace member that does not exist

Section titled “A declared workspace member that does not exist”

The rule fires on this repository:

Cargo.toml
crates/
crates/core/
crates/core/Cargo.toml
Cargo.toml
[workspace]
members = ["crates/core", "crates/cli"]
crates/core/Cargo.toml
[package]
name = "core"

With this .alint.yml:

version: 1
rules:
- id: workspace-members-resolve
kind: registry_paths_resolve
source: Cargo.toml
extract: { toml: "$.workspace.members[*]" }
expect: dir
must_contain: Cargo.toml
level: error

alint check reports:

Terminal window
--- Cargo.toml -----------------------------------------------------------------
x error workspace-members-resolve
Cargo.toml: entry "crates/cli" does not resolve to a directory on
disk
Summary (1 violation):
x 1 error
0 passing * 1 failing

Every declared workspace member resolves on disk

Section titled “Every declared workspace member resolves on disk”

This repository is compliant:

Cargo.toml
crates/
crates/cli/
crates/cli/Cargo.toml
crates/core/
crates/core/Cargo.toml
Cargo.toml
[workspace]
members = ["crates/core", "crates/cli"]
crates/cli/Cargo.toml
[package]
name = "cli"
crates/core/Cargo.toml
[package]
name = "core"

With this .alint.yml:

version: 1
rules:
- id: workspace-members-resolve
kind: registry_paths_resolve
source: Cargo.toml
extract: { toml: "$.workspace.members[*]" }
expect: dir
must_contain: Cargo.toml
level: error

alint check reports:

Terminal window
v All 1 rule(s) passed.