tflint

package
v0.27.0 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Apr 18, 2021 License: MPL-2.0 Imports: 34 Imported by: 1

Documentation

Overview

Package tflint is a generated GoMock package.

Index

Constants

View Source 
const (
	// EvaluationError is an error when interpolation failed (unexpected)
	EvaluationError string = "E:Evaluation"
	// UnknownValueError is an error when an unknown value is referenced
	UnknownValueError string = "W:UnknownValue"
	// NullValueError is an error when null value is referenced
	NullValueError string = "W:NullValue"
	// TypeConversionError is an error when type conversion of cty.Value failed
	TypeConversionError string = "E:TypeConversion"
	// TypeMismatchError is an error when a type of cty.Value is not as expected
	TypeMismatchError string = "E:TypeMismatch"
	// UnevaluableError is an error when a received expression has unevaluable references.
	UnevaluableError string = "W:Unevaluable"
	// UnexpectedAttributeError is an error when handle unexpected attributes (e.g. block)
	UnexpectedAttributeError string = "E:UnexpectedAttribute"
	// ExternalAPIError is an error when calling the external API (e.g. AWS SDK)
	ExternalAPIError string = "E:ExternalAPI"
	// ContextError is pseudo error code for propagating runtime context.
	ContextError string = "I:Context"

	// FatalLevel is a recorverable error, it cause panic
	FatalLevel string = "Fatal"
	// ErrorLevel is a user-level error, it display and feedback error information
	ErrorLevel string = "Error"
	// WarningLevel is a user-level warning. Although it is an error, it has no effect on execution.
	WarningLevel string = "Warning"
)
View Source 
const (
	// ERROR is possible errors
	ERROR = "Error"
	// WARNING doesn't cause problem immediately, but not good
	WARNING = "Warning"
	// NOTICE is not important, it's mentioned
	NOTICE = "Notice"
)
View Source 
const Version string = "0.27.0"

Version is application version

Variables

This section is empty.

Functions

func AssertAppError added in v0.13.0 

func AssertAppError(t *testing.T, expected Error, got error)

AssertAppError is an assertion helper for comparing tflint.Error

func AssertIssues added in v0.13.0 

func AssertIssues(t *testing.T, expected Issues, actual Issues)

AssertIssues is an assertion helper for comparing issues

func AssertIssuesWithoutRange added in v0.13.0 

func AssertIssuesWithoutRange(t *testing.T, expected Issues, actual Issues)

AssertIssuesWithoutRange is an assertion helper for comparing issues

func HCLBodyRange added in v0.17.0 

func HCLBodyRange(body hcl.Body, defRange hcl.Range) hcl.Range

HCLBodyRange attempts to find a range of the passed body

func ParseExpression added in v0.17.0 

func ParseExpression(src []byte, filename string, start hcl.Pos) (hcl.Expression, hcl.Diagnostics)

ParseExpression is a wrapper for a function that parses JSON and HCL expressions

func ParseTFVariables added in v0.13.0 

func ParseTFVariables(vars []string, declVars map[string]*configs.Variable) (terraform.InputValues, error)

ParseTFVariables parses the passed Terraform variable CLI arguments, and returns terraform.InputValues 

func ReferenceLink(name string) string

ReferenceLink returns the rule reference link

Types

type AbstractLoader 

type AbstractLoader interface {
	LoadConfig(string) (*configs.Config, error)
	LoadAnnotations(string) (map[string]Annotations, error)
	LoadValuesFiles(...string) ([]terraform.InputValues, error)
	Files() (map[string]*hcl.File, error)
	Sources() map[string][]byte
}

AbstractLoader is a loader interface for mock

type Annotation added in v0.13.0 

type Annotation struct {
	Content string
	Token   hclsyntax.Token
}

Annotation represents comments with special meaning in TFLint

func (*Annotation) IsAffected added in v0.13.0 

func (a *Annotation) IsAffected(issue *Issue) bool

IsAffected checks if the passed issue is affected with the annotation

func (*Annotation) String added in v0.13.0 

func (a *Annotation) String() string

String returns the string representation of the annotation

type Annotations added in v0.13.0 

type Annotations []Annotation

Annotations is slice of Annotation

func NewAnnotations added in v0.13.0 

func NewAnnotations(tokens hclsyntax.Tokens) Annotations

NewAnnotations find annotations from the passed tokens and return that list.

type Config 

