Merge pull request #137 from auths-dev/dev-pythonSdkCleaning

bordumb · web-flow · commit 8cabd4c4abd8 · 2026-04-03T02:34:59.000+01:00
refactor: simplify python sdk for launch, docstrings
diff --git a/packages/auths-python/python/auths/__init__.py b/packages/auths-python/python/auths/__init__.py
@@ -66,82 +66,18 @@
 )
 
 __all__ = [
+    # Core verification (the launch use case)
+    "verify_attestation",
+    "verify_chain",
+    "VerificationResult",
+    "VerificationReport",
+    "VerificationError",
+
+    # Client
     "Auths",
+
+    # Common types users will encounter
     "AuthsError",
-    "VerificationError",
-    "CryptoError",
-    "KeychainError",
-    "StorageError",
-    "NetworkError",
-    "IdentityError",
-    "VerificationResult",
-    "VerificationStatus",
     "ChainLink",
-    "VerificationReport",
-    "verify_at_time",
-    "verify_at_time_with_capability",
-    "verify_attestation",
-    "verify_chain",
-    "verify_attestation_with_capability",
-    "verify_chain_with_capability",
-    "verify_chain_with_witnesses",
-    "verify_device_authorization",
-    "sign_bytes",
-    "sign_action",
-    "verify_action_envelope",
-    "get_token",
-    "AgentAuth",
-    "ArtifactPublishResult",
-    "ArtifactSigningResult",
-    "Attestation",
-    "AttestationService",
-    "CommitSigningResult",
-    "AuthsClaims",
-    "Outcome",
-    "PolicyBuilder",
-    "ReasonCode",
-    "eval_context_from_commit_result",
-    "compile_policy",
-    "parse_identity_bundle",
-    "parse_identity_bundle_info",
-    "IdentityBundleInfo",
-    "TrustLevel",
-    "CommitResult",
-    "ErrorCode",
-    "VerifyResult",
-    "LayoutInfo",
-    "LayoutError",
-    "discover_layout",
-    "generate_allowed_signers",
-    "verify_commit_range",
-    "Identity",
-    "AgentIdentity",
-    "DelegatedAgent",
-    "IdentityService",
-    "Device",
-    "DeviceExtension",
-    "DeviceService",
-    "IdentityRotationResult",
-    "WitnessConfig",
-    "WitnessKey",
-    "Org",
-    "OrgMember",
-    "OrgService",
-    "OrgError",
-    "AuditReport",
-    "AuditService",
-    "AuditSummary",
-    "CommitRecord",
-    "TrustEntry",
-    "TrustService",
-    "Witness",
-    "WitnessService",
-    "Check",
-    "DiagnosticReport",
-    "DoctorService",
-    "PairingResponse",
-    "PairingResult",
-    "PairingService",
-    "PairingSession",
-    "PairingError",
+    "VerificationStatus",
 ]
diff --git a/packages/auths-python/python/auths/audit.py b/packages/auths-python/python/auths/audit.py
@@ -1,3 +1,4 @@
+"""Audit reports and commit history analysis."""
 from __future__ import annotations
 
 import json
diff --git a/packages/auths-python/python/auths/doctor.py b/packages/auths-python/python/auths/doctor.py
@@ -1,3 +1,4 @@
+"""Diagnostic checks for identity and signing health."""
 from __future__ import annotations
 
 import json
diff --git a/packages/auths-python/python/auths/org.py b/packages/auths-python/python/auths/org.py
@@ -1,3 +1,4 @@
+"""Organization management — Stripe-style API."""
 from __future__ import annotations
 
 import json
diff --git a/packages/auths-python/python/auths/pairing.py b/packages/auths-python/python/auths/pairing.py
@@ -1,3 +1,4 @@
+"""Device pairing sessions — Stripe-style API."""
 from __future__ import annotations
 
 import json
diff --git a/packages/auths-python/python/auths/trust.py b/packages/auths-python/python/auths/trust.py
@@ -1,3 +1,4 @@
+"""Trust pinning and identity verification levels."""
 from __future__ import annotations
 
 import enum
diff --git a/packages/auths-python/python/auths/witness.py b/packages/auths-python/python/auths/witness.py
@@ -1,3 +1,4 @@
+"""Witness management for attestation countersigning."""
 from __future__ import annotations
 
 import json

Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,4 @@`
	`1`	`+"""Audit reports and commit history analysis."""`
`1`	`2`	`from __future__ import annotations`
`2`	`3`
`3`	`4`	`import json`
Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,4 @@`
	`1`	`+"""Diagnostic checks for identity and signing health."""`
`1`	`2`	`from __future__ import annotations`
`2`	`3`
`3`	`4`	`import json`
Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,4 @@`
	`1`	`+"""Organization management — Stripe-style API."""`
`1`	`2`	`from __future__ import annotations`
`2`	`3`
`3`	`4`	`import json`
Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,4 @@`
	`1`	`+"""Device pairing sessions — Stripe-style API."""`
`1`	`2`	`from __future__ import annotations`
`2`	`3`
`3`	`4`	`import json`
Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,4 @@`
	`1`	`+"""Trust pinning and identity verification levels."""`
`1`	`2`	`from __future__ import annotations`
`2`	`3`
`3`	`4`	`import enum`
Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,4 @@`
	`1`	`+"""Witness management for attestation countersigning."""`
`1`	`2`	`from __future__ import annotations`
`2`	`3`
`3`	`4`	`import json`