den.lib (deprecated)

`den.lib.parametric`

Historically wrapped an aspect to filter includes by argument compatibility. The fx pipeline now resolves parametric dispatch directly, so parametric and parametric.atLeast / parametric.exactly are identity passthroughs that emit a deprecation warning. Each call logs den.lib.parametric: … is deprecated.

# Deprecated — pass the plain attrset directly instead.
den.lib.parametric { nixos.x = 1; includes = [ ... ]; }

`den.lib.parametric.atLeast`

Identity passthrough (warns). Previously: match when all required params are present.

`den.lib.parametric.exactly`

Identity passthrough (warns). Previously: match only when required params exactly equal provided params.

den.lib.parametric.exactly { includes = [ ({ host }: ...) ]; }

`den.lib.parametric.fixedTo`

Pins context values for the aspect via scope handlers (constantHandler), so the aspect resolves as if those values were in scope. Returns a parametric wrapper and warns. Variants .exactly, .atLeast, and .upTo behave the same.

den.lib.parametric.fixedTo { host = myHost; } someAspect

`den.lib.parametric.expands`

Merges additional attributes into the aspect’s scope handlers before dispatch. Returns a parametric wrapper and warns.

den.lib.parametric.expands { extra = true; } someAspect

`den.lib.canTake`

Function argument introspection. A pure predicate (it does not warn), still used internally by the type system; prefer plain parametric functions in new code.

`den.lib.canTake params fn`

Returns true if fn’s required arguments are satisfied by params (atLeast).

`den.lib.canTake.atLeast params fn`

Same as canTake.

`den.lib.canTake.exactly params fn`

Returns true only if fn’s required arguments exactly match params.

`den.lib.canTake.upTo params fn`

Returns true if fn is satisfied by params and at least one of params overlaps fn’s arguments.

`den.lib.take`

Context-level guards. Under handler-based resolution the pipeline resolves function arguments automatically, so most of these now warn.

`den.lib.take.exactly fn`

Returns a parametric wrapper that calls fn only when the resolved context matches fn’s declared arguments exactly (no extra context keys). Warns.

`den.lib.take.atLeast fn`

Identity passthrough (warns). The pipeline’s deferral already provides atLeast semantics.

`den.lib.take.upTo fn`

Identity passthrough (warns).

`den.lib.take.unused`

_unused: used: used — ignores the first argument, returns the second. A plain helper (does not warn).

Context shortcuts

Run an aspect only at a specific context level. Each returns a parametric wrapper (declaring deeper context keys as optional) that yields {} when resolved at a deeper level, and warns. Prefer a plain function with the level’s keys, e.g. ({ host, user, ... }: { ... }).

`den.lib.perHost aspect`

Run aspect only in { host } contexts.

`den.lib.perUser aspect`

Run aspect only in { host, user } contexts.

`den.lib.perHome aspect`

Run aspect only in { home } contexts.

`den.lib.resolveStage`

Contribute Community Sponsor