2020-08-27 19:43:23 +02: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.
|
|
|
|
|
2020-08-23 19:25:17 +02:00
|
|
|
// Package optpreview contains functional options to be used with stack preview operations
|
|
|
|
// github.com/sdk/v2/go/x/auto Stack.Preview(...optpreview.Option)
|
|
|
|
package optpreview
|
|
|
|
|
2020-12-23 00:45:37 +01:00
|
|
|
import (
|
2021-03-11 05:49:48 +01:00
|
|
|
"io"
|
|
|
|
|
2021-03-17 14:20:05 +01:00
|
|
|
"github.com/pulumi/pulumi/sdk/v3/go/auto/debug"
|
|
|
|
"github.com/pulumi/pulumi/sdk/v3/go/auto/events"
|
2020-12-23 00:45:37 +01:00
|
|
|
)
|
|
|
|
|
2020-08-23 19:25:17 +02:00
|
|
|
// Parallel is the number of resource operations to run in parallel at once during the update
|
|
|
|
// (1 for no parallelism). Defaults to unbounded. (default 2147483647)
|
|
|
|
func Parallel(n int) Option {
|
|
|
|
return optionFunc(func(opts *Options) {
|
|
|
|
opts.Parallel = n
|
|
|
|
})
|
|
|
|
}
|
|
|
|
|
|
|
|
// Message (optional) to associate with the preview operation
|
|
|
|
func Message(message string) Option {
|
|
|
|
return optionFunc(func(opts *Options) {
|
|
|
|
opts.Message = message
|
|
|
|
})
|
|
|
|
}
|
|
|
|
|
|
|
|
// ExpectNoChanges will cause the preview to return an error if any changes occur
|
|
|
|
func ExpectNoChanges() Option {
|
|
|
|
return optionFunc(func(opts *Options) {
|
|
|
|
opts.ExpectNoChanges = true
|
|
|
|
})
|
|
|
|
}
|
|
|
|
|
2021-02-24 02:38:28 +01:00
|
|
|
// Diff displays operation as a rich diff showing the overall change
|
|
|
|
func Diff() Option {
|
|
|
|
return optionFunc(func(opts *Options) {
|
|
|
|
opts.Diff = true
|
|
|
|
})
|
|
|
|
}
|
|
|
|
|
2020-08-23 19:25:17 +02:00
|
|
|
// Replace specifies an array of resource URNs to explicitly replace during the preview
|
|
|
|
func Replace(urns []string) Option {
|
|
|
|
return optionFunc(func(opts *Options) {
|
|
|
|
opts.Replace = urns
|
|
|
|
})
|
|
|
|
}
|
|
|
|
|
|
|
|
// Target specifies an exclusive list of resource URNs to update
|
|
|
|
func Target(urns []string) Option {
|
|
|
|
return optionFunc(func(opts *Options) {
|
|
|
|
opts.Target = urns
|
|
|
|
})
|
|
|
|
}
|
|
|
|
|
|
|
|
// TargetDependents allows updating of dependent targets discovered but not specified in the Target list
|
|
|
|
func TargetDependents() Option {
|
|
|
|
return optionFunc(func(opts *Options) {
|
|
|
|
opts.TargetDependents = true
|
|
|
|
})
|
|
|
|
}
|
|
|
|
|
2021-04-30 16:26:23 +02:00
|
|
|
// DebugLogging provides options for verbose logging to standard error, and enabling plugin logs.
|
2020-12-23 00:45:37 +01:00
|
|
|
func DebugLogging(debugOpts debug.LoggingOptions) Option {
|
|
|
|
return optionFunc(func(opts *Options) {
|
|
|
|
opts.DebugLogOpts = debugOpts
|
|
|
|
})
|
|
|
|
}
|
|
|
|
|
2021-03-11 05:49:48 +01:00
|
|
|
// ProgressStreams allows specifying one or more io.Writers to redirect incremental preview output
|
|
|
|
func ProgressStreams(writers ...io.Writer) Option {
|
|
|
|
return optionFunc(func(opts *Options) {
|
|
|
|
opts.ProgressStreams = 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
|
|
|
|
})
|
|
|
|
}
|
|
|
|
|
2021-04-30 16:26:23 +02:00
|
|
|
// 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
|
|
|
|
})
|
|
|
|
}
|
|
|
|
|
2020-08-23 19:25:17 +02:00
|
|
|
// Option is a parameter to be applied to a Stack.Preview() 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 preview operation
|
|
|
|
Message string
|
|
|
|
// Return an error if any changes occur during this preview
|
|
|
|
ExpectNoChanges bool
|
2021-02-24 02:38:28 +01:00
|
|
|
// Diff displays operation as a rich diff showing the overall change
|
|
|
|
Diff bool
|
2020-08-23 19:25:17 +02:00
|
|
|
// Specify resources to replace
|
|
|
|
Replace []string
|
|
|
|
// Specify an exclusive list of resource URNs to update
|
|
|
|
Target []string
|
|
|
|
// Allows updating of dependent targets discovered but not specified in the Target list
|
|
|
|
TargetDependents bool
|
2020-12-23 00:45:37 +01:00
|
|
|
// DebugLogOpts specifies additional settings for debug logging
|
|
|
|
DebugLogOpts debug.LoggingOptions
|
2021-03-11 05:49:48 +01:00
|
|
|
// ProgressStreams allows specifying one or more io.Writers to redirect incremental preview output
|
|
|
|
ProgressStreams []io.Writer
|
|
|
|
// EventStreams allows specifying one or more channels to receive the Pulumi event stream
|
|
|
|
EventStreams []chan<- events.EngineEvent
|
2021-04-30 16:26:23 +02:00
|
|
|
// UserAgent specifies the agent responsible for the update, stored in backends as "environment.exec.agent"
|
|
|
|
UserAgent string
|
2020-08-23 19:25:17 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
type optionFunc func(*Options)
|
|
|
|
|
|
|
|
// ApplyOption is an implementation detail
|
|
|
|
func (o optionFunc) ApplyOption(opts *Options) {
|
|
|
|
o(opts)
|
|
|
|
}
|