chore(modules): factor out option doc generation

catppuccin · Apr 29, 2024 · b88fd06 · b88fd06
1 parent 28d41bc
commit b88fd06
Show file tree

Hide file tree

Showing 3 changed files with 37 additions and 36 deletions.
diff --git a/dev/flake.nix b/dev/flake.nix
@@ -10,7 +10,7 @@
     };
   };
 
-  outputs = { self, nixpkgs, ... }@inputs:
+  outputs = { self, nixpkgs, home-manager }:
     let
       systems = [
         "x86_64-linux"
@@ -19,43 +19,28 @@
         "aarch64-darwin"
       ];
 
-      inherit (nixpkgs) lib;
-
-      forAllSystems = fn: lib.genAttrs systems (s: fn nixpkgs.legacyPackages.${s});
+      forAllSystems = fn: nixpkgs.lib.genAttrs systems (system: fn nixpkgs.legacyPackages.${system});
     in
     {
-      checks = forAllSystems (pkgs: lib.optionalAttrs pkgs.stdenv.isLinux {
-        module-vm-test = pkgs.nixosTest (import ../test.nix inputs);
+      checks = forAllSystems ({ lib, pkgs, ... }: lib.optionalAttrs pkgs.stdenv.isLinux {
+        module-vm-test = pkgs.callPackage ../test.nix { inherit home-manager; };
       });
 
       formatter = forAllSystems (pkgs: pkgs.nixpkgs-fmt);
 
       packages = forAllSystems (pkgs:
         let
-          eval = module: lib.evalModules {
-            modules = [
-              module
-              {
-                _module.check = false;
-              }
-            ];
-          };
-
-          mkDoc = name: module:
-            let
-              doc = pkgs.nixosOptionsDoc {
-                options = lib.filterAttrs (n: _: n != "_module") (eval module).options;
-                documentType = "none";
-                revision = builtins.substring 0 8 self.rev or "dirty";
-              };
-            in
-            pkgs.runCommand "${name}-module-doc.md" { } ''
-              cat ${doc.optionsCommonMark} > $out
-            '';
+          version = self.shortRev or self.dirtyShortRev or "unknown";
+          mkOptionDoc = args: (pkgs.callPackage ./option-doc.nix { }) args // { inherit version; };
         in
         {
-          nixos-doc = mkDoc "nixos" ../modules/nixos;
-          home-manager-doc = mkDoc "home-manager" ../modules/home-manager;
+          nixos-doc = mkOptionDoc {
+            modules = [ ../modules/nixos ];
+          };
+
+          home-manager-doc = mkOptionDoc {
+            modules = [ ../modules/home-manager ];
+          };
 
           default = self.packages.${pkgs.system}.home-manager-doc;
         });

diff --git a/dev/option-doc.nix b/dev/option-doc.nix
@@ -0,0 +1,19 @@
+{ lib
+, nixosOptionsDoc
+,
+}: { version
+   , modules
+   ,
+   }:
+let
+  eval = lib.evalModules {
+    modules = modules ++ [{ _module.check = false; }];
+  };
+
+  doc = nixosOptionsDoc {
+    options = lib.filterAttrs (n: _: n != "_module") eval.options;
+    documentType = "none";
+    revision = version;
+  };
+in
+doc.optionsCommonMark
diff --git a/test.nix b/test.nix
@@ -1,21 +1,18 @@
-inputs:
+{ testers, home-manager }:
 let
   common = {
-    catppuccin = {
-      enable = true;
-      flavour = "mocha";
-    };
+    catppuccin.enable = true;
   };
 
-  # shorthand enable
+  # shorthand for enabling a module
   enable = { enable = true; };
 in
-{
+testers.runNixOSTest {
   name = "module-test";
 
   nodes.machine = { lib, ... }: {
     imports = [
-      inputs.home-manager.nixosModules.default
+      home-manager.nixosModules.default
       ./modules/nixos
       common
     ];