bazel

Documentation

Index

• func BuildAndCreateCoverageReport(opts *CoverageOptions) (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
• type CoverageOptions

Functions

func BuildAndCreateCoverageReport

func BuildAndCreateCoverageReport(opts *CoverageOptions) (string, error)

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

type CoverageOptions

type CoverageOptions struct {
	FuzzTest     string
	OutputFormat string
	OutputPath   string
	ProjectDir   string
	Engine       string
	NumJobs      uint
	Stdout       io.Writer
	Stderr       io.Writer
	TempDir      string
	Verbose      bool
}