CallStack tidying and tests

General tidying and tests based on experience coming up to speed on the code
and planned upcoming changes.

Have CallStacks share an unmodifiable view of the shared string table in order
help guard against any mistakes.

Renamed CallStack.Builder->Factory, since this is really more of a factory than
a builder, and I think it makes its intended lifecycle more clear.

Updated a whole bunch of docs and comments to be more succinct and explain the
tight coupling with expected usage. Deleted a lot of the ephemeral performance
information since it was distracting from actual code contents. Replaced various
implementation comments with more descriptive names and where that didn't
suffice javadoc.

Tests use CallStackEntry's string representation - this seemed like an ok
compromise to avoid having to modify the starlark java api.

PiperOrigin-RevId: 367702882
4 files changed
tree: 6163294fb40ba716426c84cf7bb02d9d5172f681
  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. CODEBASE.md
  15. CODEOWNERS
  16. combine_distfiles.py
  17. combine_distfiles_to_tar.sh
  18. compile.sh
  19. CONTRIBUTING.md
  20. CONTRIBUTORS
  21. distdir.bzl
  22. distdir_deps.bzl
  23. ISSUE_TEMPLATE.md
  24. LICENSE
  25. README.md
  26. 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