`pdsx.cli`

general-purpose cli for atproto record operations.

Functions

`describe_exception`

describe_exception(exc: BaseException) -> str

render an exception for the user, never as an empty string. Several atproto SDK exceptions (InvokeTimeoutError among them) carry no message, so interpolating them produced a bare “error:” with nothing after it — a failure the user cannot act on or even name.

`cmd_list`

cmd_list(client: AsyncClient, collection: str, limit: int, repo: str | None = None, cursor: str | None = None, output_format: OutputFormat | None = None) -> None

list records in a collection.

`cmd_describe`

cmd_describe(client: AsyncClient, repo: str, output_format: OutputFormat | None = None) -> None

describe a repo, listing its collections.

`cmd_get`

cmd_get(client: AsyncClient, uri: str, output_format: OutputFormat | None = None, repo: str | None = None) -> None

get a specific record.

`cmd_create`

cmd_create(client: AsyncClient, collection: str, records: list[dict[str, RecordValue]]) -> None

create one or more records.

`cmd_update`

cmd_update(client: AsyncClient, updates_list: list[tuple[str, dict[str, RecordValue]]]) -> None

update one or more records.

`cmd_delete`

cmd_delete(client: AsyncClient, uris: list[str]) -> None

delete one or more records.

`cmd_upload_blob`

cmd_upload_blob(client: AsyncClient, file_path: str) -> None

upload a blob (image, video, etc.).

`cmd_whoami`

cmd_whoami(client: AsyncClient) -> None

show authenticated identity.

`_print_unsupported`

_print_unsupported(exc: PermissionedDataUnsupported) -> None

`cmd_spaces_list`

cmd_spaces_list(client: AsyncClient, pds_url: str) -> int

list permissioned spaces, degrading to an empty result if unsupported. Enumeration has a legitimate empty answer, so an unsupported PDS is reported explicitly and exits 0 rather than failing — but it always says why, so “none” is never silently indistinguishable from “can’t ask”.

`cmd_space_records`

cmd_space_records(client: AsyncClient, pds_url: str) -> int

list records in a permissioned space.

`cmd_space_get`

cmd_space_get(client: AsyncClient, pds_url: str) -> int

get one record from a permissioned space.

`async_main`

async_main() -> int

main entry point.

`main`

main() -> NoReturn

synchronous entry point.

​pdsx.cli

​Functions

​describe_exception

​cmd_list

​cmd_describe

​cmd_get

​cmd_create

​cmd_update

​cmd_delete

​cmd_upload_blob

​cmd_whoami

​_print_unsupported

​cmd_spaces_list

​cmd_space_records

​cmd_space_get

​async_main

​main