bazel

Documentation

Index

• func PathFromLabel(label string, flags []string) (string, error)
• type Builder
  • func NewBuilder(opts *BuilderOptions) (*Builder, error)
  • func (b *Builder) BuildForBundle(engine string, sanitizers []string, fuzzTests []string) ([]*build.Result, error)
  • func (b *Builder) BuildForRun(fuzzTests []string) ([]*build.Result, error)
• type BuilderOptions
  • func (opts *BuilderOptions) Validate() error

Functions

func PathFromLabel

func PathFromLabel(label string, flags []string) (string, error)

PathFromLabel turns a bazel label into a valid path, which can for example be used to create the fuzz test's corpus directory. Flags which should be passed to the `bazel query` command can be passed via the flags argument (to avoid bazel discarding the analysis cache).

Types

type Builder

type Builder struct {
	*BuilderOptions
}

func NewBuilder

func NewBuilder(opts *BuilderOptions) (*Builder, error)

func (*Builder) BuildForBundle

func (b *Builder) BuildForBundle(engine string, sanitizers []string, fuzzTests []string) ([]*build.Result, error)

func (*Builder) BuildForRun

func (b *Builder) BuildForRun(fuzzTests []string) ([]*build.Result, error)

BuildForRun builds the specified fuzz tests with bazel. It expects labels of targets of the cc_fuzz_test rule provided by rules_fuzzing: https://github.com/bazelbuild/rules_fuzzing/blob/master/docs/cc-fuzzing-rules.md#cc_fuzz_test

TODO: Unfortunately, the cc_fuzz_test rule currently doesn't support combining sanitizers, so we can't build with both ASan and UBSan. Therefore, we only build with ASan and plan to upstream support for combining sanitizers.

type BuilderOptions

type BuilderOptions struct {
	ProjectDir string
	Engine     string
	NumJobs    uint
	Stdout     io.Writer
	Stderr     io.Writer
	TempDir    string
	Verbose    bool
}

func (*BuilderOptions) Validate

func (opts *BuilderOptions) Validate() error