C-6: ConnectorRuntime enforces capability_mask per operation.
READ-only ACs cannot invoke MUTATE operations (wipe, lock, retire).
C-7: AC validated against database (exists, active, not expired)
before connector invocation.
C-9: Delegated AC capability bounded by delegator's capability.
C-10: Command counter uses atomic SQL increment with limit check.
M-23: expire_stale() uses same atomic SQL pattern.
H-1: Sensitive credential fields hidden from repr/logs via repr=False.
H-2: Stub backend requires ALLOW_STUB_CREDENTIALS=true to activate.
H-3: Kerberos backend raises CredentialResolutionError instead of
returning stub ticket.
H-4: Chronicle INTENT emitted before execution, RESULT after.
H-5: device_id validated as UUID before Graph API URL interpolation.
H-8: ConnectorRuntime enforces governance for all connector invocations.
Signed-off-by: Tyler King <tking@guildhouse.dev>
45 lines
1.1 KiB
Python
45 lines
1.1 KiB
Python
from __future__ import annotations
|
|
|
|
import time
|
|
|
|
|
|
__all__ = ["Deadline"]
|
|
|
|
|
|
class Deadline:
|
|
"""
|
|
Manage timeouts across multiple steps.
|
|
|
|
Args:
|
|
timeout: Time available in seconds or :obj:`None` if there is no limit.
|
|
|
|
"""
|
|
|
|
def __init__(self, timeout: float | None) -> None:
|
|
self.deadline: float | None
|
|
if timeout is None:
|
|
self.deadline = None
|
|
else:
|
|
self.deadline = time.monotonic() + timeout
|
|
|
|
def timeout(self, *, raise_if_elapsed: bool = True) -> float | None:
|
|
"""
|
|
Calculate a timeout from a deadline.
|
|
|
|
Args:
|
|
raise_if_elapsed: Whether to raise :exc:`TimeoutError`
|
|
if the deadline lapsed.
|
|
|
|
Raises:
|
|
TimeoutError: If the deadline lapsed.
|
|
|
|
Returns:
|
|
Time left in seconds or :obj:`None` if there is no limit.
|
|
|
|
"""
|
|
if self.deadline is None:
|
|
return None
|
|
timeout = self.deadline - time.monotonic()
|
|
if raise_if_elapsed and timeout <= 0:
|
|
raise TimeoutError("timed out")
|
|
return timeout
|