Add a flag to declare coverage dir as tree artifact

This adds an experimental flag that changes the behavior of tests when
run with coverage such that the _coverage directory is declared as a
tree artifact. This makes it significantly easier to debug coverage
runs when sandboxing (the default) or remote execution are enabled.
Without this, the files are implicitly ignored, and only the
coverage.dat file is brought back into the output tree. If for some
reason the additional steps to generate the coverage.dat file fail, then
that the file is empty or non-existent.

This also provides a workaround for languages that cannot currently
generate lcov format coverage data. By bringing back the individual
files, the user can use a post-process to merge the data.

It's not perfect, but it's simple and effective. I used it myself to
debug a coverage issue due to incorrect file paths w/ gcc on MacOS.

Unfortunately, the coverage collector script generates a number of
temporary files in the _coverage directory which we generally do not
want (or need) to bring back into the output tree. This will have to be
addressed separately.

PiperOrigin-RevId: 291940271
4 files changed
tree: 0c2e0944f741cc5026611db45e34d4acb30c9578
  1. .bazelci/
  2. examples/
  3. scripts/
  4. site/
  5. src/
  6. third_party/
  7. tools/
  8. .bazelrc
  9. .gitattributes
  10. .gitignore
  11. AUTHORS
  12. BUILD
  13. CHANGELOG.md
  14. CODEOWNERS
  15. combine_distfiles.py
  16. combine_distfiles_to_tar.sh
  17. compile.sh
  18. CONTRIBUTING.md
  19. CONTRIBUTORS
  20. distdir.bzl
  21. ISSUE_TEMPLATE.md
  22. LICENSE
  23. README.md
  24. WORKSPACE
README.md

Bazel

{Fast, Correct} - Choose two

Build and test software of any size, quickly and reliably.

  • Speed up your builds and tests: Bazel rebuilds only what is necessary. With advanced local and distributed caching, optimized dependency analysis and parallel execution, you get fast and incremental builds.

  • One tool, multiple languages: Build and test Java, C++, Android, iOS, Go, and a wide variety of other language platforms. Bazel runs on Windows, macOS, and Linux.

  • Scalable: Bazel helps you scale your organization, codebase, and continuous integration solution. It handles codebases of any size, in multiple repositories or a huge monorepo.

  • Extensible to your needs: Easily add support for new languages and platforms with Bazel's familiar extension language. Share and re-use language rules written by the growing Bazel community.

Getting Started

Documentation

Contributing to Bazel

See CONTRIBUTING.md

Build status