submodule

type CapabilityDetector ¶

type CapabilityDetector interface {
	// Detect queries the Git server at the given URL for its capabilities.
	// Returns the server's advertised capabilities or an error if unreachable.
	Detect(url string, auth transport.AuthMethod) (*capability.Capabilities, error)
	// ChooseStrategy selects the optimal fetch strategy based on capabilities.
	ChooseStrategy(caps *capability.Capabilities) capability.StrategyType
}

CapabilityDetectorInterface abstracts capability detection for testing. It allows injecting mock detectors to test Fetcher behavior without making actual network calls to Git servers.

type Fetcher ¶

type Fetcher struct {

	// Auth contains credentials for authenticating with the remote server.
	Auth transport.AuthMethod
	// contains filtered or unexported fields
}

Fetcher orchestrates the fetching of a specific commit from a remote repository. It automatically detects server capabilities and selects the optimal strategy, or uses a forced strategy if configured (useful for testing or debugging).

func NewFetcher(auth transport.AuthMethod, repo *git.Repository, opts ...FetcherOption) (*Fetcher, error)

func (f *Fetcher) Fetch(ctx context.Context, opts *plumbing.Hash) error

type FetcherFactory ¶

type FetcherFactory func(auth transport.AuthMethod, repo *git.Repository) (SubmoduleFetcher, error)

type FetcherOption ¶

type FetcherOption func(*Fetcher)

FetcherOption configures a Fetcher instance. Use with NewFetcher to customize behavior.

func WithDetector(d CapabilityDetector) FetcherOption

func WithForcedStrategy(st capability.StrategyType) FetcherOption

func WithRemoteName(name string) FetcherOption

func WithStrategies(s map[capability.StrategyType]Strategy) FetcherOption

type Strategy ¶

type Strategy interface {
	Type() capability.StrategyType
	// Execute fetches the specified commit from the remote.
	Execute(ctx context.Context, r *git.Repository, commitHash plumbing.Hash) error
}

Strategy defines the interface for fetch strategies. Each strategy implements a different approach to fetching a specific commit from a remote Git server, optimized for different server capabilities.

type SubmoduleFetcher ¶

type SubmoduleFetcher interface {
	Fetch(ctx context.Context, opt *plumbing.Hash) error
}

func DefaultFetcherFactory(auth transport.AuthMethod, repo *git.Repository) (SubmoduleFetcher, error)

type SubmoduleUpdater ¶

type SubmoduleUpdater struct {
	// contains filtered or unexported fields
}

func NewSubmoduleUpdater(opts ...UpdaterOption) *SubmoduleUpdater

func (u *SubmoduleUpdater) UpdateContext(ctx context.Context, s git.Submodules, o *git.SubmoduleUpdateOptions) error

func (u *SubmoduleUpdater) UpdateSubmodules(r *git.Repository, o *git.SubmoduleUpdateOptions) error

type UpdaterOption ¶

type UpdaterOption func(*SubmoduleUpdater)

func WithFetcherFactory(factory FetcherFactory) UpdaterOption