Documentation
¶
Index ¶
- Constants
- Variables
- func CleanDigestAlgorithmName(name string) string
- func ContentsFromZip(archivePath string, paths ...string) (map[string]string, error)
- func ExtractFromZipToUniqueTempFile(archivePath, dir string, paths ...string) (map[string]Opener, error)
- func ExtractGlobsFromTarToUniqueTempFile(archivePath, dir string, globs ...string) (map[string]Opener, error)
- func GlobMatch(pattern, name string) bool
- func Hashers(names ...string) ([]crypto.Hash, error)
- func NewDigestsFromFile(ctx context.Context, closer io.ReadCloser, hashes []crypto.Hash) ([]file.Digest, error)
- func NormalizeHashes(hashes []crypto.Hash) []crypto.Hash
- func TraverseFilesInZip(archivePath string, visitor func(*zip.File) error, paths ...string) error
- func UnzipToDir(archivePath, targetDir string) error
- func WalkDiskDir(fsys filesystem.FileSystem, root string, fn WalkDiskDirFunc) error
- type Getter
- type HashiGoGetter
- type Opener
- type WalkDiskDirFunc
- type ZipFileManifest
- type ZipReadCloser
Constants ¶
const ( KB = 1 << (10 * iota) MB GB )
Variables ¶
var (
ErrNonArchiveSource = fmt.Errorf("non-archive sources are not supported for directory destinations")
)
Functions ¶
func CleanDigestAlgorithmName ¶ added in v0.85.0
func ContentsFromZip ¶
ContentsFromZip extracts select paths for the given archive and returns a set of string contents for each path.
func ExtractFromZipToUniqueTempFile ¶
func ExtractFromZipToUniqueTempFile(archivePath, dir string, paths ...string) (map[string]Opener, error)
ExtractFromZipToUniqueTempFile extracts select paths for the given archive to a temporary directory, returning file openers for each file extracted.
func ExtractGlobsFromTarToUniqueTempFile ¶ added in v0.35.0
func ExtractGlobsFromTarToUniqueTempFile(archivePath, dir string, globs ...string) (map[string]Opener, error)
ExtractGlobsFromTarToUniqueTempFile extracts paths matching the given globs within the given archive to a temporary directory, returning file openers for each file extracted.
func GlobMatch ¶
GlobMatch evaluates the given glob pattern against the given "name" string, indicating if there is a match or not. Source: https://research.swtch.com/glob.go
func NewDigestsFromFile ¶ added in v0.85.0
func TraverseFilesInZip ¶
TraverseFilesInZip enumerates all paths stored within a zip archive using the visitor pattern.
func UnzipToDir ¶
UnzipToDir extracts a zip archive to a target directory.
func WalkDiskDir ¶ added in v1.28.0
func WalkDiskDir(fsys filesystem.FileSystem, root string, fn WalkDiskDirFunc) error
WalkDiskDir walks the file tree within the go-diskfs filesystem at root, calling fn for each file or directory in the tree, including root. This is meant to mimic the behavior of fs.WalkDir in the standard library.
Types ¶
type Getter ¶ added in v1.28.0
type Getter interface {
// GetFile downloads the give URL into the given path. The URL must reference a single file.
GetFile(dst, src string, monitor ...*progress.Manual) error
// GetToDir downloads the resource found at the `src` URL into the given `dst` directory.
// The directory must already exist, and the remote resource MUST BE AN ARCHIVE (e.g. `.tar.gz`).
GetToDir(dst, src string, monitor ...*progress.Manual) error
}
type HashiGoGetter ¶ added in v1.28.0
type HashiGoGetter struct {
// contains filtered or unexported fields
}
func NewGetter ¶ added in v1.28.0
func NewGetter(id clio.Identification, httpClient *http.Client) *HashiGoGetter
NewGetter creates and returns a new Getter. Providing an http.Client is optional. If one is provided, it will be used for all HTTP(S) getting; otherwise, go-getter's default getters will be used.
func (HashiGoGetter) GetFile ¶ added in v1.28.0
func (g HashiGoGetter) GetFile(dst, src string, monitors ...*progress.Manual) error
func (HashiGoGetter) GetToDir ¶ added in v1.28.0
func (g HashiGoGetter) GetToDir(dst, src string, monitors ...*progress.Manual) error
type Opener ¶ added in v0.4.0
type Opener struct {
// contains filtered or unexported fields
}
Opener is an object that stores a path to later be opened as a file.
type WalkDiskDirFunc ¶ added in v1.28.0
type WalkDiskDirFunc func(fsys filesystem.FileSystem, path string, d os.FileInfo, err error) error
type ZipFileManifest ¶
ZipFileManifest is a collection of paths and their file metadata.
func NewZipFileManifest ¶
func NewZipFileManifest(archivePath string) (ZipFileManifest, error)
NewZipFileManifest creates and returns a new ZipFileManifest populated with path and metadata from the given zip archive path.
type ZipReadCloser ¶ added in v0.17.0
ZipReadCloser is a drop-in replacement for zip.ReadCloser (from zip.OpenReader) that additionally considers zips that have bytes prefixed to the front of the archive (common with self-extracting jars).
func OpenZip ¶ added in v0.17.0
func OpenZip(filepath string) (*ZipReadCloser, error)
OpenZip provides a ZipReadCloser for the given filepath.
Source Files