Method Repository

submodule.go:105–182

Repository returns the Repository represented by this submodule

()

// Repository returns the Repository represented by this submodule
func (s *Submodule) Repository() (*Repository, error) {
	if !s.initialized {
		return nil, ErrSubmoduleNotInitialized
	}

	storer, err := s.w.r.Storer.Module(s.c.Name)
	if err != nil {
		return nil, err
	}

	_, err = storer.Reference(plumbing.HEAD)
	if err != nil && err != plumbing.ErrReferenceNotFound {
		return nil, err
	}

	var exists bool
	if err == nil {
		exists = true
	}

	// s.c.Path is sourced from the worktree's .gitmodules and is
	// therefore tree-controlled. Apply the strict tree-path validator
	// before chroot — the wrapper's tolerant validPath would let a
	// final-position .git component through (e.g. "submodule/.git"),
	// which a malicious .gitmodules could use to chroot the submodule
	// worktree into the repository's actual .git directory.
	if err := pathutil.ValidTreePath(s.c.Path); err != nil {
		return nil, err
	}

	var worktree billy.Filesystem
	if worktree, err = s.w.Filesystem.Chroot(s.c.Path); err != nil {
		return nil, err
	}

	if exists {
		return Open(storer, worktree)
	}

	r, err := Init(storer, worktree)
	if err != nil {
		return nil, err
	}

	moduleEndpoint, err := transport.NewEndpoint(s.c.URL)
	if err != nil {
		return nil, err
	}

	// A relative submodule URL such as "../X.git" must resolve against
	// the parent repository's remote URL, not against the process CWD.
	// Detect relativity from the raw configured URL because
	// transport.NewEndpoint normalizes local paths to absolute form via
	// filepath.Abs, which would otherwise mask the relative form here.
	if giturl.IsLocalEndpoint(s.c.URL) &&
		!path.IsAbs(s.c.URL) && !filepath.IsAbs(s.c.URL) {

		base, err := defaultRemote(s.w.r)