NewDir creates and returns a new Dir object that will read and write provider plugins in the given filesystem directory.

NewDirWithPlatform is a variant of NewDir that allows selecting a specific target platform, rather than taking the current one where this code is running.

NewInstaller constructs and returns a new installer with the given target directory and provider source.

InstallNewProvidersOnly is an InstallMode that causes the installer to accept any existing version of a requested provider that is already cached as long as it's in the given version sets, without checking whether new versions are available that are also in the given version sets.

InstallUpgrades is an InstallMode that causes the installer to check all requested providers to see if new versions are available that are also in the given version sets, even if a suitable version of a given provider is already available.

CachedProvider represents a provider package in a cache directory.

Dir represents a single local filesystem directory containing cached provider plugin packages that can be both read from (to find providers to use for operations) and written to (during provider installation).

Installer is the main type in this package, representing a provider installer with a particular configuration-specific cache directory and an optional global cache directory.

InstallerError is an error type that may be returned (but is not guaranteed) from Installer.EnsureProviderVersions to indicate potentially several separate failed installation outcomes for different providers included in the overall request.

InstallerEvents is a collection of function references that can be associated with an Installer object in order to be notified about various installation lifecycle events during an install operation.

InstallMode customizes the details of how an install operation treats providers that have versions already cached in the target directory.