Add backup interval setting and throttled backups

src/password_manager/backup.py

@@ -54,6 +54,7 @@ class BackupManager:
         self.backup_dir = self.fingerprint_dir / "backups"
         self.backup_dir.mkdir(parents=True, exist_ok=True)
         self.index_file = self.fingerprint_dir / "seedpass_entries_db.json.enc"
+        self._last_backup_time = 0.0
         logger.debug(
             f"BackupManager initialized with backup directory at {self.backup_dir}"
         )
@@ -71,7 +72,13 @@ class BackupManager:
                 )
                 return
 
-            timestamp = int(time.time())
+            now = time.time()
+            interval = self.config_manager.get_backup_interval()
+            if interval > 0 and now - self._last_backup_time < interval:
+                logger.info("Skipping backup due to interval throttle")
+                return
+
+            timestamp = int(now)
             backup_filename = self.BACKUP_FILENAME_TEMPLATE.format(timestamp=timestamp)
             backup_file = self.backup_dir / backup_filename
 
@@ -81,6 +88,7 @@ class BackupManager:
             print(colored(f"Backup created successfully at '{backup_file}'.", "green"))
 
             self._create_additional_backup(backup_file)
+            self._last_backup_time = now
         except Exception as e:
             logger.error(f"Failed to create backup: {e}", exc_info=True)
             print(colored(f"Error: Failed to create backup: {e}", "red"))

src/password_manager/config_manager.py

@@ -46,6 +46,7 @@ class ConfigManager:
                 "inactivity_timeout": INACTIVITY_TIMEOUT,
                 "kdf_iterations": 100_000,
                 "additional_backup_path": "",
+                "backup_interval": 0,
                 "secret_mode_enabled": False,
                 "clipboard_clear_delay": 45,
             }
@@ -60,6 +61,7 @@ class ConfigManager:
             data.setdefault("inactivity_timeout", INACTIVITY_TIMEOUT)
             data.setdefault("kdf_iterations", 100_000)
             data.setdefault("additional_backup_path", "")
+            data.setdefault("backup_interval", 0)
             data.setdefault("secret_mode_enabled", False)
             data.setdefault("clipboard_clear_delay", 45)
 
@@ -85,6 +87,7 @@ class ConfigManager:
     def save_config(self, config: dict) -> None:
         """Encrypt and save configuration."""
         try:
+            config.setdefault("backup_interval", 0)
             self.vault.save_config(config)
         except Exception as exc:
             logger.error(f"Failed to save config: {exc}")
@@ -187,3 +190,16 @@ class ConfigManager:
         """Retrieve clipboard clear delay in seconds."""
         config = self.load_config(require_pin=False)
         return int(config.get("clipboard_clear_delay", 45))
+
+    def set_backup_interval(self, interval: int | float) -> None:
+        """Persist the minimum interval in seconds between automatic backups."""
+        if interval < 0:
+            raise ValueError("Interval cannot be negative")
+        config = self.load_config(require_pin=False)
+        config["backup_interval"] = interval
+        self.save_config(config)
+
+    def get_backup_interval(self) -> float:
+        """Retrieve the backup interval in seconds."""
+        config = self.load_config(require_pin=False)
+        return float(config.get("backup_interval", 0))