mirror of
https://github.com/opentofu/opentofu.git
synced 2024-12-28 18:01:01 -06:00
f25935649a
This new package aims to encapsulate all of our interactions with go-getter to fetch remote module packages, to ensure that the rest of Terraform will only use the small subset of go-getter functionality that our modern module installer uses. In older versions of Terraform, go-getter was the entire implementation of module installation, but along the way we found that several aspects of its design are poor fit for Terraform's needs, and so now we're using it as just an implementation detail of Terraform's handling of remote module packages only, hiding it behind this wrapper API which exposes only the services that our module installer needs. This new package isn't actually used yet, but in a later commit we will change all of the other callers to go-getter to only work indirectly through this package, so that this will be the only package that actually imports the go-getter packages.
58 lines
2.6 KiB
Go
58 lines
2.6 KiB
Go
package getmodules
|
|
|
|
import (
|
|
"path"
|
|
|
|
getter "github.com/hashicorp/go-getter"
|
|
)
|
|
|
|
// SplitPackageSubdir detects whether the given address string has a
|
|
// subdirectory portion, and if so returns a non-empty subDir string
|
|
// along with the trimmed package address.
|
|
//
|
|
// If the given string doesn't have a subdirectory portion then it'll
|
|
// just be returned verbatim in packageAddr, with an empty subDir value.
|
|
//
|
|
// Although the rest of this package is focused only on direct remote
|
|
// module packages, this particular function and its companion
|
|
// ExpandSubdirGlobs are both also relevant for registry-based module
|
|
// addresses, because a registry translates such an address into a
|
|
// remote module package address and thus can contribute its own
|
|
// additions to the final subdirectory selection.
|
|
func SplitPackageSubdir(given string) (packageAddr, subDir string) {
|
|
// We delegate this mostly to go-getter, because older Terraform
|
|
// versions just used go-getter directly and so we need to preserve
|
|
// its various quirks for compatibility reasons.
|
|
//
|
|
// However, note that in Terraform we _always_ split off the subdirectory
|
|
// portion and handle it within Terraform-level code, _never_ passing
|
|
// a subdirectory portion down into go-getter's own Get function, because
|
|
// Terraform's ability to refer between local paths inside the same
|
|
// package depends on Terraform itself always being aware of where the
|
|
// package's root directory ended up on disk, and always needs the
|
|
// package installed wholesale.
|
|
packageAddr, subDir = getter.SourceDirSubdir(given)
|
|
if subDir != "" {
|
|
subDir = path.Clean(subDir)
|
|
}
|
|
return packageAddr, subDir
|
|
}
|
|
|
|
// ExpandSubdirGlobs handles a subdir string that might contain glob syntax,
|
|
// turning it into a concrete subdirectory path by referring to the actual
|
|
// files on disk in the given directory which we assume contains the content
|
|
// of whichever package this is a subdirectory glob for.
|
|
//
|
|
// Subdir globs are used, for example, when a module registry wants to specify
|
|
// to select the contents of the single directory at the root of a conventional
|
|
// tar archive but it doesn't actually know the exact name of that directory.
|
|
// In that case it might specify a subdir of just "*", which this function
|
|
// will then expand into the single subdirectory found inside instDir, or
|
|
// return an error if the result would be ambiguous.
|
|
func ExpandSubdirGlobs(instDir string, subDir string) (string, error) {
|
|
// We just delegate this entirely to go-getter, because older Terraform
|
|
// versions just used go-getter directly and so we need to preserve
|
|
// its various quirks for compatibility reasons.
|
|
return getter.SubdirGlob(instDir, subDir)
|
|
}
|