state

Documentation

Index

• Constants
• func Sort(i, j *Resource) int
• type ReloadSummary
  • func (s ReloadSummary) String() string
• type Resource
  • func (r *Resource) String() string
• type ResourceAddress
• type Service
  • func NewService(opts ServiceOptions) *Service
  • func (s *Service) CreateReloadTask(workspaceID resource.ID) (*task.Task, error)
  • func (s *Service) Delete(workspaceID resource.ID, addrs ...ResourceAddress) (task.Spec, error)
  • func (s *Service) Get(workspaceID resource.ID) (*State, error)
  • func (s *Service) GetResource(resourceID resource.ID) (*Resource, error)
  • func (s *Service) Move(workspaceID resource.ID, src, dest ResourceAddress) (task.Spec, error)
  • func (r Service) Reload(workspaceID resource.ID) (task.Spec, error)
  • func (s *Service) Taint(workspaceID resource.ID, addr ResourceAddress) (task.Spec, error)
  • func (s *Service) Untaint(workspaceID resource.ID, addr ResourceAddress) (task.Spec, error)
• type ServiceOptions
• type State
  • func (s *State) LogValue() slog.Value
• type StateFile
• type StateFileModule
• type StateFileOutput
• type StateFileResource
• type StateFileResourceInstance
• type StateFileResourceInstanceStatus
• type StateFileResourceMode

Constants

const (
	StateFileResourceInstanceTainted StateFileResourceInstanceStatus = "tainted"
	StateFileResourceDataMode        StateFileResourceMode           = "data"
)

Functions

func Sort

func Sort(i, j *Resource) int

Types

type ReloadSummary

type ReloadSummary int

const (
	Empty ReloadSummary = iota
	Unchanged
	Updated
)

func (ReloadSummary) String

func (s ReloadSummary) String() string

type Resource

type Resource struct {
	resource.Common

	Address    ResourceAddress
	Attributes map[string]any
	Tainted    bool
}

Resource is a pug state resource.

func (*Resource) String

func (r *Resource) String() string

type ResourceAddress

type ResourceAddress string

type Service

type Service struct {
	*pubsub.Broker[*State]
	// contains filtered or unexported fields
}

func NewService

func NewService(opts ServiceOptions) *Service

func (*Service) CreateReloadTask

func (s *Service) CreateReloadTask(workspaceID resource.ID) (*task.Task, error)

func (*Service) Delete

func (s *Service) Delete(workspaceID resource.ID, addrs ...ResourceAddress) (task.Spec, error)

func (*Service) Get

func (s *Service) Get(workspaceID resource.ID) (*State, error)

Get retrieves the state for a workspace.

func (*Service) GetResource

func (s *Service) GetResource(resourceID resource.ID) (*Resource, error)

GetResource retrieves a state resource.

TODO: this is massively inefficient

func (*Service) Move

func (s *Service) Move(workspaceID resource.ID, src, dest ResourceAddress) (task.Spec, error)

func (Service) Reload

func (r Service) Reload(workspaceID resource.ID) (task.Spec, error)

Reload creates a task to repopulate the local cache of the state of the given workspace.

func (*Service) Taint

func (s *Service) Taint(workspaceID resource.ID, addr ResourceAddress) (task.Spec, error)

func (*Service) Untaint

func (s *Service) Untaint(workspaceID resource.ID, addr ResourceAddress) (task.Spec, error)

type ServiceOptions

type ServiceOptions struct {
	Modules    *module.Service
	Workspaces *workspace.Service
	Tasks      *task.Service
	Logger     logging.Interface
}

type State

type State struct {
	resource.Common

	WorkspaceID      resource.ID
	Resources        map[ResourceAddress]*Resource
	Serial           int64
	TerraformVersion string
	Lineage          string
}

func (*State) LogValue

func (s *State) LogValue() slog.Value

type StateFile

type StateFile struct {
	Version          int
	TerraformVersion string `json:"terraform_version"`
	Serial           int64
	Lineage          string
	Outputs          map[string]StateFileOutput
	Resources        []StateFileResource
}

StateFile is the terraform state file contents

type StateFileModule

type StateFileModule struct {
	Resources    []StateFileResource
	ChildModules []StateFileModule `json:"child_modules"`
}

type StateFileOutput

type StateFileOutput struct {
	Value     json.RawMessage
	Sensitive bool
}

StateFileOutput is an output in the terraform state file

type StateFileResource

type StateFileResource struct {
	Name        string
	ProviderURI string `json:"provider"`
	Type        string
	Module      string
	Mode        StateFileResourceMode
	Instances   []StateFileResourceInstance
}

type StateFileResourceInstance

type StateFileResourceInstance struct {
	IndexKey   any `json:"index_key"`
	Status     StateFileResourceInstanceStatus
	Attributes json.RawMessage
}

type StateFileResourceInstanceStatus

type StateFileResourceInstanceStatus string

type StateFileResourceMode

type StateFileResourceMode string