Struct RemoteRepo 

pub struct RemoteRepo {
    pub url: String,
    pub provider: GitProvider,
    pub owner: Option<String>,
    pub name: String,
    pub branch: Option<String>,
    pub reference: Option<String>,
    pub subdir: Option<String>,
}

Parsed remote repository URL

Fields

url: String

Original URL

provider: GitProvider

Git provider

owner: Option<String>

Repository owner/organization

name: String

Repository name

branch: Option<String>

Branch to clone (None = default branch)

reference: Option<String>

Specific commit/tag to checkout

subdir: Option<String>

Subdirectory to extract (sparse checkout)

Implementations

impl RemoteRepo

pub fn parse(input: &str) -> Result<Self, RemoteError>

Parse a remote URL into a RemoteRepo Supports formats:

• https://github.com/owner/repo
• https://github.com/owner/repo/tree/branch
• https://github.com/owner/repo/tree/branch/subdir
• github:owner/repo
• owner/repo (assumes GitHub)
• git@github.com:owner/repo.git

pub fn clone_with_cleanup(&self) -> Result<(PathBuf, TempDir), RemoteError>

Clone the repository to a temporary directory with RAII cleanup Returns (path_to_repo, temp_dir_handle) - keep the TempDir alive to prevent cleanup

pub fn clone(&self, target_dir: Option<&Path>) -> Result<PathBuf, RemoteError>

Clone the repository to a temporary directory (legacy method without RAII cleanup)

Warning

This method does not clean up the temp directory automatically. Consider using clone_with_cleanup() instead for automatic cleanup.

Public API Note

This method is part of the public library API for users who need manual control over the cloned directory lifecycle. The CLI uses clone_with_cleanup() internally.

pub fn sparse_clone( &self, paths: &[&str], target_dir: Option<&Path>, ) -> Result<PathBuf, RemoteError>

Clone with sparse checkout (only fetch specified paths)

This is useful for very large repositories where you only need a subset of files. Uses Git’s sparse checkout feature to minimize download size.

Safety

Will only delete existing directories if:

• The directory is inside system temp directory, OR
• The directory contains an .infiniloom-clone marker file, OR
• The directory is empty

Public API Note

This method is part of the public library API. The CLI does not currently use sparse checkout, but it’s available for library users who need it.

pub fn is_remote_url(input: &str) -> bool

Check if a URL is a remote repository URL

Trait Implementations

impl Clone for RemoteRepo

fn clone(&self) -> RemoteRepo

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RemoteRepo

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

Formats the value using the given formatter.