Struct LoreBackend 

pub struct LoreBackend { /* private fields */ }

A VcsBackend implementation backed by the Lore VCS CLI (lore(1)).

LoreBackend requires a remote lore:// URL and a workspace identity so that it can call lore repository create / lore clone during init.

Use LoreBackend::new() for the default configuration (reads env-var overrides for the server URL, or falls back to a local-dev default).

Implementations

impl LoreBackend

pub fn new(remote_url: &str, workspace_id: &str) -> Self

Create a new Lore backend.

remote_url should be a lore://host/repository URL. workspace_id scopes the repository to a multi-tenant workspace.

pub fn with_grpc(self, client: LoreGrpcClient) -> Self

Attach a gRPC client for branch-ref synchronisation.

When called, push and pull will use the gRPC client to fetch and advance remote branch tips before / after the CLI blob transfer.

pub fn clone_repo(url: &str, dest: &Path) -> Result<(), NapError>

Clone a remote Lore repository to a local path.

Equivalent to lore clone <url> <dest>. Does NOT require an existing LoreBackend instance — use this when you just want to clone and don’t need a full backend.

pub fn from_env() -> Self

Convenience constructor that reads configuration from environment variables with sensible local-development defaults.

Env var	Default
NAP_LORE_URL_BASE	lore://localhost:8700
NAP_WORKSPACE_ID	default

Trait Implementations

impl Clone for LoreBackend

fn clone(&self) -> LoreBackend

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LoreBackend

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

Formats the value using the given formatter.

impl VcsBackend for LoreBackend

fn init(&self, path: &Path) -> Result<(), NapError>

Initialize a new repository at the given path.

fn commit( &self, path: &Path, message: &str, author: &str, ) -> Result<String, NapError>

Stage all files and create a commit.

fn read_file_at_ref( &self, repo_path: &Path, file_path: &str, reference: Option<&str>, ) -> Result<String, NapError>

Read a file’s content at a specific ref (branch, tag, or commit hash). If reference is None, reads from the current working tree.

fn log( &self, path: &Path, file: Option<&str>, limit: usize, ) -> Result<Vec<CommitInfo>, NapError>

Get the commit log for the repository, optionally filtered to a specific file.

fn create_branch(&self, path: &Path, name: &str) -> Result<(), NapError>

Create a new branch.

fn switch_branch(&self, path: &Path, name: &str) -> Result<(), NapError>

Switch to a branch.

fn current_branch(&self, path: &Path) -> Result<String, NapError>

Get the current branch name.

fn list_branches(&self, path: &Path) -> Result<Vec<String>, NapError>

List all branches.

fn create_tag(&self, path: &Path, name: &str) -> Result<(), NapError>

Create a tag at the current HEAD.

fn list_tags(&self, path: &Path) -> Result<Vec<String>, NapError>

List all tags.

fn head_hash(&self, path: &Path) -> Result<String, NapError>

Get the HEAD commit hash.

fn revert(&self, path: &Path, commit_hash: &str) -> Result<String, NapError>

Revert a commit by creating a new commit that undoes it.

fn resolve_branch_head( &self, path: &Path, branch: &str, ) -> Result<String, NapError>

Resolve the most recent commit hash on a given branch.

fn add_remote(&self, path: &Path, name: &str, url: &str) -> Result<(), NapError>

Add a remote.

fn remove_remote(&self, path: &Path, name: &str) -> Result<(), NapError>

Remove a remote.

fn list_remotes(&self, path: &Path) -> Result<Vec<(String, String)>, NapError>

List remotes as (name, url) pairs.

fn push( &self, path: &Path, remote: Option<&str>, branch: Option<&str>, ) -> Result<(), NapError>

Push the current branch to its upstream / a named remote.

fn pull( &self, path: &Path, remote: Option<&str>, branch: Option<&str>, ) -> Result<(), NapError>

Pull the current branch from its upstream / a named remote.