Struct Repo 

pub struct Repo { /* private fields */ }

Remote Git repository.

Example

use thin_fetch::{HashKind, Repo};

let url = "https://git.ddd.rip/ptrcnull/thin-fetch.git";
let repo = Repo::new(url, HashKind::Sha1);

// perform an operation on the repo:
let refs = repo.list_refs();

Implementations

impl Repo

pub fn discover(&self) -> Result<Capabilities, Error>

Errors

impl Repo

pub fn fetch_blobs( &self, oid: &str, blobs: Vec<String>, ) -> Result<Vec<Object>, Error>

Fetch listed blobs for a given commit.

Errors

Returns an error if the fetch command or parsing the response fails.

pub fn fetch_tree( &self, have: &str, want: &str, blobs: bool, ) -> Result<Vec<Object>, Error>

Fetch commits between have and want, optionally including blobs.

Errors

Returns an error if the fetch command or parsing the response fails.

pub fn fetch_history_linear( &mut self, start: &str, end: &str, blobs: bool, ) -> Result<Vec<String>, Error>

Fetch commits between have and want, parsing them into a linear history.

Errors

Returns an error if the fetch command fails, cannot parse the response, or the history is not linear.

pub fn fetch_shallow(&mut self, oid: &str) -> Result<(), Error>

Fetch shallow tree for one commit, excluding blobs.

Errors

Returns an error if the fetch command or parsing the response fails.

impl Repo

pub fn get_hash_kind(&self) -> HashKind

pub fn get_blob(&self, oid: &str) -> Option<&Blob>

pub fn get_history_linear<'a>( &'a self, start: &str, end: &str, ) -> Result<Vec<Checkout<'a>>, Error>

Gets linear history of commits between start and end.

Errors

Returns an error when the history is not linear.

impl Repo

pub fn new_discover<S: Into<String>>(url: S) -> Result<Self, Error>

Create new repo with a given URL, discovering the hash kind from the server.

Errors

Returns an error when the remote repo does not support v2 protocol, or does not send object-format in capabilities.

pub fn new<S: Into<String>>(url: S, hash_kind: HashKind) -> Self

Create new repo with a given URL and hash kind.

Assumes that the remote repo does support v2 protocol.

pub fn call<C: Into<Parcel>>(&self, cmd: C) -> Result<Parcel, Error>

Call the repo with a body that serializes into Parcel.

Errors

Returns an error when the HTTP request fails, or the parcel cannot be parsed.

pub fn stream<C: Into<Parcel>>( &self, cmd: C, ) -> Result<ParcelDecoder<BodyReader<'static>>, Error>

Call the repo with a body that serializes into Parcel.

Errors

Returns an error when the HTTP request fails, or the parcel cannot be parsed.

pub fn list_refs(&self) -> Result<Vec<Reference>, Error>

List all remote references.

Errors

Returns an error when the command fails to execute.

pub fn get_ref(&self, needle: &str) -> Result<Option<Reference>, Error>

Get value of single remote ref.

Errors

Returns an error when the command fails to execute.

pub fn list_refs_prefix<P: Into<String>>( &self, prefix: P, ) -> Result<Vec<Reference>, Error>

List all remote references, filtering by a given prefix.

Errors

Returns an error when the command fails to execute.

pub fn objects(&self) -> impl Iterator<Item = &Object>