xa.hosts.http

HTTP host — a remote xa serve instance.

The remote must be running xa serve (or an API with the same /sessions + /archive surface) and be reachable over HTTPS. All discovery and actions are performed through the API; no SSH keys, no rsync. Auth is pluggable:

  • auth="basic" → HTTP Basic with username / password

  • auth="bearer" → Authorization: Bearer <token>

  • auth=None → no auth (host is already gated upstream)

urllib is used for transport so there’s no hard dep on httpx or requests; xa.hosts.http works in any Python 3.10+ install.

Classes

HTTPHost(name, *, base_url[, auth, ...])

Client for a remote xa serve instance.
class xa.hosts.http.HTTPHost(name, *, base_url, auth=None, username=None, password=None, token=None, timeout=30.0)[source]

Bases: object

Client for a remote xa serve instance.

sync(*, force=False)[source]

HTTP sessions are fetched fresh on each listing — no separate sync.

Return type:

None