Struct git_repository::ThreadSafeRepository

pub struct ThreadSafeRepository {
    pub refs: RefStore,
    pub objects: OwnShared<Store>,
    pub work_tree: Option<PathBuf>,
    /* private fields */
}

An instance with access to everything a git repository entails, best imagined as container implementing Sync + Send for most for system resources required to interact with a git repository which are loaded in once the instance is created.

Use this type to reference it in a threaded context for creation the creation of a thread-local Repositories.

Note that this type purposefully isn’t very useful until it is converted into a thread-local repository with to_thread_local(), it’s merely meant to be able to exist in a Sync context.

Fields

refs: RefStore

A store for references to point at objects

objects: OwnShared<Store>

A store for objects that contain data

work_tree: Option<PathBuf>

The path to the worktree at which to find checked out files

Implementations

impl ThreadSafeRepository

pub fn kind(&self) -> Kind

Return the kind of repository, either bare or one with a work tree.

pub fn to_thread_local(&self) -> Repository

Add thread-local state to an easy-to-use thread-local repository for the most convenient API.

impl ThreadSafeRepository

pub fn path(&self) -> &Path

The path to the .git directory itself, or equivalent if this is a bare repository.

pub fn git_dir(&self) -> &Path

Return the path to the repository itself, containing objects, references, configuration, and more.

Synonymous to path().

pub fn workdir(&self) -> Option<&Path>

Return the path to the working directory if this is not a bare repository.

pub fn objects_dir(&self) -> &Path

Return the path to the directory containing all objects.

impl ThreadSafeRepository

pub fn open(path: impl Into<PathBuf>) -> Result<Self, Error>

Open a git repository at the given path, possibly expanding it to path/.git if path is a work tree dir.

impl ThreadSafeRepository

pub fn init(directory: impl AsRef<Path>, kind: Kind) -> Result<Self, Error>

Create a repository with work-tree within directory, creating intermediate directories as needed.

Fails without action if there is already a .git repository inside of directory, but won’t mind if the directory otherwise is non-empty.

impl ThreadSafeRepository

pub fn discover(directory: impl AsRef<Path>) -> Result<Self, Error>

Try to open a git repository in directory and search upwards through its parents until one is found.

Trait Implementations

impl Debug for ThreadSafeRepository

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

Formats the value using the given formatter.

impl From<&'_ ThreadSafeRepository> for Repository

fn from(repo: &ThreadSafeRepository) -> Self

Converts to this type from the input type.

impl From<Repository> for ThreadSafeRepository

fn from(r: Repository) -> Self

Converts to this type from the input type.

impl From<ThreadSafeRepository> for Repository

fn from(repo: ThreadSafeRepository) -> Self

Converts to this type from the input type.

impl PartialEq<ThreadSafeRepository> for ThreadSafeRepository

fn eq(&self, other: &ThreadSafeRepository) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl TryFrom<Path> for ThreadSafeRepository

type Error = Error

The type returned in the event of a conversion error.

fn try_from(value: Path) -> Result<Self, Self::Error>

Performs the conversion.