| 1234567891011121314151617181920212223242526272829303132333435 |
- """``hermes backup`` subcommand parser."""
- from __future__ import annotations
- from argparse import ArgumentTypeError
- from typing import Callable
- def _non_negative_keep(value: str) -> int:
- # A negative keep would slice away the NEWEST archives instead of the oldest.
- if not value.isdecimal():
- raise ArgumentTypeError("must be a non-negative integer (0 keeps everything)")
- return int(value)
- def build_backup_parser(subparsers, *, cmd_backup: Callable) -> None:
- """Attach the ``backup`` subcommand to ``subparsers``."""
- backup_parser = subparsers.add_parser(
- "backup", help="Back up Hermes home directory to a zip file",
- description="Create a zip archive of your entire Hermes configuration, "
- "skills, sessions, and data (excludes the hermes-agent codebase). "
- "Use --quick for a fast snapshot of just critical state files.")
- backup_parser.add_argument(
- "-o",
- "--output", help="Output path for the zip file (default: ~/hermes-backup-<timestamp>.zip)")
- backup_parser.add_argument(
- "-q", "--quick", action="store_true",
- help="Quick snapshot: only critical state files (config, state.db, .env, auth, cron)")
- backup_parser.add_argument(
- "-l", "--label", help="Label for the snapshot (only used with --quick)")
- backup_parser.add_argument(
- "-k", "--keep", type=_non_negative_keep, default=3, metavar="N",
- help="After a full backup, delete older hermes-backup-*.zip files in the output "
- "directory beyond the newest N (default 3; 0 keeps everything)")
- backup_parser.set_defaults(func=cmd_backup)
|