terraform

Documentation

Overview

Package terraform is the representation of a Terraform Module

Index

• type Input
  • func (i *Input) GetValue() string
  • func (i *Input) HasDefault() bool
• type Module
  • func LoadWithOptions(options *Options) (*Module, error)
  • func (m *Module) Convert() terraformsdk.Module
  • func (m *Module) HasHeader() bool
  • func (m *Module) HasInputs() bool
  • func (m *Module) HasModuleCalls() bool
  • func (m *Module) HasOutputs() bool
  • func (m *Module) HasProviders() bool
  • func (m *Module) HasRequirements() bool
  • func (m *Module) HasResources() bool
• type ModuleCall
  • func (mc *ModuleCall) FullName() string
• type Options
  • func NewOptions() *Options
  • func (o *Options) With(override *Options) (*Options, error)
  • func (o *Options) WithOverwrite(override *Options) (*Options, error)
• type Output
  • func (o *Output) GetValue() string
  • func (o *Output) HasDefault() bool
  • func (o *Output) MarshalJSON() ([]byte, error)
  • func (o *Output) MarshalXML(e *xml.Encoder, start xml.StartElement) error
  • func (o *Output) MarshalYAML() (interface{}, error)
• type Position
• type Provider
  • func (p *Provider) FullName() string
• type Requirement
• type Resource
  • func (r *Resource) FullType() string
  • func (r *Resource) URL() string
• type SortBy

Types

type Input

type Input struct {
	Name        string       `json:"name" toml:"name" xml:"name" yaml:"name"`
	Type        types.String `json:"type" toml:"type" xml:"type" yaml:"type"`
	Description types.String `json:"description" toml:"description" xml:"description" yaml:"description"`
	Default     types.Value  `json:"default" toml:"default" xml:"default" yaml:"default"`
	Required    bool         `json:"required" toml:"required" xml:"required" yaml:"required"`
	Position    Position     `json:"-" toml:"-" xml:"-" yaml:"-"`
}

Input represents a Terraform input.

func (*Input) GetValue

func (i *Input) GetValue() string

GetValue returns JSON representation of the 'Default' value, which is an 'interface'. If 'Default' is a primitive type, the primitive value of 'Default' will be returned and not the JSON formatted of it.

func (*Input) HasDefault

func (i *Input) HasDefault() bool

HasDefault indicates if a Terraform variable has a default value set.

type Module

type Module struct {
	XMLName xml.Name `json:"-" toml:"-" xml:"module" yaml:"-"`

	Header       string         `json:"header" toml:"header" xml:"header" yaml:"header"`
	Inputs       []*Input       `json:"inputs" toml:"inputs" xml:"inputs>input" yaml:"inputs"`
	ModuleCalls  []*ModuleCall  `json:"modules" toml:"modules" xml:"modules>module" yaml:"modules"`
	Outputs      []*Output      `json:"outputs" toml:"outputs" xml:"outputs>output" yaml:"outputs"`
	Providers    []*Provider    `json:"providers" toml:"providers" xml:"providers>provider" yaml:"providers"`
	Requirements []*Requirement `json:"requirements" toml:"requirements" xml:"requirements>requirement" yaml:"requirements"`
	Resources    []*Resource    `json:"resources" toml:"resources" xml:"resources>resource" yaml:"resources"`

	RequiredInputs []*Input `json:"-" toml:"-" xml:"-" yaml:"-"`
	OptionalInputs []*Input `json:"-" toml:"-" xml:"-" yaml:"-"`
}

Module represents a Terraform module. It consists of

- Header ('header' json key): Module header found in shape of multi line comments at the beginning of 'main.tf' - Inputs ('inputs' json key): List of input 'variables' extracted from the Terraform module .tf files - ModuleCalls ('modules' json key): List of 'modules' extracted from the Terraform module .tf files - Outputs ('outputs' json key): List of 'outputs' extracted from Terraform module .tf files - Providers ('providers' json key): List of 'providers' extracted from resources used in Terraform module - Requirements ('requirements' json key): List of 'requirements' extracted from the Terraform module .tf files - Resources ('resources' json key): List of 'resources' extracted from the Terraform module .tf files

func LoadWithOptions

func LoadWithOptions(options *Options) (*Module, error)

LoadWithOptions returns new instance of Module with all the inputs and outputs discovered from provided 'path' containing Terraform config

func (*Module) Convert

func (m *Module) Convert() terraformsdk.Module

Convert internal Module to its equivalent in plugin-sdk

func (*Module) HasHeader

func (m *Module) HasHeader() bool

HasHeader indicates if the module has header.

func (*Module) HasInputs

func (m *Module) HasInputs() bool

HasInputs indicates if the module has inputs.

func (*Module) HasModuleCalls

func (m *Module) HasModuleCalls() bool

HasModuleCalls indicates if the module has modulecalls.

func (*Module) HasOutputs

func (m *Module) HasOutputs() bool

HasOutputs indicates if the module has outputs.

func (*Module) HasProviders

func (m *Module) HasProviders() bool

HasProviders indicates if the module has providers.

func (*Module) HasRequirements

func (m *Module) HasRequirements() bool

