config

Documentation

Index

• Constants
• type CloudQuery
• type Config
  • func (c Config) GetProvider(name string) (*Provider, error)
• type Connection
• type Parser
  • func NewParser(fs afero.Fs) *Parser
  • func (p *Parser) LoadConfigFile(path string) (*Config, hcl.Diagnostics)
  • func (p *Parser) LoadConfigFromJson(name string, data []byte) (*Config, hcl.Diagnostics)
  • func (p *Parser) LoadConfigFromSource(name string, data []byte) (*Config, hcl.Diagnostics)
  • func (p *Parser) LoadHCLFile(path string) (hcl.Body, hcl.Diagnostics)
• type Policy
• type PolicyQueries
• type PolicyView
• type Provider
• type RequiredProvider
  • func (r RequiredProvider) String() string
• type SourceType

Constants

const (
	SourceJSON = "json"
	SourceHCL  = "hcl"
)

Types

type CloudQuery

type CloudQuery struct {
	PluginDirectory string              `hcl:"plugin_directory,optional"`
	Logger          *logging.Config     `hcl:"logging,block"`
	Providers       []*RequiredProvider `hcl:"provider,block"`
	Connection      Connection          `hcl:"connection,block"`
}

type Config

type Config struct {
	CloudQuery CloudQuery  `hcl:"cloudquery,block"`
	Providers  []*Provider `hcl:"provider,block"`
}

func (Config) GetProvider

func (c Config) GetProvider(name string) (*Provider, error)

type Connection

type Connection struct {
	DSN string `hcl:"dsn,attr"`
}

type Parser

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

Parser is the main interface to read configuration files and other related files from disk.

It retains a cache of all files that are loaded so that they can be used to create source code snippets in diagnostics, etc.

func NewParser

func NewParser(fs afero.Fs) *Parser

NewParser creates and returns a new Parser that reads files from the given filesystem. If a nil filesystem is passed then the system's "real" filesystem will be used, via afero.OsFs.

func (*Parser) LoadConfigFile

func (p *Parser) LoadConfigFile(path string) (*Config, hcl.Diagnostics)

func (*Parser) LoadConfigFromJson

func (p *Parser) LoadConfigFromJson(name string, data []byte) (*Config, hcl.Diagnostics)

func (*Parser) LoadConfigFromSource

func (p *Parser) LoadConfigFromSource(name string, data []byte) (*Config, hcl.Diagnostics)

func (*Parser) LoadHCLFile

func (p *Parser) LoadHCLFile(path string) (hcl.Body, hcl.Diagnostics)

LoadHCLFile is a low-level method that reads the file at the given path, parses it, and returns the hcl.Body representing its root. In many cases it is better to use one of the other Load*File methods on this type, which additionally decode the root body in some way and return a higher-level construct.

If the file cannot be read at all -- e.g. because it does not exist -- then this method will return a nil body and error diagnostics. In this case callers may wish to ignore the provided error diagnostics and produce a more context-sensitive error instead.

The file will be parsed using the HCL native syntax unless the filename ends with ".json", in which case the HCL JSON syntax will be used.

type Policy

type Policy struct {
	Views   []PolicyView
	Queries []PolicyQueries
}

type PolicyQueries

type PolicyQueries struct {
	Name   string
	Invert bool
	Query  string
}

type PolicyView

type PolicyView struct {
	Name  string
	Query string
}

type Provider

type Provider struct {
	Name          string   `hcl:"name,label"`
	Alias         string   `hcl:"alias,optional"`
	Resources     []string `hcl:"resources,optional"`
	Env           []string `hcl:"env,optional"`
	Configuration hcl.Body `hcl:"configuration,body"`
}

type RequiredProvider

type RequiredProvider struct {
	Name    string `hcl:"name,label"`
	Source  string `hcl:"source,optional"`
	Version string `hcl:"version"`
}

func (RequiredProvider) String

func (r RequiredProvider) String() string

type SourceType

type SourceType string