Document that a failed download may leave a partial file (#31837) ### Description Documents on the `allow_fail` parameter of `repository_ctx.download` and `module_ctx.download` that a failed download may leave a partially downloaded file at the output path, or one that doesn't match `sha256` or `integrity`. ### Motivation Deleting the output of a failed download instead would break rules that resume it, e.g. with a `Range` header in `headers`, and would also delete a file that was at the output path before the download. ### Build API Changes No ### Release Notes RELNOTES: None Closes #31837 COPYBARA_INTEGRATE_REVIEW=https://github.com/bazelbuild/bazel/pull/31837 from fmeum:download-cleanup-partial-output 6fbd98d48e8dbd07172fa6757afa760dc22e0aed PiperOrigin-RevId: 1007401272 Change-Id: I764008f7e677d7fe6543ad341908ea6f41c8ea26
{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