Coverage for src / lexigram / contracts / admin / pii_redactor.py: 100%

1"""PiiRedactorProtocol — field-name and pattern-based PII redaction.""" 

2 

3from __future__ import annotations 

4 

5from typing import Any, Protocol, runtime_checkable 

6 

7 

8@runtime_checkable 

9class PiiRedactorProtocol(Protocol): 

10 """Protocol for PII redaction on audit payloads. 

11 

12 Implementations redact sensitive fields (by field name or pattern 

13 matching) from ``dict`` payloads before they are persisted. 

14 """ 

15 

16 def redact(self, payload: dict[str, Any]) -> dict[str, Any]: 

17 """Return a redacted copy of *payload*. 

18 

19 Sensitive values are replaced with ``"<redacted>"``. 

20 The original dict is not mutated. 

21 """ 

22 ... 

23 

24 

25__all__ = ["PiiRedactorProtocol"]