Struct LoreGrpcClient 

pub struct LoreGrpcClient { /* private fields */ }

A gRPC client for lore-server’s RevisionService.

This client handles only lightweight metadata operations:

Operation	RPC	Purpose
get_branch_by_name	BranchGet	Fetch remote branch tip before pull
push_branch	BranchPush	Advance remote branch tip after push

Blob transfer (the heavy payload) remains on the lore CLI / HTTP.

Implementations

impl LoreGrpcClient

pub fn builder() -> Builder

Return a builder for fine-grained configuration.

pub fn for_repository_id(&self, id: impl Into<Vec<u8>>) -> Self

Return a clone scoped to a repository returned by RepositoryGet.

pub async fn get_branch_by_name(&self, name: &str) -> Result<Branch, NapError>

Look up a branch by its human-readable name.

Returns the Branch record containing id (binary UUID), name, latest (tip signature), and other metadata.

pub async fn list_branches(&self) -> Result<Vec<Branch>, NapError>

pub async fn list_revisions( &self, identifier: RevisionIdentifier, ) -> Result<Vec<RevisionItem>, NapError>

pub async fn push_branch( &self, branch_id: Bytes, revision_signature: Bytes, force: bool, ) -> Result<(), NapError>

Push a revision as the new tip of a branch.

• branch_id — binary branch UUID (obtained from [get_branch_by_name]).
• revision_signature — raw content hash of the revision to set as the new tip.
• force — if true, bypasses fast-forward checks on the server. When false, the server requires the new tip to descend from the current tip (or performs a fast-forward merge).

pub fn builder_from_env() -> Result<Option<Self>, NapError>

Convenience constructor that reads all configuration from environment variables. Returns Ok(None) when NAP_LORE_GRPC_ENDPOINT is not set, allowing callers to gracefully skip gRPC integration.

See Builder::from_env for the list of recognised variables.

pub async fn get_repository_by_name( &self, name: &str, ) -> Result<Repository, NapError>

Look up a repository before constructing a repository-scoped client.

pub async fn list_repositories(&self) -> Result<Vec<String>, NapError>

Return names of repositories visible to the current identity.

pub async fn read_file_at_revision( &self, identifier: RevisionIdentifier, path: String, ) -> Result<(Vec<u8>, Vec<u8>), NapError>

Read a single file at a revision tree path. The caller must scope this client with the repository id returned by RepositoryGet.

pub async fn read_file_at_signature( &self, signature: Vec<u8>, path: String, ) -> Result<(Vec<u8>, Vec<u8>), NapError>

Read a file selected by its immutable Lore revision signature.

pub async fn list_paths_at_revision( &self, identifier: RevisionIdentifier, prefix: String, ) -> Result<Vec<String>, NapError>

List file paths below a revision tree prefix without downloading them.

pub async fn file_address_at_revision( &self, identifier: RevisionIdentifier, path: String, ) -> Result<(Address, Vec<u8>), NapError>

Look up a file’s content address without downloading its payload.

pub async fn revision_info_at_signature( &self, signature: Vec<u8>, ) -> Result<Revision, NapError>

Trait Implementations

impl Clone for LoreGrpcClient

fn clone(&self) -> LoreGrpcClient

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LoreGrpcClient

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

Formats the value using the given formatter.