Enum RemoteRepo 

pub enum RemoteRepo {
    File {
        path: PathBuf,
    },
    Http {
        base_url: String,
        token: Option<String>,
    },
    Ssh {
        pipe: RefCell<SshPipe>,
    },
    Lit {
        conn: RefCell<LitConnection>,
    },
}

A remote repository that can be accessed via filesystem, HTTP, SSH, or lit://

Variants

File

Fields

path: PathBuf

Http

Fields

base_url: String

token: Option<String>

Ssh

Fields

pipe: RefCell<SshPipe>

Lit

Fields

conn: RefCell<LitConnection>

Implementations

impl RemoteRepo

pub fn open(url: &str) -> Result<Self, String>

Create a RemoteRepo from a URL, auto-detecting transport type

pub fn list_refs(&self, kind: &str) -> Result<Vec<RemoteRef>, String>

List refs (branches and/or tags) on the remote

pub fn list_branches(&self) -> Result<Vec<(String, String)>, String>

List branches on the remote (convenience method)

pub fn read_branch_ref(&self, branch: &str) -> Result<String, String>

Read a branch ref on the remote

pub fn read_head(&self) -> Result<String, String>

Read HEAD from the remote

pub fn update_branch_ref( &self, branch: &str, hash: &str, force: bool, ) -> Result<(), String>

Update a branch ref on the remote

pub fn negotiate_download( &self, local_store: &ObjectStore, wants: &[String], ) -> Result<Vec<ObjectHash>, String>

Negotiate which objects need to be transferred (returns hashes of needed objects)

pub fn download_objects( &self, local_store: &ObjectStore, hashes: &[ObjectHash], ) -> Result<usize, String>

Download objects from remote into local store

pub fn upload_objects( &self, local_store: &ObjectStore, hashes: &[ObjectHash], ) -> Result<usize, String>

Upload objects from local store to remote

pub fn negotiate_upload( &self, local_store: &ObjectStore, wants: &[String], remote_has: &HashSet<String>, ) -> Result<Vec<ObjectHash>, String>

Negotiate which objects need to be uploaded (walk local graph, exclude known remote objects)

pub fn check_fast_forward( &self, local_store: &ObjectStore, new_hash: &ObjectHash, old_hash: &ObjectHash, ) -> Result<bool, String>

Check if a push would be fast-forward