Method Clone

buildsystems/buildconfig.go:313–478

(repoUrl, repoRef, archive string, depth int)

}

func (b BuildConfig) Clone(repoUrl, repoRef, archive string, depth int) error {
	if fileio.PathExists(b.PortConfig.RepoDir) {
		entities, err := os.ReadDir(b.PortConfig.RepoDir)
		if err != nil {
			return fmt.Errorf("failed to check if empty -> %w", err)
		}
		if len(entities) > 0 {
			if b.PortConfig.Checksum != "" {
				// Hard reset to specified git commit hash.
				if strings.HasSuffix(repoUrl, ".git") {
					if err := git.HardReset(b.PortConfig.RepoDir, b.PortConfig.Checksum); err != nil {
						return err
					}
					return nil
				}

				// For the archive repository: extract again, restore from pkgcache again, or download again.
				if err := os.RemoveAll(b.PortConfig.RepoDir); err != nil {
					return fmt.Errorf("failed to remove local repo src dir -> %w", err)
				}
			} else {
				// Pin to resolved commit if available (from pre-deploy ref resolution).
				if commit := refs.GetResolvedCommit(b.PortConfig.nameVersion()); commit != "" {
					if err := git.HardReset(b.PortConfig.RepoDir, commit); err != nil {
						return err
					}
				}
				return nil
			}
		} else {
			// Remove empty folder to let download or clone again.
			if err := os.RemoveAll(b.PortConfig.RepoDir); err != nil {
				return fmt.Errorf("failed to remove empty src dir -> %w", err)
			}
		}
	}

	// p.PortConfig.nameVersion() may contains "-dev", here must use a clear name@version.
	nameVersion := fmt.Sprintf("%s@%s", b.PortConfig.LibName, b.PortConfig.LibVersion)

	// Try to fetch repo from pkgcache.
	var repoCache context.RepoCache
	pkgCacheConfig := b.Ctx.PkgCacheConfig()
	if pkgCacheConfig != nil {
		repoCache = pkgCacheConfig.GetRepoCache()
	}

	// Restore repo from pkgcache condition:
	// - not offline.
	// - not virtual port.
	// - pkgcache is configured.
	// - current port is one of third-party ports.
	// - checksum is not empty.
	if repoUrl != "_" && pkgCacheConfig != nil && repoCache != nil {
		if fromWhere, err := repoCache.Restore(nameVersion, repoUrl, b.PortConfig.RepoDir, b.PortConfig.Checksum); err != nil {
			color.PrintWarning("failed to restore %s from repo cache, because of %s", nameVersion, err)
			color.PrintHint("Location: %s\n", fromWhere)
		} else if fromWhere != "" {