Add option to backup and prune for tags

This adds the options for both backup and prune to allow specifying tags. For backup it adds the specified tags to the backup snapshot. For prune it will ensure only snapshots with the specified tags are forgotten.

Tested by adding unit tests and then:
```
poetry run pytest -k test_runner
```

Author: mattjgalloway

runrestic/restic/runner.py

@@ -154,6 +154,8 @@ def backup(self) -> None:
             extra_args += ["--exclude-file", exclude_file]
         for exclude_if_present in cfg.get("exclude_if_present", []):
             extra_args += ["--exclude-if-present", exclude_if_present]
+        for tag in cfg.get("tags", []):
+            extra_args += ["--tag", tag]
 
         commands = [
             [
@@ -233,6 +235,9 @@ def forget(self) -> None:
                 extra_args += [f"--{key}", str(value)]
             if key == "group-by":
                 extra_args += ["--group-by", value]
+            if key == "tags":
+                for tag in value:
+                    extra_args += ["--tag", tag]
 
         direct_abort_reasons = [
             "Fatal: unable to open config file",

runrestic/runrestic/schema.json

@@ -66,6 +66,7 @@
         "exclude_patterns": {"type": "array", "items": {"type": "string"}},
         "exclude_files": {"type": "array", "items": {"type": "string"}},
         "exclude_if_present": {"type": "array", "items": {"type": "string"}},
+        "tags": {"type": "array", "items": {"type": "string"}},
         "pre_hooks": {"type": "array", "items": {"type": "string"}},
         "post_hooks": {"type": "array", "items": {"type": "string"}},
         "continue_on_pre_hooks_error": {"type": "boolean", "default": false}
@@ -93,7 +94,8 @@
         "keep-yearly": {"type": "integer"},
         "keep-within": {"type": "string"},
         "keep-tag": {"type": "string"},
-        "group-by": {"type": "string"}
+        "group-by": {"type": "string"},
+        "tags": {"type": "array", "items": {"type": "string"}}
       }
     },
 

tests/restic/test_runner.py

@@ -244,6 +244,7 @@ def test_backup_metrics(self, mock_redact, mock_parse_backup, mock_mc):
                 "exclude_patterns": ["*.exclude"],
                 "exclude_files": ["dummy_file"],
                 "exclude_if_present": ["*.present"],
+                "tags": ["tagone", "tagtwo"],
             },
             "metrics": {},
         }
@@ -273,6 +274,10 @@ def test_backup_metrics(self, mock_redact, mock_parse_backup, mock_mc):
                 "dummy_file",
                 "--exclude-if-present",
                 "*.present",
+                "--tag",
+                "tagone",
+                "--tag",
+                "tagtwo",
                 "/data",
             ],
             [
@@ -289,6 +294,10 @@ def test_backup_metrics(self, mock_redact, mock_parse_backup, mock_mc):
                 "dummy_file",
                 "--exclude-if-present",
                 "*.present",
+                "--tag",
+                "tagone",
+                "--tag",
+                "tagtwo",
                 "/data",
             ],
         ]
@@ -463,6 +472,61 @@ def test_forget_metrics(self, mock_redact, mock_parse_forget, mock_mc):
         self.assertEqual(metrics["repo"], {"forgotten": True})
         self.assertEqual(runner_instance.metrics["errors"], 0)
 
+    @patch("runrestic.restic.runner.MultiCommand")
+    @patch("runrestic.restic.runner.parse_forget")
+    @patch(
+        "runrestic.restic.runner.redact_password", side_effect=lambda repo, repl: repo
+    )
+    def test_forget_with_tags(self, mock_redact, mock_parse_forget, mock_mc):
+        """
+        Test forget() handles tags correctly.
+        """
+        config = {
+            "repositories": ["repo"],
+            "environment": {},
+            "execution": {},
+            "prune": {
+                "keep-last": 3,
+                "tags": ["tagone", "tagtwo"],
+            },
+        }
+        args = Namespace(dry_run=True)
+        restic_args: list[str] = []
+        runner_instance = runner.ResticRunner(config, args, restic_args)
+        process_info = {"output": [(0, "")], "time": 0.1}
+        mock_mc.return_value.run.return_value = [process_info]
+        mock_parse_forget.return_value = {"forgotten": True}
+
+        runner_instance.forget()
+        metrics = runner_instance.metrics["forget"]
+        self.assertEqual(metrics["repo"], {"forgotten": True})
+        self.assertEqual(runner_instance.metrics["errors"], 0)
+
+        # Ensure "--tag tagone --tag tagtwo" appears in the command
+        expected_cmds = [
+            [
+                "restic",
+                "-r",
+                "repo",
+                "forget",
+                "--dry-run",
+                "--keep-last",
+                "3",
+                "--tag",
+                "tagone",
+                "--tag",
+                "tagtwo",
+            ]
+        ]
+        mock_mc.assert_called_once_with(
+            expected_cmds,
+            config=config["execution"],
+            abort_reasons=[
+                "Fatal: unable to open config file",
+                "Fatal: wrong password",
+            ],
+        )
+
     @patch("runrestic.restic.runner.MultiCommand")
     @patch("runrestic.restic.runner.parse_forget")
     @patch(