Thalweg · API reference ← Main docs

Module client

Module client 

Source
Expand description

The UcClient transport seam: a minimal, transport-agnostic HTTP surface the Unity Catalog backend calls.

Splitting the wire transport behind a trait is what makes the backend’s auth, request-building, and response-parsing logic unit-testable without a live workspace (tests supply a canned-response client) — and lets the real transport be a thin adapter once twg-wire-tls lands, rather than baking a specific HTTP/TLS stack into this crate today.

Structs§

UcHttpError
A transport-level failure (connection, TLS, timeout) — distinct from an HTTP error status, which is carried in a successful UcResponse.
UcRequest
A request the UcClient transport must perform. path is relative to the workspace host, which the concrete client owns (so this crate never carries a URL); query/headers are ordered key/value pairs.
UcResponse
A response from the transport: the HTTP status and the raw body.

Enums§

HttpMethod
HTTP method for a Unity Catalog request. Only the verbs the catalog uses.

Traits§

UcClient
The transport seam. A backend performs HTTP by calling UcClient::send; the concrete implementation owns the workspace host, TLS, and connection pooling.