Expose configured secrets bootstrap APIs
This commit is contained in:
62
secrets.go
62
secrets.go
@@ -92,13 +92,69 @@ func (e *SecretsError) Diagnostics() []Diagnostic {
|
||||
// roll back values already applied.
|
||||
func LoadSecretsIntoEnvironment(directory string) (*SecretsReport, error) {
|
||||
report, err := engine.LoadSecretsDir(directory)
|
||||
return &SecretsReport{value: report}, fromEngineSecretsError(err)
|
||||
}
|
||||
|
||||
// SecretsOptions selects the policy for an explicit directory bootstrap.
|
||||
type SecretsOptions struct {
|
||||
// Overwrite replaces existing environment variables, including empty values.
|
||||
Overwrite bool
|
||||
}
|
||||
|
||||
// LoadSecretsIntoEnvironmentWithOptions loads immediate regular files into the
|
||||
// environment using the selected policy. It returns a report even on error;
|
||||
// applied values are not rolled back. Errors are reported as *SecretsError.
|
||||
func LoadSecretsIntoEnvironmentWithOptions(directory string, options SecretsOptions) (*SecretsReport, error) {
|
||||
report, err := engine.LoadSecretsDirWithOptions(directory, engine.SecretsDirOptions{Overwrite: options.Overwrite})
|
||||
return &SecretsReport{value: report}, fromEngineSecretsError(err)
|
||||
}
|
||||
|
||||
// SecretsFromConfigOptions configures preparation of a host main source.
|
||||
type SecretsFromConfigOptions struct {
|
||||
// Filesystem selects the main file's host containment root when supplied.
|
||||
Filesystem *FilesystemContext
|
||||
// Overwrite, when non-nil, overrides the main document's Boolean setting.
|
||||
// A nil value uses that setting, or false when it is absent.
|
||||
Overwrite *bool
|
||||
}
|
||||
|
||||
// LoadSecretsIntoEnvironmentFromConfig explicitly prepares a host File or
|
||||
// SearchConfig main and loads its declared secrets directory before loading.
|
||||
// NoSource and an optional search with no match return NoSource and an empty
|
||||
// report. The returned source owns a reusable main-document snapshot and its
|
||||
// host context; imports and environment lookup remain part of each later load.
|
||||
// At most one options value is accepted. A non-nil report accompanies every
|
||||
// result. Preparation failures return *LoadError; directory or environment
|
||||
// failures return *SecretsError. Any error returns a zero Source and does not
|
||||
// roll back prior environment writes.
|
||||
func LoadSecretsIntoEnvironmentFromConfig(main Source, supplied ...SecretsFromConfigOptions) (*SecretsReport, Source, error) {
|
||||
options := make([]engine.SecretsFromConfigOptions, len(supplied))
|
||||
for index, option := range supplied {
|
||||
options[index].Filesystem = toEngineFilesystemContext(option.Filesystem)
|
||||
if option.Overwrite != nil {
|
||||
value := *option.Overwrite
|
||||
options[index].Overwrite = &value
|
||||
}
|
||||
}
|
||||
report, prepared, err := engine.LoadSecretsDirFromConfig(main.toEngine(), options...)
|
||||
result := &SecretsReport{value: report}
|
||||
if err == nil {
|
||||
return result, nil
|
||||
return result, Source{value: prepared}, nil
|
||||
}
|
||||
var loadError *engine.LoadError
|
||||
if errors.As(err, &loadError) {
|
||||
return result, Source{}, &LoadError{value: loadError}
|
||||
}
|
||||
return result, Source{}, fromEngineSecretsError(err)
|
||||
}
|
||||
|
||||
func fromEngineSecretsError(err error) error {
|
||||
if err == nil {
|
||||
return nil
|
||||
}
|
||||
var secretsError *engine.SecretsError
|
||||
if errors.As(err, &secretsError) {
|
||||
return result, &SecretsError{value: secretsError}
|
||||
return &SecretsError{value: secretsError}
|
||||
}
|
||||
return result, &SecretsError{}
|
||||
return &SecretsError{}
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user