bazeldnf BCR Module Notes

Release Tarball vs GitHub Raw File

The release tarball at https://github.com/rmohr/bazeldnf/releases/download/<version>/bazeldnf-<version>.tar.gz differs from the raw tag file at https://raw.githubusercontent.com/rmohr/bazeldnf/<version>/MODULE.bazel.

Always download and inspect the actual tarball before writing the patch:

curl -sL <tarball-url> | tar xzO bazeldnf-<version>/MODULE.bazel | cat -n

The tarball's MODULE.bazel:

  • Starts with "bazelndf dependencies" as line 1 (a string literal — not a comment)
  • Has the correct version already set (e.g. version = "v0.99.2-rc1")

What the Patch Does

The patch removes non-dev Go build tool dependencies that are not needed by consumers:

  • bazel_dep(name = "gazelle", ...)
  • bazel_dep(name = "rules_go", ...)
  • go_sdk extension block
  • go_deps extension block and use_repo

Dev dependencies marked with dev_dependency = True (e.g. bazeldnf_dev, protobuf, build tools) do NOT need to be patched out — Bazel ignores them for consumers.

Patch Format

Use git-style a/b headers with patch_strip=1 in source.json:

--- a/MODULE.bazel
+++ b/MODULE.bazel

Not the MODULE.bazel.orig / MODULE.bazel format (patch_strip=0) used in rc0 — that format requires MODULE.bazel.orig to exist in the tarball, which it doesn't.

MODULE.bazel.orig

The modules/bazeldnf/v0.99.2-rc0/MODULE.bazel.orig file should not be in the repo. Do not carry it over when creating new versions.

Adding a New Version — Checklist

  1. mkdir -p modules/bazeldnf/<version> and copy from previous version

  2. Delete MODULE.bazel.orig if copied

  3. Download and inspect the actual tarball's MODULE.bazel

  4. Update MODULE.bazel to match the tarball's kept content (with Go deps removed)

  5. Update patches/MODULE.bazel.patch as a diff from tarball → BCR MODULE.bazel

  6. Update source.json: new URL, docs_url, strip_prefix, patch_strip: 1, placeholder integrity hashes

    • docs_url format: https://github.com/rmohr/bazeldnf/releases/download/<version>/bazeldnf-<version>.docs.tar.gz

  7. Add new version to metadata.json

  8. Run bazel run //tools:update_integrity -- bazeldnf --version=<version>

  9. Run bazel run //tools:bcr_validation -- --check bazeldnf@<version>

  10. Commit with message format:

    bazeldnf@<version>

Release: https://github.com/rmohr/bazeldnf/releases/tag/<version>

This commit was made with the help of Claude (claude.ai)

    Note: do NOT use Co-Authored-By: Claude ... — Anthropic would need to sign Google's CLA.