Test top-level contextual aspects.

templates/default/modules/aspects/alice.nix

@@ -1,11 +1,14 @@
-{ den, ... }:
+{ den, eg, ... }:
 {
   den.aspects.alice = {
-    # You can include other aspects, in this case some
-    # den included batteries that provide common configs.
+
+    # Alice can include other aspects.
+    # For small, private one-shot aspects, use let-bindings like here.
+    # for more complex or re-usable ones, define on their own modules,
+    # as part of any aspect-subtree.
     includes =
       let
-        # deadnix: skip # demo: enable <> on lexical scope
+        # deadnix: skip # not required, showcasing angle-brackets syntax.
         inherit (den.lib) __findFile;
 
         customEmacs.homeManager =
@@ -16,8 +19,14 @@
           };
       in
       [
+        # from local bindings.
         customEmacs
-        <eg/autologin>
+        # from the aspect tree, cooper example is defined bellow
+        den.aspects.cooper
+        den.aspects.setHost
+        # from the `eg` namespace.
+        eg.autologin
+        # den included batteries that provide common configs.
         <den/primary-user> # alice is admin always.
         (<den/user-shell> "fish") # default user shell
       ];
@@ -26,10 +35,7 @@
     nixos =
       { pkgs, ... }:
       {
-        users.users.alice = {
-          description = "Alice Cooper";
-          packages = [ pkgs.vim ];
-        };
+        users.users.alice.packages = [ pkgs.vim ];
       };
 
     # Alice home-manager.
@@ -46,4 +52,19 @@
         nixos.programs.nh.enable = host.name == "igloo";
       };
   };
+
+  # This is a context-aware aspect, that emits configurations
+  # **anytime** at least the `user` data is in context.
+  # read more at https://vic.github.io/den/context-aware.html
+  den.aspects.cooper =
+    { user, ... }:
+    {
+      nixos.users.users.${user.userName}.description = "Alice Cooper";
+    };
+
+  den.aspects.setHost =
+    { host, ... }:
+    {
+      networking.hostName = host.hostName;
+    };
 }

templates/examples/modules/_example/ci/top-level-parametric.nix

@@ -0,0 +1,47 @@
+# it is possible for top-level aspects directly under
+# den.aspects to take a context argument.
+{ den, lib, ... }:
+let
+  # A module to test that toplevel had context.
+  topLevel = name: {
+    config.tops = name;
+    options.tops = lib.mkOption { type = lib.types.str; };
+  };
+in
+{
+
+  den.aspects.toplevel-user =
+    { user, ... }:
+    {
+      nixos.imports = [ (topLevel user.name) ];
+    };
+
+  den.aspects.toplevel-host =
+    { host, ... }:
+    {
+      homeManager.imports = [ (topLevel host.name) ];
+    };
+
+  den.aspects.alice.includes = [
+    den.aspects.toplevel-host
+    den.aspects.toplevel-user
+  ];
+
+  perSystem =
+    {
+      checkCond,
+      alice-at-rockhopper,
+      rockhopper,
+      ...
+    }:
+    {
+      checks.alice-toplevel-user = checkCond "alice toplevel param aspect" (
+        rockhopper.config.tops == "alice"
+      );
+
+      checks.alice-toplevel-host = checkCond "alice toplevel param aspect" (
+        alice-at-rockhopper.tops == "rockhopper"
+      );
+    };
+
+}