From 782a4324a802421d396f8cd7c605b220302f72be Mon Sep 17 00:00:00 2001
From: Mohammad Rafiq <rafiq@rrv.sh>
Date: Mon, 7 Jul 2025 17:23:36 +0800
Subject: [PATCH] feat(lib): add userListToAttrs function

---
 nix/lib/modules.nix | 31 +++++++++++++++++++++++++++++++
 1 file changed, 31 insertions(+)

diff --git a/nix/lib/modules.nix b/nix/lib/modules.nix
index 28b6a0b..0d5b50b 100644
--- a/nix/lib/modules.nix
+++ b/nix/lib/modules.nix
@@ -1,10 +1,41 @@
 { lib, config, ... }:
 let
   cfg = config.flake;
+  inherit (builtins) foldl' attrNames;
   inherit (lib.attrsets) mapAttrs;
 in
 {
   flake.lib.modules = {
+    /**
+      Fold over the users list and create an attribute set.
+
+      # Inputs
+
+      `f`
+
+      : A function that takes the name of a user and returns an attribute set.
+
+      # Type
+
+      ```
+      userListToAttrs :: (String -> AttrSet) -> AttrSet
+      ```
+
+      # Examples
+      :::{.example}
+      ## `userListToAttrs` usage example
+
+      ```nix
+      flake.manifest.users.rafiq = { ... };
+      flake.modules.homeManager.users = userListToAttrs (name: {
+        ${name}.home.username = name;
+      });
+      => flake.modules.homeManager.default.users.rafiq.home.username = "rafiq";
+      ```
+
+      :::
+    */
+    userListToAttrs = f: foldl' (acc: elem: acc // (f elem)) { } (attrNames cfg.manifest.users);
     /**
       Return an attribute set for use with a option that needs to be used for all users.