nogo

command
v1.0.1 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Apr 30, 2024 License: Apache-2.0, MIT Imports: 1 Imported by: 0

README

Extended "nogo" analysis

This package provides a build aspect that perform nogo analysis. This will be automatically injected to all relevant libraries when using the default go_binary and go_library rules.

It exists for several reasons.

  • The default nogo provided by bazel is insufficient with respect to the possibility of binary analysis. This package allows us to analyze the generated binary in addition to using the standard analyzers.

  • The configuration provided in this package is much richer than the standard nogo JSON blob. Specifically, it allows us to exclude specific structures from the composite rules (such as the Ranges that are common with the set types).

  • The bazel version of nogo is run directly against the go_library and go_binary targets, meaning that any change to the configuration requires a rebuild from scratch (for some reason included all C++ source files in the process). Using an aspect is more efficient in this regard.

  • The checks supported by this package are exported as tests, which makes it easier to reason about and plumb into the build system.

  • For uninteresting reasons, it is impossible to integrate the default nogo analyzer provided by bazel with internal Google tooling. To provide a consistent experience, this package allows those systems to be unified.

To use this package, import nogo_test from defs.bzl and add a single dependency which is a go_binary or go_library rule.

Documentation

Overview

Binary nogo performs static analysis.

Directories

Path Synopsis
Package check implements binary analysis similar to bazel's nogo, or the unitchecker package.
Package check implements binary analysis similar to bazel's nogo, or the unitchecker package.
Package cli implements a basic command line interface.
Package cli implements a basic command line interface.
Package config defines a filter configuration for nogo findings.
Package config defines a filter configuration for nogo findings.
Package facts implements alternate fact types.
Package facts implements alternate fact types.
Package flags contains globally-visible flags.
Package flags contains globally-visible flags.
Package sanity provides a basic sanity test.
Package sanity provides a basic sanity test.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL