Struct git_repository::remote::Connection

pub struct Connection<'a, 'repo, T, P> { /* private fields */ }

Available on crate features async-network-client or blocking-network-client only.

A type to represent an ongoing connection to a remote host, typically with the connection already established.

It can be used to perform a variety of operations with the remote without worrying about protocol details, much like a remote procedure call.

Implementations

impl<'a, 'repo, T, P> Connection<'a, 'repo, T, P>

Access

pub fn remote(&self) -> &Remote<'repo>

Drop the transport and additional state to regain the original remote.

impl<'a, 'repo, T, P> Connection<'a, 'repo, T, P> where
    T: Transport,
    P: Progress, 

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

List all references on the remote.

Note that this doesn’t fetch the objects mentioned in the tips nor does it make any change to underlying repository.

pub fn list_refs_by_refspec(&mut self, _direction: Direction) -> !

List all references on the remote that have been filtered through our remote’s refspecs for fetching or pushing depending on direction.

This comes in the form of information of all matching tips on the remote and the object they point to, along with with the local tracking branch of these tips (if available).

Note that this doesn’t fetch the objects mentioned in the tips nor does it make any change to underlying repository.