resilien
/
terraform
2
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

improve clistate.Locker docs

This commit is contained in:
James Bardin 2018-02-27 10:49:06 -05:00
parent bdd475e149
commit 2b97585d46
1 changed files with 12 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

18
command/clistate/state.go
View File

@ -50,9 +50,15 @@ that no one else is holding a lock.
` `
) )
// Locker allows for more convenient locking, by creating the timeout context // Locker allows for more convenient usage of the lower-level state.Locker
// and LockInfo for the caller, while storing any related data required for // implementations.
// Unlock. // The state.Locker API requires passing in a state.LockInfo struct. Locker
// implementations are expected to create the required LockInfo struct when
// Lock is called, populate the Operation field with the "reason" string
// provided, and pass that on to the underlying state.Locker.
// Locker implementations are also expected to store any state required to call
// Unlock, which is at a minimum the LockID string returned by the
// state.Locker.
type Locker interface { type Locker interface {
// Lock the provided state, storing the reason string in the LockInfo. // Lock the provided state, storing the reason string in the LockInfo.
Lock(s state.State, reason string) error Lock(s state.State, reason string) error
@ -73,9 +79,9 @@ type locker struct {
} }
// Create a new Locker. // Create a new Locker.
// The provided context will be used for lock cancellation, and combined with // This Locker uses state.LockWithContext to retry the lock until the provided
// the timeout duration. Lock progress will be be reported to the user through // timeout is reached, or the context is canceled. Lock progress will be be
// the provided UI. // reported to the user through the provided UI.
func NewLocker( func NewLocker(
ctx context.Context, ctx context.Context,
timeout time.Duration, timeout time.Duration,