bat: allow setting themes/syntaxes without IFD

The way the `bat` module is currently written makes it essentially
impossible to use themes and syntaxes without IFD, since you must
provide the contents as string, instead of just giving a path to be
linked.

With this change, setting themes/syntaxes by-string will start issuing
warnings, and a new attribute model is added, lightly inspired by how
`programs.zsh.plugins` avoided this issue.

modules/programs/bat.nix

@@ -43,16 +43,33 @@ in {
     };
 
     themes = mkOption {
-      type = types.attrsOf types.lines;
+      type = types.attrsOf (types.either types.lines (types.submodule {
+        options = {
+          src = mkOption {
+            type = types.path;
+            description = "Path to the theme folder.";
+          };
+
+          file = mkOption {
+            type = types.nullOr types.str;
+            default = null;
+            description =
+              "Subpath of the theme file within the source, if needed.";
+          };
+        };
+      }));
       default = { };
       example = literalExpression ''
         {
-          dracula = builtins.readFile (pkgs.fetchFromGitHub {
+          dracula = {
+            src = pkgs.fetchFromGitHub {
               owner = "dracula";
               repo = "sublime"; # Bat uses sublime syntax for its themes
               rev = "26c57ec282abcaa76e57e055f38432bd827ac34e";
               sha256 = "019hfl4zbn4vm4154hh3bwk6hm7bdxbr1hdww83nabxwjn99ndhv";
-          } + "/Dracula.tmTheme");
+            };
+            file = "Dracula.tmTheme";
+          };
         }
       '';
       description = ''
@@ -61,36 +78,76 @@ in {
     };
 
     syntaxes = mkOption {
-      type = types.attrsOf types.lines;
+      type = types.attrsOf (types.either types.lines (types.submodule {
+        options = {
+          src = mkOption {
+            type = types.path;
+            description = "Path to the syntax folder.";
+          };
+          file = mkOption {
+            type = types.nullOr types.str;
+            default = null;
+            description =
+              "Subpath of the syntax file within the source, if needed.";
+          };
+        };
+      }));
       default = { };
       example = literalExpression ''
         {
-          syntaxes.gleam = builtins.readFile (pkgs.fetchFromGitHub {
+          gleam = {
+            src = pkgs.fetchFromGitHub {
               owner = "molnarmark";
               repo = "sublime-gleam";
               rev = "2e761cdb1a87539d827987f997a20a35efd68aa9";
               hash = "sha256-Zj2DKTcO1t9g18qsNKtpHKElbRSc9nBRE2QBzRn9+qs=";
-          } + "/syntax/gleam.sublime-syntax");
+            };
+            file = "syntax/gleam.sublime-syntax";
+          };
         }
       '';
       description = ''
         Additional syntaxes to provide.
       '';
     };
-
   };
 
-  config = mkIf cfg.enable {
+  config = mkIf cfg.enable (mkMerge [
+    (mkIf (any isString (attrValues cfg.themes)) {
+      warnings = [''
+        Using programs.bat.themes as a string option is deprecated and will be
+        removed in the future. Please change to using it as an attribute set
+        instead.
+      ''];
+    })
+    (mkIf (any isString (attrValues cfg.syntaxes)) {
+      warnings = [''
+        Using programs.bat.syntaxes as a string option is deprecated and will be
+        removed in the future. Please change to using it as an attribute set
+        instead.
+      ''];
+    })
+    {
       home.packages = [ package ] ++ cfg.extraPackages;
 
-    xdg.configFile = mkMerge ([{
+      xdg.configFile = mkMerge ([({
         "bat/config" =
           mkIf (cfg.config != { }) { text = toConfigFile cfg.config; };
-    }] ++ flip mapAttrsToList cfg.themes
-      (name: body: { "bat/themes/${name}.tmTheme" = { text = body; }; })
-      ++ flip mapAttrsToList cfg.syntaxes (name: body: {
-        "bat/syntaxes/${name}.sublime-syntax" = { text = body; };
-      }));
+      })] ++ (flip mapAttrsToList cfg.themes (name: val: {
+        "bat/themes/${name}.tmTheme" = if isString val then {
+          text = val;
+        } else {
+          source =
+            if isNull val.file then "${val.src}" else "${val.src}/${val.file}";
+        };
+      })) ++ (flip mapAttrsToList cfg.syntaxes (name: val: {
+        "bat/syntaxes/${name}.sublime-syntax" = if isString val then {
+          text = val;
+        } else {
+          source =
+            if isNull val.file then "${val.src}" else "${val.src}/${val.file}";
+        };
+      })));
 
       home.activation.batCache = hm.dag.entryAfter [ "linkGeneration" ] ''
         (
@@ -99,5 +156,6 @@ in {
           $DRY_RUN_CMD ${lib.getExe package} cache --build
         )
       '';
-  };
+    }
+  ]);
 }

tests/modules/programs/bat/bat.nix

@@ -13,11 +13,11 @@ with lib;
         map-syntax = [ "*.jenkinsfile:Groovy" "*.props:Java Properties" ];
       };
 
-      themes.testtheme = ''
+      themes.testtheme.src = pkgs.writeText "testtheme.tmTheme" ''
         This is a test theme.
       '';
 
-      syntaxes.testsyntax = ''
+      syntaxes.testsyntax.src = pkgs.writeText "testsyntax.sublime-syntax" ''
         This is a test syntax.
       '';
     };

tests/modules/programs/bat/default.nix

@@ -1 +1,4 @@
-{ bat = ./bat.nix; }
+{
+  bat = ./bat.nix;
+  bat-deprecated-options = ./deprecated-options.nix;
+}

tests/modules/programs/bat/deprecated-options.nix

@@ -0,0 +1,67 @@
+{ config, lib, pkgs, ... }:
+
+with lib;
+
+{
+  config = {
+    programs.bat = {
+      enable = true;
+
+      config = {
+        theme = "TwoDark";
+        pager = "less -FR";
+        map-syntax = [ "*.jenkinsfile:Groovy" "*.props:Java Properties" ];
+      };
+
+      themes.testtheme = ''
+        This is a test theme.
+      '';
+
+      syntaxes.testsyntax = ''
+        This is a test syntax.
+      '';
+    };
+
+    test.stubs.bat = { };
+
+    test.asserts.warnings.enable = true;
+    test.asserts.warnings.expected = [
+      ''
+        Using programs.bat.themes as a string option is deprecated and will be
+        removed in the future. Please change to using it as an attribute set
+        instead.
+      ''
+      ''
+        Using programs.bat.syntaxes as a string option is deprecated and will be
+        removed in the future. Please change to using it as an attribute set
+        instead.
+      ''
+    ];
+
+    nmt.script = ''
+      assertFileExists home-files/.config/bat/config
+      assertFileContent home-files/.config/bat/config ${
+        pkgs.writeText "bat.expected" ''
+          --map-syntax='*.jenkinsfile:Groovy'
+          --map-syntax='*.props:Java Properties'
+          --pager='less -FR'
+          --theme='TwoDark'
+        ''
+      }
+
+      assertFileExists home-files/.config/bat/themes/testtheme.tmTheme
+      assertFileContent home-files/.config/bat/themes/testtheme.tmTheme ${
+        pkgs.writeText "bat.expected" ''
+          This is a test theme.
+        ''
+      }
+
+      assertFileExists home-files/.config/bat/syntaxes/testsyntax.sublime-syntax
+      assertFileContent home-files/.config/bat/syntaxes/testsyntax.sublime-syntax ${
+        pkgs.writeText "bat.expected" ''
+          This is a test syntax.
+        ''
+      }
+    '';
+  };
+}