plugg 0.0.0__py3-none-any.whl

plugg/__init__.py

@@ -0,0 +1,21 @@
+from .core import (
+    AuthAdapter,
+    AuthError,
+    AuthErrorCode,
+    Principal,
+    PrincipalKind,
+    canonicalize_principal,
+    is_auth_error,
+    principal_to_json,
+)
+
+__all__ = [
+    "AuthAdapter",
+    "AuthError",
+    "AuthErrorCode",
+    "Principal",
+    "PrincipalKind",
+    "canonicalize_principal",
+    "is_auth_error",
+    "principal_to_json",
+]

plugg/core.py

@@ -0,0 +1,39 @@
+from __future__ import annotations
+
+import json
+from typing import Any, Literal, Protocol, TypedDict
+
+PrincipalKind = Literal["user", "agent", "service"]
+AuthErrorCode = Literal["invalid_credential", "expired_credential", "unavailable"]
+
+
+class Principal(TypedDict):
+    id: str
+    kind: str
+    claims: dict[str, Any]
+
+
+class AuthAdapter(Protocol):
+    async def resolve(self, credential: str) -> Principal: ...
+
+
+class AuthError(Exception):
+    def __init__(self, code: AuthErrorCode, message: str) -> None:
+        super().__init__(message)
+        self.code = code
+
+
+def principal_to_json(principal: Principal) -> Principal:
+    return {
+        "id": principal["id"],
+        "kind": principal["kind"],
+        "claims": principal["claims"],
+    }
+
+
+def canonicalize_principal(principal: Principal) -> str:
+    return json.dumps(principal_to_json(principal), sort_keys=True, separators=(",", ":"))
+
+
+def is_auth_error(error: BaseException) -> bool:
+    return isinstance(error, AuthError)

plugg-0.0.0.dist-info/METADATA

@@ -0,0 +1,44 @@
+Metadata-Version: 2.4
+Name: plugg
+Version: 0.0.0
+Summary: Neutral authentication port for agent-fabric primitives: resolves opaque credentials into fabric principals.
+Project-URL: Homepage, https://github.com/cachetronaut/plugg
+Project-URL: Repository, https://github.com/cachetronaut/plugg
+Project-URL: Issues, https://github.com/cachetronaut/plugg/issues
+License: MIT
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+
+# plugg
+
+Python implementation of Plugg.
+
+For product-level context, shared contracts, and cross-language repository information, see the public repository: https://github.com/cachetronaut/plugg.
+
+## Install
+
+```sh
+pip install plugg
+```
+
+## Import
+
+```python
+import plugg
+```
+
+## Development
+
+Run from `py/`:
+
+```sh
+uv sync --dev
+uv run --with ruff ruff check .
+uv run --with ruff ruff format --check .
+uv run --with ty ty check
+uv run --with pytest --with pytest-asyncio python -m pytest
+```
+
+## License
+
+MIT

plugg-0.0.0.dist-info/RECORD

@@ -0,0 +1,5 @@
+plugg/__init__.py,sha256=u22H155PvSnc_eOcymGwRaI3U2ko1EVVhoHKbWAvQ7c,363
+plugg/core.py,sha256=CcK33WkzVucyABakccGqaR14umPu1d1ovp5FoMmrT80,995
+plugg-0.0.0.dist-info/METADATA,sha256=746P3-vMgJkdwMOC8OquZY1ACf3aOHHyytkVq3agcY8,945
+plugg-0.0.0.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+plugg-0.0.0.dist-info/RECORD,,

plugg-0.0.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.30.1
+Root-Is-Purelib: true
+Tag: py3-none-any