chore: support both config and configFile

Author: elsbrock

nixarr/recyclarr/default.nix

@@ -8,6 +8,7 @@
 with lib; let
   cfg = config.nixarr.recyclarr;
   nixarr = config.nixarr;
+  format = pkgs.formats.yaml {};
 
   # Helper function to extract API keys
   extractApiKeys = pkgs.writeShellApplication {
@@ -41,6 +42,12 @@ with lib; let
       chown ${config.services.recyclarr.user}:${config.services.recyclarr.group} "${cfg.stateDir}/env"
     '';
   };
+
+  # Generate configuration file from Nix attribute set if provided
+  generatedConfigFile = format.generate "recyclarr-config.yml" cfg.configuration;
+
+  # Determine which config file to use
+  effectiveConfigFile = if cfg.configFile != null then cfg.configFile else generatedConfigFile;
 in {
   options.nixarr.recyclarr = {
     enable = mkOption {
@@ -71,55 +78,87 @@ in {
     };
 
     configFile = mkOption {
-      type = types.path;
+      type = types.nullOr types.path;
+      default = null;
       description = ''
         Path to the recyclarr YAML configuration file. See [Recyclarr's
         documentation](https://recyclarr.dev/wiki/yaml/config-reference)
         for more information.
 
         The API keys for Radarr and Sonarr can be referenced in the config
         file using the `RADARR_API_KEY` and `SONARR_API_KEY` environment
-        variables (with macro `!env_var`). The below example configuration
-        shows how these values can be used:
-
-        ```yaml
-          sonarr:
-            series:
-              base_url: "http://localhost:8989"
-              api_key: !env_var SONARR_API_KEY
-              quality_definition:
-                type: series
-              delete_old_custom_formats: true
-              custom_formats:
-                - trash_ids:
-                    - 85c61753df5da1fb2aab6f2a47426b09 # BR-DISK
-                    - 9c11cd3f07101cdba90a2d81cf0e56b4 # LQ
-                    - 47435ece6b99a0b477caf360e79ba0bb # x265 (HD)
-                    - fbcb31d8dabd2a319072b84fc0b7249c # Extras
-                  assign_scores_to:
-                    - name: WEB-DL (1080p)
-                      score: -10000
-          radarr:
-            movies:
-              base_url: "http://localhost:7878"
-              api_key: !env_var RADARR_API_KEY
-              quality_definition:
-                type: movie
-              delete_old_custom_formats: true
-              custom_formats:
-                - trash_ids:
-                    - 570bc9ebecd92723d2d21500f4be314c # Remaster
-                    - eca37840c13c6ef2dd0262b141a5482f # 4K Remaster
-                    - e0c07d59beb37348e975a930d5e50319 # Criterion Collection
-                    - 9d27d9d2181838f76dee150882bdc58c # Masters of Cinema
-                    - db9b4c4b53d312a3ca5f1378f6440fc9 # Vinegar Syndrome
-                  assign_scores_to:
-                    - name: HD Bluray + WEB
-                      score: 25
-        ```
+        variables (with macro `!env_var`).
+
+        Note: You cannot set both `configFile` and `configuration` options.
       '';
       example = "./recyclarr.yaml";
     };
+
+    configuration = mkOption {
+      type = types.nullOr format.type;
+      default = null;
+      example = literalExpression ''
+        {
+          sonarr = {
+            series = {
+              base_url = "http://localhost:8989";
+              api_key = "!env_var SONARR_API_KEY";
+              quality_definition = {
+                type = "series";
+              };
+              delete_old_custom_formats = true;
+              custom_formats = [
+                {
+                  trash_ids = [
+                    "85c61753df5da1fb2aab6f2a47426b09" # BR-DISK
+                    "9c11cd3f07101cdba90a2d81cf0e56b4" # LQ
+                  ];
+                  assign_scores_to = [
+                    {
+                      name = "WEB-DL (1080p)";
+                      score = -10000;
+                    }
+                  ];
+                }
+              ];
+            };
+          };
+          radarr = {
+            movies = {
+              base_url = "http://localhost:7878";
+              api_key = "!env_var RADARR_API_KEY";
+              quality_definition = {
+                type = "movie";
+              };
+              delete_old_custom_formats = true;
+              custom_formats = [
+                {
+                  trash_ids = [
+                    "570bc9ebecd92723d2d21500f4be314c" # Remaster
+                    "eca37840c13c6ef2dd0262b141a5482f" # 4K Remaster
+                  ];
+                  assign_scores_to = [
+                    {
+                      name = "HD Bluray + WEB";
+                      score = 25;
+                    }
+                  ];
+                }
+              ];
+            };
+          };
+        }
+      '';
+      description = ''
+        Recyclarr YAML configuration as a Nix attribute set. For detailed configuration options and examples, 
+        see the [official configuration reference](https://recyclarr.dev/wiki/yaml/config-reference/).
+
+        The API keys for Radarr and Sonarr can be referenced using the `RADARR_API_KEY` and `SONARR_API_KEY` 
+        environment variables (with the string "!env_var RADARR_API_KEY").
+
+        Note: You cannot set both `configFile` and `configuration` options.
+      '';
+    };
   };
 
   config = mkIf cfg.enable {
@@ -138,6 +177,19 @@ in {
           or nixarr.sonarr.enable to be set, but neither was enabled.
         '';
       }
+      {
+        assertion = !(cfg.configFile != null && cfg.configuration != null);
+        message = ''
+          You cannot set both nixarr.recyclarr.configFile and nixarr.recyclarr.configuration.
+          Please choose one method to configure Recyclarr.
+        '';
+      }
+      {
+        assertion = cfg.configFile != null || cfg.configuration != null;
+        message = ''
+          You must set either nixarr.recyclarr.configFile or nixarr.recyclarr.configuration.
+        '';
+      }
     ];
 
     services.recyclarr = {
@@ -168,7 +220,7 @@ in {
       requires = ["recyclarr-setup.service"];
       after = ["recyclarr-setup.service"];
       serviceConfig = {
-        ExecStart = lib.mkForce "${cfg.package}/bin/recyclarr sync --app-data ${cfg.stateDir} --config ${cfg.configFile}";
+        ExecStart = lib.mkForce "${cfg.package}/bin/recyclarr sync --app-data ${cfg.stateDir} --config ${effectiveConfigFile}";
         EnvironmentFile = "${cfg.stateDir}/env";
         ReadWritePaths = [cfg.stateDir];
       };