merger

Documentation

Overview

Package merger provides methods for merging parsed BUILD files.

Index

• Variables
• func FixFile(c *config.Config, oldFile *bf.File) *bf.File
• func FixFileMinor(c *config.Config, oldFile *bf.File) *bf.File
• func FixLoads(oldFile *bf.File) *bf.File
• func MergeFile(genRules []bf.Expr, empty []bf.Expr, oldFile *bf.File, attrs map[string]bool) (mergedFile *bf.File, mergedRules []bf.Expr)

Variables

var (
	// MergeableGeneratedAttrs is the set of attributes that should be merged
	// before dependencies are resolved.
	MergeableGeneratedAttrs = map[string]bool{
		"cgo":        true,
		"clinkopts":  true,
		"copts":      true,
		"embed":      true,
		"importpath": true,
		"proto":      true,
		"srcs":       true,
	}

	// MergeableResolvedAttrs is the set of attributes that should be merged
	// after dependencies are resolved.
	MergeableResolvedAttrs = map[string]bool{
		"deps":                   true,
		config.GazelleImportsKey: true,
	}
)

Functions

func FixFile

func FixFile(c *config.Config, oldFile *bf.File) *bf.File

FixFile updates rules in oldFile that were generated by an older version of Gazelle to a newer form that can be merged with freshly generated rules.

FixLoads should be called after this, since it will fix load statements that may be broken by transformations applied by this function.

func FixFileMinor

func FixFileMinor(c *config.Config, oldFile *bf.File) *bf.File

FixFileMinor updates rules in oldFile that were generated by an older version of Gazelle to a newer form that can be merged with freshly generated rules.

FixFileMinor includes only small, low-risk fixes that can be applied in update mode. When both FixFileMinor and FixFile are called, FixFileMinor should be called first.

FixLoads should be called after this, since it will fix load statements that may be broken by transformations applied by this function.

func FixLoads

func FixLoads(oldFile *bf.File) *bf.File

FixLoads removes loads of unused go rules and adds loads of newly used rules. This should be called after FixFile and MergeWithExisting, since symbols may be introduced that aren't loaded.

func MergeFile

func MergeFile(genRules []bf.Expr, empty []bf.Expr, oldFile *bf.File, attrs map[string]bool) (mergedFile *bf.File, mergedRules []bf.Expr)

MergeFile merges the rules in genRules with matching rules in oldFile and adds unmatched rules to the end of the merged file. MergeFile also merges rules in empty with matching rules in oldFile and deletes rules that are empty after merging. attrs is the set of attributes to merge. Attributes not in this set will be left alone if they already exist.