bazel syntax: make Parser private

Parser:
- Make it private. Call Expression.parse or BuildFileAST.parse.
  (Statement.parse is only temporary.)
- Make all parser functions accept a ParserInputSource.
- Add ParserInputSource.fromLines helper, and many calls to it.
- Delete ParsingLevel. The checks for "if", "for", and "load" at
  top-level belong in the validator, which knows what level it is at.

ValidationEnvironment:
- Move checkBuildSyntax to PackageFactory,
  as it is a BUILD-ism. Callers must call validateFile
  followed by PackageFactory.checkBuildSyntax.
- Move boundIdentifiers to Identifier.
- Surface isBuildFile parameter in all relevant APIs,
  so that clients can tell which behavior they get.
  We can't get rid of it until we rethink the way the prelude is implemented.
- ValidationEnvironment is now almost private, and will be made so in a follow-up.

BuildFileAST:
- Merge redundant parse{Build,Skylark}File functions. Now just parse().
- Rename remaining parse overloads to avoid ambiguity: parse{,WithDigest,WithImports}.
- Delete checkSyntax helper; call file.containsErrors() instead.

This modest change took 3.5 days' solid work.
It adds a lot of TODOs for next steps.
It is tempting to roll them all into this CL,
but doing that cost me the first day. :(
It's already complex enough. For now, baby steps.

PiperOrigin-RevId: 268551556
30 files changed
tree: d8f187317b6874e20105e7b6ba62b9a48fe93038
  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 only rebuilds 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

Bazel is released in ‘Beta’. See the product roadmap to learn about the path toward a stable 1.0 release.