pairing.py 1.3 KB

1234567891011121314151617181920212223242526272829
  1. """``hermes pairing`` subcommand parser."""
  2. from __future__ import annotations
  3. from typing import Callable
  4. def build_pairing_parser(subparsers, *, cmd_pairing: Callable) -> None:
  5. """Attach the ``pairing`` subcommand to ``subparsers``."""
  6. pairing_parser = subparsers.add_parser(
  7. "pairing", help="Manage DM pairing codes for user authorization",
  8. description="Approve or revoke user access via pairing codes")
  9. pairing_sub = pairing_parser.add_subparsers(dest="pairing_action")
  10. pairing_sub.add_parser("list", help="Show pending + approved users")
  11. pairing_approve_parser = pairing_sub.add_parser("approve", help="Approve a pairing request")
  12. pairing_approve_parser.add_argument(
  13. "platform", help="Platform name (telegram, discord, slack, whatsapp)")
  14. pairing_approve_parser.add_argument(
  15. "code", metavar="request-id|code",
  16. help="Request ID from 'pairing list', or the code the bot DM'd the user")
  17. pairing_revoke_parser = pairing_sub.add_parser("revoke", help="Revoke user access")
  18. pairing_revoke_parser.add_argument("platform", help="Platform name")
  19. pairing_revoke_parser.add_argument("user_id", help="User ID to revoke")
  20. pairing_sub.add_parser("clear-pending", help="Clear all pending codes")
  21. pairing_parser.set_defaults(func=cmd_pairing)