type Config struct {
	Module            bool
	Force             bool
	IgnoreModules     map[string]bool
	Varfiles          []string
	Variables         []string
	DisabledByDefault bool
	Rules             map[string]*RuleConfig
	Plugins           map[string]*PluginConfig
}

Config describes the behavior of TFLint

func EmptyConfig 

func EmptyConfig() *Config

EmptyConfig returns default config It is mainly used for testing

func LoadConfig 

func LoadConfig(file string) (*Config, error)

LoadConfig loads TFLint config from file If failed to load the default config file, it tries to load config file under the home directory Therefore, if there is no default config file, it will not return an error

func (*Config) Merge 

func (c *Config) Merge(other *Config) *Config

Merge returns a merged copy of the two configs Since the argument takes precedence, it can be used as overwriting of the config

func (*Config) ToPluginConfig added in v0.14.0 

func (c *Config) ToPluginConfig(name string) *tfplugin.MarshalledConfig

ToPluginConfig converts self into the plugin configuration format

func (*Config) ValidateRules added in v0.14.0 

func (c *Config) ValidateRules(rulesets ...RuleSet) error

ValidateRules checks for duplicate rule names, for invalid rule names, and so on.

type Error 

type Error struct {
	Code    string
	Level   string
	Message string
	Cause   error
}

Error is application error object. It has own error code for processing according to a type of error.

func NewContextError added in v0.13.0 

func NewContextError(msg string, cause error) *Error

NewContextError makes a new context error

func (*Error) Error 

func (e *Error) Error() string

Error shows error message. This must be implemented for error interface.

type Issue added in v0.13.0 

type Issue struct {
	Rule    Rule
	Message string
	Range   hcl.Range
	Callers []hcl.Range
}

Issue represents a problem in configurations

type Issues added in v0.13.0 

type Issues []*Issue

Issues is an alias for the map of Issue

func (Issues) Sort added in v0.13.0 

func (issues Issues) Sort() Issues

Sort returns the sorted receiver

type Loader 

type Loader struct {
	// contains filtered or unexported fields
}

Loader is a wrapper of Terraform's configload.Loader

func NewLoader 

func NewLoader(fs afero.Afero, cfg *Config) (*Loader, error)

NewLoader returns a loader with module manifests

func (*Loader) Files added in v0.16.1 

func (l *Loader) Files() (map[string]*hcl.File, error)

Files returns a map of hcl.File pointers for every file that has been read by the loader. It uses the source cache to avoid re-loading the files from disk. These files can be used to do low level decoding of Terraform configuration.

func (*Loader) LoadAnnotations added in v0.13.0 

func (l *Loader) LoadAnnotations(dir string) (map[string]Annotations, error)

LoadAnnotations load TFLint annotation comments as HCL tokens.

func (*Loader) LoadConfig 

func (l *Loader) LoadConfig(dir string) (*configs.Config, error)

LoadConfig loads Terraform's configurations TODO: Can we use configload.LoadConfig instead?

func (*Loader) LoadValuesFiles 

func (l *Loader) LoadValuesFiles(files ...string) ([]terraform.InputValues, error)

LoadValuesFiles reads Terraform's values files and returns terraform.InputValues list in order of priority Pass values ​​files specified from the CLI as the arguments in order of priority This is the responsibility of the caller

func (*Loader) Sources added in v0.13.0 

func (l *Loader) Sources() map[string][]byte

Sources returns the source code cache for the underlying parser of this loader

type MockAbstractLoader added in v0.13.0 

type MockAbstractLoader struct {
	// contains filtered or unexported fields
}

MockAbstractLoader is a mock of AbstractLoader interface.

func NewMockAbstractLoader added in v0.13.0 

func NewMockAbstractLoader(ctrl *gomock.Controller) *MockAbstractLoader

NewMockAbstractLoader creates a new mock instance.

func (*MockAbstractLoader) EXPECT added in v0.13.0 

func (m *MockAbstractLoader) EXPECT() *MockAbstractLoaderMockRecorder

EXPECT returns an object that allows the caller to indicate expected use.

func (*MockAbstractLoader) Files added in v0.16.1 

func (m *MockAbstractLoader) Files() (map[string]*v2.File, error)

Files mocks base method.

func (*MockAbstractLoader) LoadAnnotations added in v0.13.0 

func (m *MockAbstractLoader) LoadAnnotations(arg0 string) (map[string]Annotations, error)

LoadAnnotations mocks base method.

