clock-rs: add module

clock-rs is a modern, digital clock that effortlessly runs in your terminal

modules/misc/news/2025-04-20_20-12-03.nix

@@ -0,0 +1,9 @@
+{
+  time = "2025-04-21T01:12:03+00:00";
+  condition = true;
+  message = ''
+    A new module is available: 'programs.clock-rs'.
+
+    clock-rs is a modern, digital clock that effortlessly runs in your terminal.
+  '';
+}

modules/modules.nix

@@ -86,6 +86,7 @@ let
       ./programs/cavalier.nix
       ./programs/chawan.nix
       ./programs/chromium.nix
+      ./programs/clock-rs.nix
       ./programs/cmus.nix
       ./programs/command-not-found/command-not-found.nix
       ./programs/comodoro.nix

modules/programs/clock-rs.nix

@@ -0,0 +1,62 @@
+{
+  config,
+  lib,
+  pkgs,
+  ...
+}:
+
+let
+  cfg = config.programs.clock-rs;
+  tomlFormat = pkgs.formats.toml { };
+in
+{
+  meta.maintainers = with lib.maintainers; [ oughie ];
+
+  options.programs.clock-rs = {
+    enable = lib.mkEnableOption "clock-rs";
+
+    package = lib.mkPackageOption pkgs "clock-rs" { nullable = true; };
+
+    settings = lib.mkOption {
+      type = tomlFormat.type;
+      default = { };
+      description = "The configuration file to be used for clock-rs";
+      example = lib.literalExpression ''
+        general = {
+          color = "magenta";
+          interval = 250;
+          blink = true;
+          bold = true;
+        };
+
+        position = {
+          horizontal = "start";
+          vertical = "end";
+        };
+
+        date = {
+          fmt = "%A, %B %d, %Y";
+          use_12h = true;
+          utc = true;
+          hide_seconds = true;
+        };
+      '';
+    };
+  };
+
+  config = lib.mkIf cfg.enable {
+    home =
+      let
+        configDir =
+          if pkgs.stdenv.hostPlatform.isDarwin then "Library/Application Support" else config.xdg.configHome;
+      in
+      {
+        packages = lib.mkIf (cfg.package != null) [ cfg.package ];
+
+        file."${configDir}/clock-rs/conf.toml" = lib.mkIf (cfg.settings != { }) {
+          source = tomlFormat.generate "clock-rs-config" cfg.settings;
+        };
+      };
+  };
+
+}