Documentation ¶
Index ¶
- Variables
- func ExpFunctions(baseDir string, logger zerolog.Logger) map[string]function.Function
- func SetUUIDAttributes(address string, moduleBlock *Block, block *hcl.Block)
- type Attribute
- func (attr *Attribute) AllReferences() []*Reference
- func (attr *Attribute) AsInt() int64
- func (attr *Attribute) AsString() string
- func (attr *Attribute) Equals(val interface{}) bool
- func (attr *Attribute) HasChanged() (change bool)
- func (attr *Attribute) IsIterable() bool
- func (attr *Attribute) Name() string
- func (attr *Attribute) Reference() (*Reference, error)
- func (attr *Attribute) Value() cty.Value
- type Block
- func (b *Block) AttributesAsMap() map[string]*Attribute
- func (b *Block) CallDetails() []ModuleMetadata
- func (b *Block) Children() Blocks
- func (b *Block) Context() *Context
- func (b *Block) FullName() string
- func (b *Block) GetAttribute(name string) *Attribute
- func (b *Block) GetAttributes() []*Attribute
- func (b *Block) GetChildBlock(name string) *Block
- func (b *Block) GetChildBlocks(name string) []*Block
- func (b *Block) HasChild(childElement string) bool
- func (b *Block) HasModuleBlock() bool
- func (b *Block) Index() *int64
- func (b *Block) InjectBlock(block *Block, name string)
- func (b *Block) IsCountExpanded() bool
- func (b *Block) IsForEachReferencedExpanded(moduleBlocks Blocks) bool
- func (b *Block) Key() *string
- func (b *Block) Label() string
- func (b *Block) Labels() []string
- func (b *Block) LocalName() string
- func (b *Block) ModuleAddress() string
- func (b *Block) ModuleName() string
- func (b *Block) ModuleSource() string
- func (b *Block) NameLabel() string
- func (b *Block) Provider() string
- func (b *Block) Reference() *Reference
- func (b *Block) RemoveDynamicBlocks(name string)
- func (b *Block) SetContext(ctx *Context)
- func (b *Block) ShouldExpand() bool
- func (b *Block) Type() string
- func (b *Block) TypeLabel() string
- func (b *Block) Values() cty.Value
- type BlockBuilder
- type BlockMatcher
- type BlockValueFunc
- type Blocks
- type Context
- func (c *Context) Get(parts ...string) (val cty.Value)
- func (c *Context) Inner() *hcl.EvalContext
- func (c *Context) NewChild() *Context
- func (c *Context) Parent() *Context
- func (c *Context) Root() *Context
- func (c *Context) Set(val cty.Value, parts ...string)
- func (c *Context) SetByDot(val cty.Value, path string)
- type Evaluator
- type Module
- type ModuleCall
- type ModuleMetadata
- type Option
- func OptionWithInputVars(vars map[string]string) Option
- func OptionWithModuleSuffix(suffix string) Option
- func OptionWithPlanFlagVars(vs []string) Option
- func OptionWithRawCtyInput(input cty.Value) (op Option)
- func OptionWithRemoteVarLoader(host, token, localWorkspace string) Option
- func OptionWithTFEnvVars(projectEnv map[string]string) Option
- func OptionWithTFVarsPaths(paths []string) Option
- func OptionWithTerraformWorkspace(name string) Option
- type Parser
- type ProjectLocator
- type ProjectLocatorConfig
- type Reference
- type RemoteVariablesLoader
- type RemoteVariablesLoaderOption
- type RootPath
- type SetAttributesFunc
- type Type
- type Warning
- type WarningCode
Constants ¶
This section is empty.
Variables ¶
var TypeData = Type{ // contains filtered or unexported fields }
var TypeLocal = Type{ // contains filtered or unexported fields }
var TypeModule = Type{ // contains filtered or unexported fields }
var TypeOutput = Type{ // contains filtered or unexported fields }
var TypeProvider = Type{ // contains filtered or unexported fields }
var TypeResource = Type{ // contains filtered or unexported fields }
var TypeTerraform = Type{ // contains filtered or unexported fields }
var TypeVariable = Type{ // contains filtered or unexported fields }
var ValidTypes = []Type{ TypeData, TypeLocal, TypeModule, TypeOutput, TypeProvider, TypeResource, TypeTerraform, TypeVariable, }
Functions ¶
func ExpFunctions ¶
ExpFunctions returns the set of functions that should be used to when evaluating expressions in the receiving scope.
func SetUUIDAttributes ¶
SetUUIDAttributes adds commonly used identifiers to the block so that it can be referenced by other blocks in context evaluation. The identifiers are only set if they don't already exist as attributes on the block.
Types ¶
type Attribute ¶
type Attribute struct { // HCLAttr is the underlying hcl.Attribute that the Attribute references. HCLAttr *hcl.Attribute // Ctx is the context that the Attribute should be evaluated against. This propagates // any references from variables into the attribute. Ctx *Context // Verbose defines if the attribute should log verbose diagnostics messages to debug. Verbose bool Logger zerolog.Logger // contains filtered or unexported fields }
Attribute provides a wrapper struct around hcl.Attribute it provides helper methods and functionality for common interactions with hcl.Attribute.
Attributes are key/value pairs that are part of a Block. For example take the following Block:
resource "aws_instance" "t3_standard" { ami = "fake_ami" instance_type = "t3.medium" credit_specification { cpu_credits = "standard" } }
"ami" & "instance_type" are the Attributes of this Block, "credit_specification" is a child Block see Block.Children for more info.
func (*Attribute) AllReferences ¶
AllReferences returns a list of References for the given Attribute. This can include the main Value Reference (see Reference method) and also a list of references used in conditional evaluation and templating.
func (*Attribute) AsInt ¶
AsInt returns the Attribute value as a int64. If the cty.Value is not a type that can be converted to integer, this method returns 0.
func (*Attribute) AsString ¶
AsString returns the Attribute value as a string. If the cty.Value is not a type that can be converted to string, this method returns an empty string.
func (*Attribute) HasChanged ¶
HasChanged returns if the Attribute Value has changed since Value was last called.
func (*Attribute) IsIterable ¶
IsIterable returns if the attribute can be ranged over.
func (*Attribute) Reference ¶
Reference returns the pointer to a Reference struct that holds information about the Attributes referenced block. Reference achieves this by traversing the Attribute Expression in order to find the parent block. E.g. with the following HCL
resource "aws_launch_template" "foo2" { name = "foo2" } resource "some_resource" "example_with_launch_template_3" { ... name = aws_launch_template.foo2.name }
The Attribute some_resource.name would have a reference of
Reference { blockType: Type{ name: "resource", removeTypeInReference: true, } typeLabel: "aws_launch_template" nameLabel: "foo2" }
Reference is used to build up a Terraform JSON configuration file that holds information about the expressions and their parents. Infracost uses these references in resource evaluation to lookup connecting resource information.
type Block ¶
type Block struct { Filename string StartLine int EndLine int // contains filtered or unexported fields }
Block wraps a hcl.Block type with additional methods and context. A Block is a core piece of HCL schema and represents a set of data. Most importantly a Block directly corresponds to a schema.Resource.
Blocks can represent a number of different types - see terraformSchemaV012 for a list of potential HCL blocks available.
e.g. a type resource block could look like this in HCL:
resource "aws_lb" "lb1" { load_balancer_type = "application" }
A Block can also have a set number of child Blocks, these child Blocks in turn can also have children. Blocks are recursive. The following example is represents a resource Block with child Blocks:
resource "aws_instance" "t3_standard_cpuCredits" { ami = "fake_ami" instance_type = "t3.medium" # child Block starts here credit_specification { cpu_credits = "standard" } }
See Attribute for more info about how the values of Blocks are evaluated with their Context and returned.
func (*Block) AttributesAsMap ¶
AttributesAsMap returns the Attributes of this block as a map with the attribute name as the key and the value as the Attribute.
func (*Block) CallDetails ¶
func (b *Block) CallDetails() []ModuleMetadata
CallDetails returns the tree of module calls that were used to create this resource. Each step of the tree contains a full file path and block name that were used to create the resource.
CallDetails returns a list of ModuleMetadata that are ordered by appearance in the Terraform config tree.
func (*Block) FullName ¶
FullName returns the fully qualified Reference name as it relates to the Blocks position in the entire Terraform config tree. This includes module name. e.g.
The following resource residing in a module named "web_app":
resource "aws_instance" "t3_standard" { ami = "fake_ami" instance_type = var.instance_type }
Would have its FullName as module.web_app.aws_instance.t3_standard FullName is what Terraform uses in its JSON output file.
func (*Block) GetAttribute ¶
GetAttribute returns the given attribute with the provided name. It will return nil if the attribute is not found. If we take the following Block example:
resource "aws_instance" "t3_standard_cpuCredits" { ami = "fake_ami" instance_type = "t3.medium" credit_specification { cpu_credits = "standard" } }
ami & instance_type are both valid Attribute names that can be used to lookup Block Attributes.
func (*Block) GetAttributes ¶
GetAttributes returns a list of Attribute for this Block. Attributes are key value specification on a given Block. For example take the following hcl:
resource "aws_instance" "t3_standard_cpuCredits" { ami = "fake_ami" instance_type = "t3.medium" credit_specification { cpu_credits = "standard" } }
ami & instance_type are the Attributes of this Block and credit_specification is a child Block.
func (*Block) GetChildBlock ¶
GetChildBlock is a helper method around GetChildBlocks. It returns the first non nil child block matching name.
func (*Block) GetChildBlocks ¶
GetChildBlocks returns all the child Block that match the name provided. e.g: If the current Block looks like such:
resource "aws_instance" "t3_standard_cpuCredits" { ami = "fake_ami" instance_type = "t3.medium" credit_specification { cpu_credits = "standard" } ebs_block_device { device_name = "xvdj" } }
Then "credit_specification" & "ebs_block_device" would be valid names that could be used to retrieve child Blocks.
func (*Block) HasModuleBlock ¶
HasModuleBlock returns is the Block as a module associated with it. If it doesn't this means that this Block is part of the root Module.
func (*Block) Index ¶
Index returns the count index of the block using the name label. Index returns nil if the block has no count.
func (*Block) InjectBlock ¶
InjectBlock takes a block and appends it to the Blocks childBlocks with the Block's attributes set as contextual values on the child. In most cases this is because we've expanded the block into further Blocks as part of a count or for_each.
func (*Block) IsCountExpanded ¶
IsCountExpanded returns if the Block has been expanded as part of a for_each or count evaluation.
func (*Block) IsForEachReferencedExpanded ¶
IsForEachReferencedExpanded checks if the block referenced under the for_each has already been expanded. This is used to check is we can safely expand this block, expanding block prematurely can lead to output inconsistencies. It is advised to always check if that the block has any references that are yet to be expanded before expanding itself.
func (*Block) Key ¶
Key returns the foreach key of the block using the name label. Key returns nil if the block has no each key.
func (*Block) ModuleAddress ¶
ModuleAddress returns the address of the module associated with this Block or "" if it is part of the root Module
func (*Block) ModuleName ¶
ModuleName returns the name of the module associated with this Block or "" if it is part of the root Module
func (*Block) ModuleSource ¶
ModuleSource returns the "source" attribute from the associated Module or "" if it is part of the root Module
func (*Block) Provider ¶
Provider returns the provider by first checking if it is explicitly set as an attribute, if it is not the first word in the snake_case name of the type is returned. E.g. the type 'aws_instance' would return provider 'aws'
func (*Block) Reference ¶
Reference returns a Reference to the given Block this can be used to when printing out full names of Blocks to stdout or a file.
func (*Block) RemoveDynamicBlocks ¶
RemoveDynamicBlocks removes all the child Blocks of type name that have a parent of type "dynamic".
func (*Block) SetContext ¶
SetContext sets the Block.context to the provided ctx. This ctx is also set on the child Blocks as a child Context. Meaning that it can be used in traversal evaluation when looking up Context variables.
func (*Block) ShouldExpand ¶
func (*Block) Values ¶
Values returns the Block as a cty.Value with all the Attributes evaluated with the Block Context. This means that any variables or references will be replaced by their actual value. For example:
variable "instance_type" { default = "t3.medium" } resource "aws_instance" "t3_standard_cpucredits" { ami = "fake_ami" instance_type = var.instance_type }
Would evaluate to a cty.Value of type Object with the instance_type Attribute holding the value "t3.medium".
type BlockBuilder ¶
type BlockBuilder struct { MockFunc func(a *Attribute) cty.Value SetAttributes []SetAttributesFunc Logger zerolog.Logger }
BlockBuilder handles generating new Blocks as part of the parsing and evaluation process.
func (BlockBuilder) BuildModuleBlocks ¶
func (b BlockBuilder) BuildModuleBlocks(block *Block, modulePath string, rootPath string) (Blocks, error)
BuildModuleBlocks loads all the Blocks for the module at the given path
func (BlockBuilder) CloneBlock ¶
func (b BlockBuilder) CloneBlock(block *Block, index cty.Value) *Block
CloneBlock creates a duplicate of the block and sets the returned Block's Context to include the index provided. This is primarily used when Blocks are expanded as part of a count evaluation.
type BlockMatcher ¶
BlockMatcher defines a struct that can be used to filter a list of blocks to a single Block.
type BlockValueFunc ¶
BlockValueFunc defines a type that returns a set of fake/mocked values for a given block type.
type Blocks ¶
type Blocks []*Block
Blocks is a helper type around a slice of blocks to provide easy access finding blocks of type.
func (Blocks) Matching ¶
func (blocks Blocks) Matching(pattern BlockMatcher) *Block
Matching returns a single block filtered from the given pattern. If more than one Block is filtered by the pattern, Matching returns the first Block found.
func (Blocks) ModuleBlocks ¶
ModuleBlocks is a wrapper around SortedByCaller that selects just Modules to be sorted.
func (Blocks) OfType ¶
OfType returns Blocks of the given type t. See terraformSchemaV012 for a list of possible types to lookup.
func (Blocks) SortedByCaller ¶
SortedByCaller returns all the Blocks of type module. The returned Blocks are sorted in order of reference. Blocks that are referenced by others are the first in this list.
So if we start with a list of [A,B,C] and A references B the returned list will be [B,A,C].
This makes the list returned safe for context evaluation, as we evaluate modules that have outputs that other modules rely on first.
type Evaluator ¶
type Evaluator struct {
// contains filtered or unexported fields
}
Evaluator provides a set of given Blocks with contextual information. Evaluator is an important step in retrieving Block values that can be used in the schema.Resource cost retrieval. Without Evaluator the Blocks provided only have shallow information within attributes and won't contain any evaluated variables or references.
func NewEvaluator ¶
func NewEvaluator( module Module, workingDir string, inputVars map[string]cty.Value, moduleMetadata *modules.Manifest, visitedModules map[string]map[string]cty.Value, workspace string, blockBuilder BlockBuilder, logger zerolog.Logger, parentContext *Context, ) *Evaluator
NewEvaluator returns an Evaluator with Context initialised with top level variables. This Context is then passed to all Blocks as child Context so that variables built in Evaluation are propagated to the Block Attributes.
func (*Evaluator) MissingVars ¶
MissingVars returns a list of names of the variable blocks with missing input values.
func (*Evaluator) Run ¶
Run builds the Evaluator Context using all the provided Blocks. It will build up the Context to hold variable and reference information so that this can be used by Attribute evaluation. Run will also parse and build up and child modules that are referenced in the Blocks and runs child Evaluator on this Module.
type Module ¶
type Module struct { Name string Source string Blocks Blocks // RawBlocks are the Blocks that were built when the module was loaded from the filesystem. // These are safe to pass to the child module calls as they are yet to be expanded. RawBlocks Blocks RootPath string ModulePath string Modules []*Module Parent *Module Warnings []Warning HasChanges bool TerraformVarsPaths []string // ModuleSuffix is a unique name that can be optionally appended to the Module's project name. // This is only applicable to root modules. ModuleSuffix string }
Module encapsulates all the Blocks that are part of a Module in a Terraform project.
type ModuleCall ¶
type ModuleCall struct { // Name the name of the module as specified a the point of definition. Name string // Path is the path to the local directory containing the HCL for the Module. Path string // Definition is the actual Block where the ModuleCall happens in a hcl.File Definition *Block // Module contains the parsed root module that represents this ModuleCall. Module *Module }
ModuleCall represents a call to a defined Module by a parent Module.
type ModuleMetadata ¶
type Option ¶
type Option func(p *Parser)
func OptionWithInputVars ¶
OptionWithInputVars takes cmd line var input values and converts them to cty.Value It sets these as the Parser starting inputVars which are used at the root module evaluation.
func OptionWithModuleSuffix ¶
OptionWithModuleSuffix sets an optional module suffix which will be added to the Module after it has finished parsing this can be used to augment auto-detected project path names and metadata.
func OptionWithPlanFlagVars ¶
OptionWithPlanFlagVars takes TF var inputs specified in a command line string and converts them to cty.Value It sets these as the Parser starting inputVars which are used at the root module evaluation.
func OptionWithRawCtyInput ¶
OptionWithRawCtyInput sets the input variables for the parser using a cty.Value. OptionWithRawCtyInput expects that this input is a ObjectValue that can be transformed to a map.
func OptionWithRemoteVarLoader ¶
OptionWithRemoteVarLoader accepts Terraform Cloud/Enterprise host and token values to load remote execution variables.
func OptionWithTFEnvVars ¶
OptionWithTFEnvVars takes any TF_ENV_xxx=yyy from the environment and converts them to cty.Value It then sets these as the Parser starting tfEnvVars which are used at the root module evaluation.
func OptionWithTFVarsPaths ¶
OptionWithTFVarsPaths takes a slice of paths and sets them on the parser relative to the Parser initialPath. Paths that don't exist will be ignored.
func OptionWithTerraformWorkspace ¶
OptionWithTerraformWorkspace informs the Parser to use the provided name as the workspace for context evaluation. The Parser exposes this workspace in the evaluation context under the variable named `terraform.workspace`. This is commonly used by users to specify different capacity/configuration in their Terraform, e.g:
terraform.workspace == "prod" ? "m5.8xlarge" : "m5.4xlarge"
type Parser ¶
type Parser struct {
// contains filtered or unexported fields
}
Parser is a tool for parsing terraform templates at a given file system location.
func LoadParsers ¶
func LoadParsers(ctx *config.ProjectContext, initialPath string, loader *modules.ModuleLoader, locatorConfig *ProjectLocatorConfig, logger zerolog.Logger, options ...Option) ([]*Parser, error)
LoadParsers inits a list of Parser with the provided option and initialPath. LoadParsers locates Terraform files in the given initialPath and returns a Parser for each directory it locates a Terraform project within. If the initialPath contains Terraform files at the top level parsers will be len 1.
func (*Parser) ParseDirectory ¶
ParseDirectory parses all the terraform files in the initialPath into Blocks and then passes them to an Evaluator to fill these Blocks with additional Context information. Parser does not parse any blocks outside the root Module. It instead leaves ModuleLoader to fetch these Modules on demand. See ModuleLoader.Load for more information.
ParseDirectory returns the root Module that represents the top of the Terraform Config tree.
type ProjectLocator ¶
type ProjectLocator struct {
// contains filtered or unexported fields
}
ProjectLocator finds Terraform projects for given paths. It naively excludes folders that are imported as modules in other projects.
func NewProjectLocator ¶
func NewProjectLocator(logger zerolog.Logger, config *ProjectLocatorConfig) *ProjectLocator
NewProjectLocator returns safely initialized ProjectLocator.
func (*ProjectLocator) FindRootModules ¶
func (p *ProjectLocator) FindRootModules(fullPath string) []RootPath
FindRootModules returns a list of all directories that contain a full Terraform project under the given fullPath. This list excludes any Terraform modules that have been found (if they have been called by a Module source).
type ProjectLocatorConfig ¶
type ProjectLocatorConfig struct { ExcludedSubDirs []string ChangedObjects []string UseAllPaths bool }
ProjectLocatorConfig provides configuration options on how the locator functions.
type Reference ¶
type Reference struct {
// contains filtered or unexported fields
}
func (*Reference) JSONString ¶
JSONString returns the reference so that it's possible to use in the plan JSON file. This strips any count keys from the reference.
type RemoteVariablesLoader ¶
type RemoteVariablesLoader struct {
// contains filtered or unexported fields
}
RemoteVariablesLoader handles loading remote variables from Terraform Cloud.
func NewRemoteVariablesLoader ¶
func NewRemoteVariablesLoader(client *extclient.AuthedAPIClient, localWorkspace string, logger zerolog.Logger, opts ...RemoteVariablesLoaderOption) *RemoteVariablesLoader
NewRemoteVariablesLoader constructs a new loader for fetching remote variables.
type RemoteVariablesLoaderOption ¶
type RemoteVariablesLoaderOption func(r *RemoteVariablesLoader)
RemoteVariablesLoaderOption defines a function that can set properties on an RemoteVariablesLoader.
type RootPath ¶
type RootPath struct { Path string // HasChanges contains information about whether the project has git changes associated with it. // This will show as true if one or more files/directories have changed in the Path, and also if // and local modules that are used by this project have changes. HasChanges bool // TerraformVarFiles are a list of any .tfvars or .tfvars.json files found at the root level. TerraformVarFiles []string }
RootPath holds information about the root directory of a project, this is normally the top level Terraform containing provider blocks.
type SetAttributesFunc ¶
SetAttributesFunc defines a function that sets required attributes on a hcl.Block. This is done so that identifiers that are normally propagated from a Terraform state/apply are set on the Block. This means they can be used properly in references and outputs.
type Warning ¶
type Warning struct { Code WarningCode Title string Data interface{} // FriendlyMessage should be used to display a readable message to the CLI user. FriendlyMessage string }
Warning holds information about non-critical errors that occurred within a module evaluation.
func NewMissingVarsWarning ¶
NewMissingVarsWarning returns a Warning using the WarningMissingVars error code. It expects that vars is a list of Terraform variables that cannot be found in the evaluation context.
type WarningCode ¶
type WarningCode int
WarningCode is used to delineate warnings across Infracost.
const (
WarningMissingVars WarningCode = iota + 1
)