pulumi/sdk/go/auto/optrefresh/optrefresh.go

155 lines
5.1 KiB
Go
Raw Normal View History

2020-08-27 17:43:23 +00:00
// Copyright 2016-2020, Pulumi Corporation.
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
// Package optrefresh contains functional options to be used with stack refresh operations
// github.com/sdk/v2/go/x/auto Stack.Refresh(...optrefresh.Option)
package optrefresh
import (
"io"
"github.com/pulumi/pulumi/sdk/v3/go/auto/debug"
"github.com/pulumi/pulumi/sdk/v3/go/auto/events"
)
// Parallel is the number of resource operations to run in parallel at once during the refresh
// (1 for no parallelism). Defaults to unbounded. (default 2147483647)
func Parallel(n int) Option {
return optionFunc(func(opts *Options) {
opts.Parallel = n
})
}
2020-08-29 02:17:46 +00:00
// ExpectNoChanges will cause the preview to return an error if any changes occur
func ExpectNoChanges() Option {
return optionFunc(func(opts *Options) {
opts.ExpectNoChanges = true
})
}
// Message (optional) to associate with the refresh operation
func Message(message string) Option {
return optionFunc(func(opts *Options) {
opts.Message = message
})
}
// Target specifies an exclusive list of resource URNs to refresh
func Target(urns []string) Option {
return optionFunc(func(opts *Options) {
opts.Target = urns
})
}
// ProgressStreams allows specifying one or more io.Writers to redirect incremental refresh stdout
func ProgressStreams(writers ...io.Writer) Option {
return optionFunc(func(opts *Options) {
opts.ProgressStreams = writers
})
}
// ErrorProgressStreams allows specifying one or more io.Writers to redirect incremental refresh stderr
func ErrorProgressStreams(writers ...io.Writer) Option {
return optionFunc(func(opts *Options) {
opts.ErrorProgressStreams = writers
})
}
// EventStreams allows specifying one or more channels to receive the Pulumi event stream
func EventStreams(channels ...chan<- events.EngineEvent) Option {
return optionFunc(func(opts *Options) {
opts.EventStreams = channels
})
}
// DebugLogging provides options for verbose logging to standard error, and enabling plugin logs.
func DebugLogging(debugOpts debug.LoggingOptions) Option {
return optionFunc(func(opts *Options) {
opts.DebugLogOpts = debugOpts
})
}
// UserAgent specifies the agent responsible for the update, stored in backends as "environment.exec.agent"
func UserAgent(agent string) Option {
return optionFunc(func(opts *Options) {
opts.UserAgent = agent
})
}
// ShowSecrets configures whether to show config secrets when they appear in the config.
func ShowSecrets(show bool) Option {
return optionFunc(func(opts *Options) {
opts.ShowSecrets = &show
})
}
Support suppress-progress and suppress-outputs options (#15596) <!--- Thanks so much for your contribution! If this is your first time contributing, please ensure that you have read the [CONTRIBUTING](https://github.com/pulumi/pulumi/blob/master/CONTRIBUTING.md) documentation. --> # Description <!--- Please include a summary of the change and which issue is fixed. Please also include relevant motivation and context. --> Introduces support for `--suppress-progress` and `--suppress-outputs` parameters of the cli for stack `up`, `destroy`, `preview`, and `refresh`. Fixes https://github.com/pulumi/pulumi/issues/12549 precondition for: https://github.com/pulumi/actions/issues/1108 ## Checklist I'm not running any of the ones below as it's at least shady what it requires and the way it runs - [x] I have run `make tidy` to update any new dependencies - [ ] I have run `make lint` to verify my code passes the lint check _-> fails with `ERRO Running error: unknown linters: 'perfsprint', run 'golangci-lint help linters' to see the list of supported linters `_ - [ ] I have formatted my code using `gofumpt` <!--- Please provide details if the checkbox below is to be left unchecked. --> - [ ] I have added tests that prove my fix is effective or that my feature works _-> current params dont seem to be tested in any way, and it's not easily testable as its directly dependent on the cli_ <!--- User-facing changes require a CHANGELOG entry. --> - [x] I have run `make changelog` and committed the `changelog/pending/<file>` documenting my change <!-- If the change(s) in this PR is a modification of an existing call to the Pulumi Cloud, then the service should honor older versions of the CLI where this change would not exist. You must then bump the API version in /pkg/backend/httpstate/client/api.go, as well as add it to the service. --> - [ ] Yes, there are changes in this PR that warrants bumping the Pulumi Cloud API version <!-- @Pulumi employees: If yes, you must submit corresponding changes in the service repo. --> --------- Co-authored-by: Thomas Gummerer <t.gummerer@gmail.com>
2024-03-07 09:29:24 +00:00
// Suppress display of periodic progress dots
func SuppressProgress() Option {
return optionFunc(func(opts *Options) {
opts.SuppressProgress = true
})
}
// Suppress display of stack outputs (in case they contain sensitive values)
func SuppressOutputs() Option {
return optionFunc(func(opts *Options) {
opts.SuppressOutputs = true
})
}
// Option is a parameter to be applied to a Stack.Refresh() operation
type Option interface {
ApplyOption(*Options)
}
// ---------------------------------- implementation details ----------------------------------
// Options is an implementation detail
type Options struct {
// Parallel is the number of resource operations to run in parallel at once
// (1 for no parallelism). Defaults to unbounded. (default 2147483647)
Parallel int
// Message (optional) to associate with the refresh operation
Message string
2020-08-29 02:17:46 +00:00
// Return an error if any changes occur during this preview
ExpectNoChanges bool
// Specify an exclusive list of resource URNs to re
Target []string
// ProgressStreams allows specifying one or more io.Writers to redirect incremental refresh stdout
ProgressStreams []io.Writer
// ErrorProgressStreams allows specifying one or more io.Writers to redirect incremental refresh stderr
ErrorProgressStreams []io.Writer
// EventStreams allows specifying one or more channels to receive the Pulumi event stream
EventStreams []chan<- events.EngineEvent
// DebugLogOpts specifies additional settings for debug logging
DebugLogOpts debug.LoggingOptions
// UserAgent specifies the agent responsible for the update, stored in backends as "environment.exec.agent"
UserAgent string
// Colorize output. Choices are: always, never, raw, auto (default "auto")
Color string
// Show config secrets when they appear.
ShowSecrets *bool
Support suppress-progress and suppress-outputs options (#15596) <!--- Thanks so much for your contribution! If this is your first time contributing, please ensure that you have read the [CONTRIBUTING](https://github.com/pulumi/pulumi/blob/master/CONTRIBUTING.md) documentation. --> # Description <!--- Please include a summary of the change and which issue is fixed. Please also include relevant motivation and context. --> Introduces support for `--suppress-progress` and `--suppress-outputs` parameters of the cli for stack `up`, `destroy`, `preview`, and `refresh`. Fixes https://github.com/pulumi/pulumi/issues/12549 precondition for: https://github.com/pulumi/actions/issues/1108 ## Checklist I'm not running any of the ones below as it's at least shady what it requires and the way it runs - [x] I have run `make tidy` to update any new dependencies - [ ] I have run `make lint` to verify my code passes the lint check _-> fails with `ERRO Running error: unknown linters: 'perfsprint', run 'golangci-lint help linters' to see the list of supported linters `_ - [ ] I have formatted my code using `gofumpt` <!--- Please provide details if the checkbox below is to be left unchecked. --> - [ ] I have added tests that prove my fix is effective or that my feature works _-> current params dont seem to be tested in any way, and it's not easily testable as its directly dependent on the cli_ <!--- User-facing changes require a CHANGELOG entry. --> - [x] I have run `make changelog` and committed the `changelog/pending/<file>` documenting my change <!-- If the change(s) in this PR is a modification of an existing call to the Pulumi Cloud, then the service should honor older versions of the CLI where this change would not exist. You must then bump the API version in /pkg/backend/httpstate/client/api.go, as well as add it to the service. --> - [ ] Yes, there are changes in this PR that warrants bumping the Pulumi Cloud API version <!-- @Pulumi employees: If yes, you must submit corresponding changes in the service repo. --> --------- Co-authored-by: Thomas Gummerer <t.gummerer@gmail.com>
2024-03-07 09:29:24 +00:00
// Suppress display of periodic progress dots
SuppressProgress bool
// Suppress display of stack outputs (in case they contain sensitive values)
SuppressOutputs bool
}
type optionFunc func(*Options)
// ApplyOption is an implementation detail
func (o optionFunc) ApplyOption(opts *Options) {
o(opts)
}