trayscale: add module

Trayscale is an unofficial GUI wrapper around the Tailscale CLI
client.

PR #5803

modules/lib/maintainers.nix

@@ -587,4 +587,12 @@
     github = "zorrobert";
     githubId = 118135271;
   };
+  callumio = {
+    name = "Callum Leslie";
+    email = "git+nix@cleslie.uk";
+    github = "callumio";
+    githubId = 16057677;
+    keys =
+      [{ fingerprint = "BC82 4BB5 1656 D144 285E  A0EC D382 C4AF EECE AA90"; }];
+  };
 }

modules/misc/news.nix

@@ -1703,6 +1703,16 @@ in {
           one place. See https://github.com/glanceapp/glance for more.
         '';
       }
+
+      {
+        time = "2024-09-13T08:58:17+00:00";
+        condition = hostPlatform.isLinux;
+        message = ''
+          A new module is available: 'services.trayscale'.
+
+          An unofficial GUI wrapper around the Tailscale CLI client.
+        '';
+      }
     ];
   };
 }

modules/modules.nix

@@ -374,6 +374,7 @@ let
     ./services/tahoe-lafs.nix
     ./services/taskwarrior-sync.nix
     ./services/trayer.nix
+    ./services/trayscale.nix
     ./services/twmn.nix
     ./services/udiskie.nix
     ./services/unclutter.nix

modules/services/trayscale.nix

@@ -0,0 +1,39 @@
+{ config, lib, pkgs, ... }:
+
+let cfg = config.services.trayscale;
+in {
+  meta.maintainers = [ lib.hm.maintainers.callumio ];
+
+  options.services.trayscale = {
+    enable = lib.mkEnableOption
+      "An unofficial GUI wrapper around the Tailscale CLI client.";
+
+    package = lib.mkPackageOption pkgs "trayscale" { };
+
+    hideWindow = lib.mkOption {
+      type = lib.types.bool;
+      default = true;
+      description = "Whether to hide the trayscale window on startup.";
+    };
+  };
+
+  config = lib.mkIf cfg.enable {
+    assertions = [
+      (lib.hm.assertions.assertPlatform "services.trayscale" pkgs
+        lib.platforms.linux)
+    ];
+
+    systemd.user.services.trayscale = {
+      Unit = {
+        Description =
+          "An unofficial GUI wrapper around the Tailscale CLI client";
+        Requires = [ "tray.target" ];
+        After = [ "graphical-session-pre.target" "tray.target" ];
+        PartOf = [ "graphical-session.target" ];
+      };
+      Install = { WantedBy = [ "graphical-session.target" ]; };
+      Service.ExecStart = toString ([ "${cfg.package}/bin/trayscale" ]
+        ++ lib.optional cfg.hideWindow "--hide-window");
+    };
+  };
+}

tests/default.nix

@@ -275,6 +275,7 @@ in import nmtSrc {
     ./modules/services/sxhkd
     ./modules/services/syncthing/linux
     ./modules/services/trayer
+    ./modules/services/trayscale
     ./modules/services/twmn
     ./modules/services/udiskie
     ./modules/services/window-managers/bspwm

tests/modules/services/trayscale/default.nix

@@ -0,0 +1,4 @@
+{
+  trayscale-show-window = ./show-window.nix;
+  trayscale-hide-window = ./hide-window.nix;
+}

tests/modules/services/trayscale/hide-window.nix

@@ -0,0 +1,15 @@
+{ ... }: {
+  services.trayscale = {
+    enable = true;
+    hideWindow = true;
+  };
+
+  test.stubs = { trayscale = { }; };
+
+  nmt.script = ''
+    serviceFile=home-files/.config/systemd/user/trayscale.service
+    assertFileExists $serviceFile
+    assertFileRegex $serviceFile \
+      '^ExecStart=@trayscale@/bin/trayscale --hide-window$'
+  '';
+}

tests/modules/services/trayscale/show-window.nix

@@ -0,0 +1,15 @@
+{ ... }: {
+  services.trayscale = {
+    enable = true;
+    hideWindow = false;
+  };
+
+  test.stubs = { trayscale = { }; };
+
+  nmt.script = ''
+    serviceFile=home-files/.config/systemd/user/trayscale.service
+    assertFileExists $serviceFile
+    assertFileRegex $serviceFile \
+      '^ExecStart=@trayscale@/bin/trayscale$'
+  '';
+}