nt/nib/parse/struct.nix
2025-12-15 00:24:18 +10:00

96 lines
2.4 KiB
Nix

{nib, ...}: let
Err = nib.types.Err;
Ok' = nib.types.Ok';
firstErr = nib.types.firstErr;
unwrapSome = nib.types.unwrapSome;
isTerminal = nib.types.isTerminal;
unwrapTerminal = nib.types.unwrapTerminal;
mapAttrsRecursiveCond = nib.std.mapAttrsRecursiveCond;
attrValueAt = nib.std.attrValueAt;
in rec {
cmpStructErr' = errBadKeys: errBadValues: path: S: T:
if builtins.isAttrs S && builtins.isAttrs T
then let
keysS = builtins.attrNames S;
keysT = builtins.attrNames T;
in
# ensure all key names match, then recurse
if !(keysS == keysT)
then errBadKeys path keysS keysT
else
(firstErr
(map
(k: cmpStructErr' errBadKeys errBadValues (path ++ [k]) (keysS.${k}) (keysT.${k}))
keysS))
else
# terminating leaf in recursion tree reached
# ensure values' types match
(builtins.typeOf S == builtins.typeOf T)
|| errBadValues path S T;
cmpStructErr = errBadKeys: errBadValues: cmpStructErr' errBadKeys errBadValues [];
cmpStruct =
cmpStructErr
(path: _: _:
Err {
reason = "keys";
inherit path;
})
(_: _: _: Ok');
cmpTypedStruct =
cmpStructErr
(path: _: _:
Err {
reason = "keys";
inherit path;
})
(path: _: _:
Err {
reason = "values";
inherit path;
});
cmpTypedPartialStruct =
cmpStructErr
(_: _: _: Ok')
(path: _: _:
Err {
reason = "values";
inherit path;
});
mergeStructs' = f: cond: S: T:
mapAttrsRecursiveCond
cond
(path: valueS: let
maybeValueT = attrValueAt T path;
in
unwrapSome (_: f valueS) maybeValueT)
S;
# mergeStruct ensures no properties are evaluated (entirely lazy)
mergeStructs = mergeStruct (x: x);
# given a template struct, and the struct to parse
parseStructFor =
mergeStructs'
(leaf: !isTerminal leaf)
(value:
if isTerminal value
then unwrapTerminal value
else value);
# TODO: Define:
# TODO: throwUnreachable = throw "Unreachable code was evaluated..";
# TODO: abortUnreachable = abort "Unreachable code was evaluated...";
mergeStruct = mergeStructs' (_: _: Ok');
# mergeTypedPartialStruct must evaluate properties (not lazy)
# for lazy evaluation use mergeStruct instead!
mergeTypedPartialStruct = mergeStructs' cmpTypedPartialStruct;
}