parser

Documentation

Index

• func Check(ctx context.Context, parser Parser, nodes []*yaml.Node) error
• func List() []string
• func Pin(ctx context.Context, res resolver.Resolver, parser Parser, nodes []*yaml.Node, ...) error
• func Unpin(ctx context.Context, nodes []*yaml.Node) error
• func Upgrade(ctx context.Context, res resolver.Resolver, parser Parser, nodes []*yaml.Node, ...) error
• type Actions
  • func (a *Actions) DenormalizeRef(ref string) string
  • func (a *Actions) Parse(nodes []*yaml.Node) (*RefsList, error)
• type CircleCI
  • func (c *CircleCI) DenormalizeRef(ref string) string
  • func (c *CircleCI) Parse(nodes []*yaml.Node) (*RefsList, error)
• type CloudBuild
  • func (c *CloudBuild) DenormalizeRef(ref string) string
  • func (c *CloudBuild) Parse(nodes []*yaml.Node) (*RefsList, error)
• type Drone
  • func (d *Drone) DenormalizeRef(ref string) string
  • func (d *Drone) Parse(nodes []*yaml.Node) (*RefsList, error)
• type GitLabCI
  • func (c *GitLabCI) DenormalizeRef(ref string) string
  • func (c *GitLabCI) Parse(nodes []*yaml.Node) (*RefsList, error)
• type Parser
  • func For(ctx context.Context, name string) (Parser, error)
• type RefsList
  • func (l *RefsList) Add(ref string, m *yaml.Node)
  • func (l *RefsList) All() map[string][]*yaml.Node
  • func (l *RefsList) Refs() []string
• type Tekton
  • func (t *Tekton) DenormalizeRef(ref string) string
  • func (t *Tekton) Parse(nodes []*yaml.Node) (*RefsList, error)

Functions

func Check

func Check(ctx context.Context, parser Parser, nodes []*yaml.Node) error

Check iterates over all references in the yaml and checks if they are pinned to an absolute reference. It ignores "ratchet:exclude" nodes from the lookup.

func List

func List() []string

List returns the list of parsers.

func Pin

func Pin(ctx context.Context, res resolver.Resolver, parser Parser, nodes []*yaml.Node, concurrency int64) error

Pin extracts all references from the given YAML document and resolves them using the given resolver, updating the associated YAML nodes.

func Unpin

func Unpin(ctx context.Context, nodes []*yaml.Node) error

Unpin removes any pinned references and updates the actual YAML to be the original reference, leaving any other comment intact. This effectively replaces the YAML with the cached comment, which could result in losing the current pin.

This function does not make any outbound network calls and relies solely on information in the document.

func Upgrade

func Upgrade(ctx context.Context, res resolver.Resolver, parser Parser, nodes []*yaml.Node, concurrency int64) error

Types

type Actions

type Actions struct{}

func (*Actions) DenormalizeRef

func (a *Actions) DenormalizeRef(ref string) string

DenormalizeRef changes the resolved ref into a ref that the parser expects.

func (*Actions) Parse

func (a *Actions) Parse(nodes []*yaml.Node) (*RefsList, error)

Parse pulls the GitHub Actions refs from the documents.

type CircleCI

type CircleCI struct{}

func (*CircleCI) DenormalizeRef

func (c *CircleCI) DenormalizeRef(ref string) string

DenormalizeRef changes the resolved ref into a ref that the parser expects.

func (*CircleCI) Parse

func (c *CircleCI) Parse(nodes []*yaml.Node) (*RefsList, error)

Parse pulls the CircleCI refs from the documents. Unfortunately it does not process "orbs" because there is no documented API for resolving orbs to an absolute version.

type CloudBuild

type CloudBuild struct{}

func (*CloudBuild) DenormalizeRef

func (c *CloudBuild) DenormalizeRef(ref string) string

DenormalizeRef changes the resolved ref into a ref that the parser expects.

func (*CloudBuild) Parse

func (c *CloudBuild) Parse(nodes []*yaml.Node) (*RefsList, error)

Parse pulls the Google Cloud Build refs from the documents.

type Drone

type Drone struct{}

func (*Drone) DenormalizeRef

func (d *Drone) DenormalizeRef(ref string) string

DenormalizeRef changes the resolved ref into a ref that the parser expects.

func (*Drone) Parse

func (d *Drone) Parse(nodes []*yaml.Node) (*RefsList, error)

Parse pulls the Drone Ci refs from the documents.

type GitLabCI

type GitLabCI struct{}

func (*GitLabCI) DenormalizeRef

func (c *GitLabCI) DenormalizeRef(ref string) string

DenormalizeRef changes the resolved ref into a ref that the parser expects.

func (*GitLabCI) Parse

func (c *GitLabCI) Parse(nodes []*yaml.Node) (*RefsList, error)

Parse pulls the image references from GitLab CI configuration files. It does not support references with variables.

type Parser

type Parser interface {
	DenormalizeRef(ref string) string
	Parse(nodes []*yaml.Node) (*RefsList, error)
}

Parser defines an interface which parses references out of the given yaml node.

func For

func For(ctx context.Context, name string) (Parser, error)

For returns the parser that corresponds to the given name.

type RefsList

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

func (*RefsList) Add

func (l *RefsList) Add(ref string, m *yaml.Node)

func (*RefsList) All

func (l *RefsList) All() map[string][]*yaml.Node

func (*RefsList) Refs

func (l *RefsList) Refs() []string

type Tekton

type Tekton struct{}

func (*Tekton) DenormalizeRef

func (t *Tekton) DenormalizeRef(ref string) string

DenormalizeRef changes the resolved ref into a ref that the parser expects.

func (*Tekton) Parse

func (t *Tekton) Parse(nodes []*yaml.Node) (*RefsList, error)

Parse pulls the Tekton Ci refs from the documents.