func (*MockAbstractLoader) LoadConfig added in v0.13.0 

func (m *MockAbstractLoader) LoadConfig(arg0 string) (*configs.Config, error)

LoadConfig mocks base method.

func (*MockAbstractLoader) LoadValuesFiles added in v0.13.0 

func (m *MockAbstractLoader) LoadValuesFiles(arg0 ...string) ([]terraform.InputValues, error)

LoadValuesFiles mocks base method.

func (*MockAbstractLoader) Sources added in v0.13.0 

func (m *MockAbstractLoader) Sources() map[string][]byte

Sources mocks base method.

type MockAbstractLoaderMockRecorder added in v0.13.0 

type MockAbstractLoaderMockRecorder struct {
	// contains filtered or unexported fields
}

MockAbstractLoaderMockRecorder is the mock recorder for MockAbstractLoader.

func (*MockAbstractLoaderMockRecorder) Files added in v0.16.1 

func (mr *MockAbstractLoaderMockRecorder) Files() *gomock.Call

Files indicates an expected call of Files.

func (*MockAbstractLoaderMockRecorder) LoadAnnotations added in v0.13.0 

func (mr *MockAbstractLoaderMockRecorder) LoadAnnotations(arg0 interface{}) *gomock.Call

LoadAnnotations indicates an expected call of LoadAnnotations.

func (*MockAbstractLoaderMockRecorder) LoadConfig added in v0.13.0 

func (mr *MockAbstractLoaderMockRecorder) LoadConfig(arg0 interface{}) *gomock.Call

LoadConfig indicates an expected call of LoadConfig.

func (*MockAbstractLoaderMockRecorder) LoadValuesFiles added in v0.13.0 

func (mr *MockAbstractLoaderMockRecorder) LoadValuesFiles(arg0 ...interface{}) *gomock.Call

LoadValuesFiles indicates an expected call of LoadValuesFiles.

func (*MockAbstractLoaderMockRecorder) Sources added in v0.13.0 

func (mr *MockAbstractLoaderMockRecorder) Sources() *gomock.Call

Sources indicates an expected call of Sources.

type PluginConfig added in v0.13.0 

type PluginConfig struct {
	Name    string   `hcl:"name,label"`
	Enabled bool     `hcl:"enabled"`
	Body    hcl.Body `hcl:",remain"`
	// contains filtered or unexported fields
}

PluginConfig is a TFLint's plugin config

type Rule 

type Rule interface {
	Name() string
	Severity() string
	Link() string
}

Rule is interface for building the issue

type RuleConfig 

type RuleConfig struct {
	Name    string   `hcl:"name,label"`
	Enabled bool     `hcl:"enabled"`
	Body    hcl.Body `hcl:",remain"`
	// contains filtered or unexported fields
}

RuleConfig is a TFLint's rule config

func (*RuleConfig) Bytes added in v0.23.0 

func (r *RuleConfig) Bytes() []byte

Bytes returns the bytes of the configuration file declared in the rule.

type RuleSet added in v0.14.0 

type RuleSet interface {
	RuleSetName() (string, error)
	RuleSetVersion() (string, error)
	RuleNames() ([]string, error)
}

RuleSet is an interface to handle plugin's RuleSet and core RuleSet both In the future, when all RuleSets are cut out into plugins, it will no longer be needed.

type Runner 

type Runner struct {
	TFConfig *configs.Config
	Issues   Issues
	// contains filtered or unexported fields
}

Runner checks templates according rules. For variables interplation, it has Terraform eval context. After checking, it accumulates results as issues.

func NewModuleRunners 

func NewModuleRunners(parent *Runner) ([]*Runner, error)

NewModuleRunners returns new TFLint runners for child modules Recursively search modules and generate Runners In order to propagate attributes of moduleCall as variables to the module, evaluate the variables. If it cannot be evaluated, treat it as unknown

func NewRunner 

func NewRunner(c *Config, files map[string]*hcl.File, ants map[string]Annotations, cfg *configs.Config, variables ...terraform.InputValues) (*Runner, error)

NewRunner returns new TFLint runner It prepares built-in context (workpace metadata, variables) from received `configs.Config` and `terraform.InputValues`

func TestRunner added in v0.13.0 

func TestRunner(t *testing.T, files map[string]string) *Runner

TestRunner returns a runner for testing. Note that this runner ignores a config, annotations, and input variables.

func TestRunnerWithConfig added in v0.15.0 

