{r,m}ctx.download*: report size of downloaded file (https://github.com/bazelbuild/bazel/pull/29463)
### Description
Adds a new structure field `size_bytes` in the return value of `rctx.download` (and friends) containing the file size of the downloaded file.
### Motivation
This is a useful piece of metadata Bazel provides to repository rules and module extensions. Motivation for adding this: I need the ability to annotate BUILD files with sizes of downloaded files in rules_runfiles_group (https://github.com/hermeticbuild/rules_runfiles_group). This makes it possible to merge runfiles groups based on their "weight", which may include actual file sizes of *_import targets (java_import, cc_import, ...).
### Build API Changes
It does affect the Build API, but is backwards compatible (adding a new field).
Existing users will not be impacted.
### Checklist
- [x] I have added tests for the new use cases (if any).
- [x] I have updated the documentation (if applicable).
### Release Notes
RELNOTES[NEW]: {r,m}ctx.download* report the size of downloaded files
RELNOTES: Addition to the user-facing Build API
Closes #29463.
PiperOrigin-RevId: 910706646
Change-Id: I980cdee803810e1fb6222f69782fcad2648af68d
{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.
To report a security issue, please email security@bazel.build with a description of the issue, the steps you took to create the issue, affected versions, and, if known, mitigations for the issue. Our vulnerability management team will respond within 3 working days of your email. If the issue is confirmed as a vulnerability, we will open a Security Advisory. This project follows a 90 day disclosure timeline.
See CONTRIBUTING.md