Skip to main content

pdsx._internal.resolution

PDS and URI resolution utilities.

Functions

discover_pds

discover_pds(repo: str) -> str
discover PDS URL from handle or DID. Args:
  • repo: handle (e.g., ‘zzstoatzz.io’) or DID (e.g., ‘did:plc:…’)
Returns: Raises:
  • ValueError: if handle cannot be resolved or PDS not found

Classes

URIParts

parsed components of an AT-URI. Methods:

from_uri

from_uri(cls, uri: str, client_did: str | None = None) -> URIParts
parse an AT-URI into its components. Args:
  • uri: either full AT-URI (at://did/collection/rkey) or shorthand (collection/rkey)
  • client_did: authenticated user’s DID (required for shorthand format)
Returns:
  • URIParts with repo, collection, and rkey
Raises:
  • ValueError: if URI format is invalid or shorthand used without authentication