Struct Client 

pub struct Client { /* private fields */ }

HTTP client for the git-lfs API endpoints.

One instance per LFS endpoint URL. Client is cheap to clone and shares an underlying connection pool — clone freely.

Authentication

Two complementary mechanisms:

• Auth passed at construction is the initial auth — applied to every request, no retries on 401.
• A credential helper attached via Self::with_credential_helper is queried on a 401 response: the request is retried once with the filled-in credentials, and the helper is told approve/reject based on the second attempt’s outcome. Once a fill succeeds, the client remembers the credentials and uses them for subsequent requests, so the 401 dance only happens at most once per process.

Implementations

impl Client

pub async fn batch(&self, req: &BatchRequest) -> Result<BatchResponse, ApiError>

POST /objects/batch to negotiate transfer URLs.

impl Client

pub fn new(endpoint: Url, auth: Auth) -> Self

Build a client rooted at the given LFS endpoint.

endpoint is the LFS server URL (e.g. https://git-server.com/foo/bar.git/info/lfs). Subpaths (/objects/batch, /locks, …) are joined onto it per request.

pub fn with_http_client(endpoint: Url, auth: Auth, http: Client) -> Self

Like new but reuses a caller-supplied reqwest::Client. Useful for sharing a connection pool, custom timeouts, proxies, etc.

pub fn with_credential_helper(self, helper: Arc<dyn Helper>) -> Self

Attach a credential helper. On 401, the client will call helper.fill, retry once with the result, then approve/reject based on the outcome.

impl Client

pub async fn create_lock( &self, req: &CreateLockRequest, ) -> Result<Lock, CreateLockError>

POST /locks to create a new lock.

Body decoding is flexible to accommodate both spec’d 409 → existing lock responses and the reference test server’s “200 with message but no lock” in-band-conflict pattern.

pub async fn list_locks( &self, filter: &ListLocksFilter, ) -> Result<LockList, ApiError>

GET /locks with optional filters.

pub async fn verify_locks( &self, req: &VerifyLocksRequest, ) -> Result<VerifyLocksResponse, ApiError>

POST /locks/verify to list locks partitioned into ours/theirs.

Per the spec, servers that don’t implement locking can return 404 here; that surfaces as ApiError::Status { status: 404, .. }. The caller (typically push) should treat that as “no locks to verify” rather than a hard failure — see is_not_found().

pub async fn delete_lock( &self, id: &str, req: &DeleteLockRequest, ) -> Result<Lock, ApiError>

POST /locks/{id}/unlock to delete a lock.

Trait Implementations

impl Clone for Client

fn clone(&self) -> Client

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Client

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.