Getting Started:

Install the Python library from PyPI:

pip install noodle-bucket

This provides import bucket and the bucket CLI. It is enough to define coverpoints, collect coverage, and write .bktgz / SQL / JSON / console output. View results in the hosted viewer or the desktop app — see Viewing coverage.

HTML generation (write html / write report) is not part of the pip package; it needs a source checkout of this repository and Node.js.

To run the in-repo example, which includes a coverage tree along with some randomised data to sample:

$ ./bin/shell
$ python -m example.example

Below describes how to use Bucket to create a coverage tree, sample your data and then merge the results. Examples of coverpoints in use can be seen in cats.py and dogs.py.

Contents

  1. Introduction
  2. Coverpoints
  3. Covergroups
  4. Covertop
  5. Adding coverage to the testbench
  6. Exporting and merging coverage
  7. Reading and Writing
  8. Viewing coverage