Struct GitRepository 

pub struct GitRepository {
    pub proc: Option<Arc<DaggerSessionProc>>,
    pub selection: Selection,
    pub graphql_client: DynGraphQLClient,
}

Fields

proc: Option<Arc<DaggerSessionProc>>

selection: Selection

graphql_client: DynGraphQLClient

Implementations

impl GitRepository

pub fn as_workspace(&self) -> Workspace

Creates a synthetic workspace from this repository’s HEAD and uncommitted file changes. Pending changes are applied at the repository root. The staging split is not preserved. The source repository is not modified.

Arguments

• opt - optional argument, see inner type for documentation, use _opts to use

pub fn as_workspace_opts<'a>( &self, opts: GitRepositoryAsWorkspaceOpts<'a>, ) -> Workspace

Creates a synthetic workspace from this repository’s HEAD and uncommitted file changes. Pending changes are applied at the repository root. The staging split is not preserved. The source repository is not modified.

Arguments

• opt - optional argument, see inner type for documentation, use _opts to use

pub fn branch(&self, name: impl Into<String>) -> GitRef

Returns details of a branch.

Arguments

• name - Branch’s name (e.g., “main”).

pub async fn branches(&self) -> Result<Vec<String>, DaggerError>

branches that match any of the given glob patterns.

Arguments

• opt - optional argument, see inner type for documentation, use _opts to use

pub async fn branches_opts<'a>( &self, opts: GitRepositoryBranchesOpts<'a>, ) -> Result<Vec<String>, DaggerError>

branches that match any of the given glob patterns.

Arguments

• opt - optional argument, see inner type for documentation, use _opts to use

pub fn bundle(&self, refs: Vec<impl Into<String>>) -> GitBundle

Pack the given refs and the objects needed to reconstruct them into a Git bundle.

Arguments

• refs - Refs to advertise in the bundle. At least one named ref is required.
• opt - optional argument, see inner type for documentation, use _opts to use

pub fn bundle_opts( &self, refs: Vec<impl Into<String>>, opts: GitRepositoryBundleOpts, ) -> GitBundle

Pack the given refs and the objects needed to reconstruct them into a Git bundle.

Arguments

• refs - Refs to advertise in the bundle. At least one named ref is required.
• opt - optional argument, see inner type for documentation, use _opts to use

pub fn commit(&self, id: impl Into<String>) -> GitCommit

Returns details of a commit.

Arguments

• id - Identifier of the commit (e.g., “b6315d8f2810962c601af73f86831f6866ea798b”).

May be abbreviated to an unambiguous hex prefix (4-40 characters), which is expanded against locally available objects. Remote repositories (resolved via ls-remote) can only expand prefixes of already-fetched commits; use the full SHA otherwise.

pub fn head(&self) -> GitRef

Returns details for HEAD.

pub async fn id(&self) -> Result<Id, DaggerError>

A unique identifier for this GitRepository.

pub fn latest(&self) -> GitRef

Return the latest stable release tag, falling back to HEAD when no release exists. Release selection accepts an optional “v” prefix, incomplete versions, and zero-padded numeric components. This operation is pinned.

Arguments

• opt - optional argument, see inner type for documentation, use _opts to use

pub fn latest_opts<'a>(&self, opts: GitRepositoryLatestOpts<'a>) -> GitRef

Return the latest stable release tag, falling back to HEAD when no release exists. Release selection accepts an optional “v” prefix, incomplete versions, and zero-padded numeric components. This operation is pinned.

Arguments

• opt - optional argument, see inner type for documentation, use _opts to use

pub fn ref(&self, name: impl Into<String>) -> GitRef

Returns details of a ref.

Arguments

• name - Ref’s name (can be a commit identifier, a tag name, a branch name, or a fully-qualified ref).

Commit identifiers may be abbreviated: an unambiguous hex prefix (4-40 characters) of a commit SHA resolves like git rev-parse, with named refs taking precedence. Abbreviated SHAs resolve against locally available objects, so remote repositories (resolved via ls-remote) can only expand prefixes of already-fetched commits; use the full SHA or a named ref otherwise.

pub fn tag(&self, name: impl Into<String>) -> GitRef

Returns details of a tag.

Arguments

• name - Tag’s name (e.g., “v0.3.9”).

pub async fn tags(&self) -> Result<Vec<String>, DaggerError>

tags that match any of the given glob patterns.

Arguments

• opt - optional argument, see inner type for documentation, use _opts to use

pub async fn tags_opts<'a>( &self, opts: GitRepositoryTagsOpts<'a>, ) -> Result<Vec<String>, DaggerError>

tags that match any of the given glob patterns.

Arguments

• opt - optional argument, see inner type for documentation, use _opts to use

pub fn uncommitted(&self) -> Changeset

Returns the changeset of uncommitted changes in the git repository.

pub async fn url(&self) -> Result<String, DaggerError>

The URL of the git repository.

pub fn with_bundle(&self, bundle: impl IntoID<Id>) -> GitRepository

Import a Git bundle after fetching and verifying all of its prerequisites.

Arguments

• bundle - The Git bundle to import.
• opt - optional argument, see inner type for documentation, use _opts to use

pub fn with_bundle_opts<'a>( &self, bundle: impl IntoID<Id>, opts: GitRepositoryWithBundleOpts<'a>, ) -> GitRepository

Import a Git bundle after fetching and verifying all of its prerequisites.

Arguments

• bundle - The Git bundle to import.
• opt - optional argument, see inner type for documentation, use _opts to use

pub fn with_contents(&self, directory: impl IntoID<Id>) -> GitRepository

Replace this repository’s storage with the supplied self-contained Git repository, retaining its logical URL and push destinations. Accepts a whole checkout (including .git and pending file edits), .git contents, or a bare repository. Does not initialize a repository, merge histories, or modify either input. The receiver’s logical routing wins over the supplied Git configuration; that configuration is not rewritten. Use Directory.asGit to open the supplied repository without retaining the receiver’s routing.

Arguments

• directory - Existing Git storage to open. Git metadata and object dependencies must be contained in this directory.

pub fn with_remote( &self, name: impl Into<String>, url: impl Into<String>, ) -> GitRepository

Register a named remote on this repository, replacing any registered remote of the same name. Registered remotes are recorded in checkouts materialized from this repository (GitRef.tree, Workspace.git.directory), so remote-aware tooling like gh can resolve and fetch from them. The origin remote also routes push when no explicit destination is passed: its push URL, or its URL, becomes the default destination. Routing metadata only, never a credential grant: pushes still authenticate with the caller’s own credentials and require approval as usual.

Arguments

• name - The remote’s name, e.g. “origin” or “upstream”.
• url - The remote’s fetch URL.
• opt - optional argument, see inner type for documentation, use _opts to use

pub fn with_remote_opts<'a>( &self, name: impl Into<String>, url: impl Into<String>, opts: GitRepositoryWithRemoteOpts<'a>, ) -> GitRepository

Register a named remote on this repository, replacing any registered remote of the same name. Registered remotes are recorded in checkouts materialized from this repository (GitRef.tree, Workspace.git.directory), so remote-aware tooling like gh can resolve and fetch from them. The origin remote also routes push when no explicit destination is passed: its push URL, or its URL, becomes the default destination. Routing metadata only, never a credential grant: pushes still authenticate with the caller’s own credentials and require approval as usual.

Arguments

• name - The remote’s name, e.g. “origin” or “upstream”.
• url - The remote’s fetch URL.
• opt - optional argument, see inner type for documentation, use _opts to use

Trait Implementations

impl Clone for GitRepository

fn clone(&self) -> GitRepository

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl IntoID<Id> for GitRepository

fn into_id( self, ) -> Pin<Box<dyn Future<Output = Result<Id, DaggerError>> + Send>>

impl Loadable for GitRepository

fn graphql_type() -> &'static str

The GraphQL type name (e.g. "Container").

fn from_query( proc: Option<Arc<DaggerSessionProc>>, selection: Selection, graphql_client: DynGraphQLClient, ) -> Self

Construct this type from a query selection.

impl Node for GitRepository

fn id(&self) -> impl Future<Output = Result<Id, DaggerError>> + Send