HasRequirements indicates if the module has requirements.

func (*Module) HasResources

func (m *Module) HasResources() bool

HasResources indicates if the module has resources.

type ModuleCall

type ModuleCall struct {
	Name    string `json:"name"`
	Source  string `json:"source"`
	Version string `json:"version,omitempty"`
}

ModuleCall represents a submodule called by Terraform module.

func (*ModuleCall) FullName

func (mc *ModuleCall) FullName() string

FullName returns full name of the modulecall, with version if available

type Options

type Options struct {
	Path             string
	ShowHeader       bool
	HeaderFromFile   string
	SortBy           *SortBy
	OutputValues     bool
	OutputValuesPath string
}

Options contains required options to load a Module from path

func NewOptions

func NewOptions() *Options

NewOptions returns new instance of Options

func (*Options) With

func (o *Options) With(override *Options) (*Options, error)

With override options with existing Options

func (*Options) WithOverwrite

func (o *Options) WithOverwrite(override *Options) (*Options, error)

WithOverwrite override options with existing Options and overwrites non-empty items in destination

type Output

type Output struct {
	Name        string       `json:"name" toml:"name" xml:"name" yaml:"name"`
	Description types.String `json:"description" toml:"description" xml:"description" yaml:"description"`
	Value       types.Value  `json:"value,omitempty" toml:"value,omitempty" xml:"value,omitempty" yaml:"value,omitempty"`
	Sensitive   bool         `json:"sensitive,omitempty" toml:"sensitive,omitempty" xml:"sensitive,omitempty" yaml:"sensitive,omitempty"`
	Position    Position     `json:"-" toml:"-" xml:"-" yaml:"-"`
	ShowValue   bool         `json:"-" toml:"-" xml:"-" yaml:"-"`
}

Output represents a Terraform output.

func (*Output) GetValue

func (o *Output) GetValue() string

GetValue returns JSON representation of the 'Value', which is an 'interface'. If 'Value' is a primitive type, the primitive value of 'Value' will be returned and not the JSON formatted of it.

func (*Output) HasDefault

func (o *Output) HasDefault() bool

HasDefault indicates if a Terraform output has a default value set.

func (*Output) MarshalJSON

func (o *Output) MarshalJSON() ([]byte, error)

MarshalJSON custom yaml marshal function to take '--output-values' flag into consideration. It means if the flag is not set Value and Sensitive fields are set to 'omitempty', otherwise if output values are being shown 'omitempty' gets explicitly removed to show even empty and false values.

func (*Output) MarshalXML

func (o *Output) MarshalXML(e *xml.Encoder, start xml.StartElement) error

MarshalXML custom xml marshal function to take '--output-values' flag into consideration. It means if the flag is not set Value and Sensitive fields are set to 'omitempty', otherwise if output values are being shown 'omitempty' gets explicitly removed to show even empty and false values.

func (*Output) MarshalYAML

func (o *Output) MarshalYAML() (interface{}, error)

MarshalYAML custom yaml marshal function to take '--output-values' flag into consideration. It means if the flag is not set Value and Sensitive fields are set to 'omitempty', otherwise if output values are being shown 'omitempty' gets explicitly removed to show even empty and false values.

type Position

type Position struct {
	Filename string `json:"-" toml:"-" xml:"-" yaml:"-"`
	Line     int    `json:"-" toml:"-" xml:"-" yaml:"-"`
}

Position represents position of Terraform input or output in a file.

type Provider

type Provider struct {
	Name     string       `json:"name" toml:"name" xml:"name" yaml:"name"`
	Alias    types.String `json:"alias" toml:"alias" xml:"alias" yaml:"alias"`
	Version  types.String `json:"version" toml:"version" xml:"version" yaml:"version"`
	Position Position     `json:"-" toml:"-" xml:"-" yaml:"-"`
}

Provider represents a Terraform output.

func (*Provider) FullName

func (p *Provider) FullName() string

FullName returns full name of the provider, with alias if available

type Requirement

type Requirement struct {
	Name    string       `json:"name" xml:"name" yaml:"name"`
	Version types.String `json:"version" xml:"version" yaml:"version"`
}

Requirement represents a requirement for Terraform module.

type Resource

type Resource struct {
	Type           string       `json:"type" toml:"type" xml:"type" yaml:"type"`
	ProviderName   string       `json:"providerName" toml:"providerName" xml:"providerName" yaml:"providerName"`
	ProviderSource string       `json:"provicerSource" toml:"providerSource" xml:"providerSource" yaml:"providerSource"`
	Mode           string       `json:"mode" toml:"mode" xml:"mode" yaml:"mode"`
	Version        types.String `json:"version" toml:"version" xml:"version" yaml:"version"`
}

Resource represents a managed or data type that is created by the module

func (*Resource) FullType

func (r *Resource) FullType() string

FullType returns full name of the type of the resource, including the provider name

func (*Resource) URL

func (r *Resource) URL() string

URL returns a best guess at the URL for resource documentation

type SortBy

type SortBy struct {
	Name     bool
	Required bool
	Type     bool
}

SortBy contains different sort criteria corresponding to available flags (e.g. name, required, etc)