func TestRunnerWithConfig(t *testing.T, files map[string]string, config *Config) *Runner

TestRunnerWithConfig returns a runner with passed config for testing.

func (*Runner) Backend added in v0.18.0 

func (r *Runner) Backend() *configs.Backend

Backend returns the backend configuration.

func (*Runner) DecodeRuleConfig added in v0.15.0 

func (r *Runner) DecodeRuleConfig(ruleName string, val interface{}) error

DecodeRuleConfig extracts the rule's configuration into the given value

func (*Runner) EmitIssue 

func (r *Runner) EmitIssue(rule Rule, message string, location hcl.Range)

EmitIssue builds an issue and accumulates it

func (*Runner) EnsureNoError 

func (r *Runner) EnsureNoError(err error, proc func() error) error

EnsureNoError is a helper for processing when no error occurs This function skips processing without returning an error to the caller when the error is warning

func (*Runner) EvalExpr added in v0.14.0 

func (r *Runner) EvalExpr(expr hcl.Expression, ret interface{}, wantType cty.Type) (cty.Value, error)

EvalExpr is a wrapper of terraform.BultinEvalContext.EvaluateExpr In addition, this method determines whether the expression is evaluable, contains no unknown values, and so on. The returned cty.Value is converted according to the value passed as `ret`.

func (*Runner) EvaluateBlock added in v0.13.0 

func (r *Runner) EvaluateBlock(block *hcl.Block, schema *configschema.Block, ret interface{}) error

EvaluateBlock is a wrapper of terraform.BultinEvalContext.EvaluateBlock and gocty.FromCtyValue

func (*Runner) EvaluateExpr 

func (r *Runner) EvaluateExpr(expr hcl.Expression, ret interface{}) error

EvaluateExpr evaluates the expression and reflects the result in the value of `ret`.

func (*Runner) File added in v0.16.1 

func (r *Runner) File(path string) *hcl.File

File returns the raw *hcl.File representation of a Terraform configuration at the specified path, or nil if there path does not match any configuration.

func (*Runner) Files added in v0.16.1 

func (r *Runner) Files() map[string]*hcl.File

Files returns the raw *hcl.File representation of all Terraform configuration in the module directory.

func (*Runner) IsNullExpr 

func (r *Runner) IsNullExpr(expr hcl.Expression) (bool, error)

IsNullExpr check the passed expression is null

func (*Runner) LookupIssues 

func (r *Runner) LookupIssues(files ...string) Issues

LookupIssues returns issues according to the received files

func (*Runner) LookupResourcesByType 

func (r *Runner) LookupResourcesByType(resourceType string) []*configs.Resource

LookupResourcesByType returns `configs.Resource` list according to the resource type

func (*Runner) RuleConfig added in v0.23.0 

func (r *Runner) RuleConfig(ruleName string) *RuleConfig

RuleConfig returns the corresponding rule configuration

func (*Runner) TFConfigPath 

func (r *Runner) TFConfigPath() string

TFConfigPath is a wrapper of addrs.Module

func (*Runner) WalkExpressions added in v0.16.0 

func (r *Runner) WalkExpressions(walker func(hcl.Expression) error) error

WalkExpressions visits all blocks that can contain expressions: resource, data, module, provider, locals, and output. It calls the walker function with every expression it encounters and halts if the walker returns an error.

func (*Runner) WalkModuleCalls added in v0.19.0 

func (r *Runner) WalkModuleCalls(walker func(*configs.ModuleCall) error) error

WalkModuleCalls walks all module calls and invokes the passed function

func (*Runner) WalkResourceAttributes 

func (r *Runner) WalkResourceAttributes(resource, attributeName string, walker func(*hcl.Attribute) error) error

WalkResourceAttributes searches for resources and passes the appropriate attributes to the walker function

func (*Runner) WalkResourceBlocks 

func (r *Runner) WalkResourceBlocks(resource, blockType string, walker func(*hcl.Block) error) error

WalkResourceBlocks walks all blocks of the passed resource and invokes the passed function

func (*Runner) WalkResources added in v0.17.0 

func (r *Runner) WalkResources(resource string, walker func(*configs.Resource) error) error

WalkResources walks all blocks of the passed resource and invokes the passed function

func (*Runner) WithExpressionContext added in v0.14.0 

func (r *Runner) WithExpressionContext(expr hcl.Expression, proc func() error) error

WithExpressionContext sets the context of the passed expression currently being processed.

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.