Struct tvix_store::proto::path_info_service_client::PathInfoServiceClient

pub struct PathInfoServiceClient<T> {
    inner: Grpc<T>,
}

Fields

inner: Grpc<T>

Implementations

impl PathInfoServiceClient<Channel>

pub async fn connect<D>(dst: D) -> Result<Self, Error>

where D: TryInto<Endpoint>, D::Error: Into<StdError>,

Attempt to create a new client by connecting to a given endpoint.

impl<T> PathInfoServiceClient<T>

where T: GrpcService<BoxBody>, T::Error: Into<StdError>, T::ResponseBody: Body<Data = Bytes> + Send + 'static, <T::ResponseBody as Body>::Error: Into<StdError> + Send,

pub fn new(inner: T) -> Self

pub fn with_origin(inner: T, origin: Uri) -> Self

pub fn with_interceptor<F>( inner: T, interceptor: F, ) -> PathInfoServiceClient<InterceptedService<T, F>>

where F: Interceptor, T::ResponseBody: Default, T: Service<Request<BoxBody>, Response = Response<<T as GrpcService<BoxBody>>::ResponseBody>>, <T as Service<Request<BoxBody>>>::Error: Into<StdError> + Send + Sync,

pub fn send_compressed(self, encoding: CompressionEncoding) -> Self

Compress requests with the given encoding.

This requires the server to support it otherwise it might respond with an error.

pub fn accept_compressed(self, encoding: CompressionEncoding) -> Self

Enable decompressing responses.

pub fn max_decoding_message_size(self, limit: usize) -> Self

Limits the maximum size of a decoded message.

Default: 4MB

pub fn max_encoding_message_size(self, limit: usize) -> Self

Limits the maximum size of an encoded message.

Default: usize::MAX

pub async fn get( &mut self, request: impl IntoRequest<GetPathInfoRequest>, ) -> Result<Response<PathInfo>, Status>

Return a PathInfo message matching the criteria specified in the GetPathInfoRequest message.

pub async fn put( &mut self, request: impl IntoRequest<PathInfo>, ) -> Result<Response<PathInfo>, Status>

Upload a PathInfo object to the remote end. It MUST not return until the PathInfo object has been written on the the remote end.

The remote end MAY check if a potential DirectoryNode has already been uploaded.

Uploading clients SHOULD obviously not steer other machines to try to substitute before from the remote end before having finished uploading PathInfo, Directories and Blobs. The returned PathInfo object MAY contain additional narinfo signatures, but is otherwise left untouched.

pub async fn calculate_nar( &mut self, request: impl IntoRequest<Node>, ) -> Result<Response<CalculateNarResponse>, Status>

Calculate the NAR representation of the contents specified by the root_node. The calculation SHOULD be cached server-side for subsequent requests.

All references (to blobs or Directory messages) MUST already exist in the store.

The method can be used to produce a Nix fixed-output path, which contains the (compressed) sha256 of the NAR content representation in the root_node name (suffixed with the name).

It can also be used to calculate arbitrary NAR hashes of output paths, in case a legacy Nix Binary Cache frontend is provided.

pub async fn list( &mut self, request: impl IntoRequest<ListPathInfoRequest>, ) -> Result<Response<Streaming<PathInfo>>, Status>

Return a stream of PathInfo messages matching the criteria specified in ListPathInfoRequest.

Trait Implementations

impl<T: Clone> Clone for PathInfoServiceClient<T>

fn clone(&self) -> PathInfoServiceClient<T>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T: Debug> Debug for PathInfoServiceClient<T>

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

Formats the value using the given formatter.