e744336385
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>
36 lines
943 B
Python
36 lines
943 B
Python
from __future__ import annotations
|
|
|
|
import enum
|
|
import typing as t
|
|
|
|
|
|
class Sentinel(enum.Enum):
|
|
"""Enum used to define sentinel values.
|
|
|
|
.. seealso::
|
|
|
|
`PEP 661 - Sentinel Values <https://peps.python.org/pep-0661/>`_.
|
|
"""
|
|
|
|
UNSET = object()
|
|
FLAG_NEEDS_VALUE = object()
|
|
|
|
def __repr__(self) -> str:
|
|
return f"{self.__class__.__name__}.{self.name}"
|
|
|
|
|
|
UNSET = Sentinel.UNSET
|
|
"""Sentinel used to indicate that a value is not set."""
|
|
|
|
FLAG_NEEDS_VALUE = Sentinel.FLAG_NEEDS_VALUE
|
|
"""Sentinel used to indicate an option was passed as a flag without a
|
|
value but is not a flag option.
|
|
|
|
``Option.consume_value`` uses this to prompt or use the ``flag_value``.
|
|
"""
|
|
|
|
T_UNSET = t.Literal[UNSET] # type: ignore[valid-type]
|
|
"""Type hint for the :data:`UNSET` sentinel value."""
|
|
|
|
T_FLAG_NEEDS_VALUE = t.Literal[FLAG_NEEDS_VALUE] # type: ignore[valid-type]
|
|
"""Type hint for the :data:`FLAG_NEEDS_VALUE` sentinel value."""
|