[TECH-16629] bzlmod support

.bazelignore

@@ -0,0 +1 @@
+tests

.bazelrc

@@ -0,0 +1 @@
+try-import %workspace%/.bazelrc.user

.bcr/metadata.template.json

@@ -0,0 +1,23 @@
+{
+  "homepage": "https://github.com/bazel-contrib/toolchains_llvm",
+  "maintainers": [
+    {
+      "email": "fabian@meumertzhe.im",
+      "github": "fmeum",
+      "name": "Fabian Meumertzheim"
+    },
+    {
+      "email": "james.sharpe@zenotech.com",
+      "github": "jsharpe",
+      "name": "James Sharpe"
+    },
+    {
+      "email": "rrbutani@users.noreply.github.com",
+      "github": "rrbutani",
+      "name": "Rahul Butani"
+    }
+  ],
+  "repository": ["github:bazel-contrib/toolchains_llvm"],
+  "versions": [],
+  "yanked_versions": {}
+}

.bcr/presubmit.yml

@@ -0,0 +1,25 @@
+matrix:
+  bazel: [7.*, 8.*]
+  platform: [ubuntu2004, ubuntu2404, macos, macos_arm64]
+tasks:
+  verify_targets:
+    name: Verify build targets
+    bazel: ${{ bazel }}
+    platform: ${{ platform }}
+    build_targets:
+      - "@toolchains_llvm//toolchain:all"
+      - "@toolchains_llvm//platforms:all"
+bcr_test_module:
+  module_path: tests
+  matrix:
+    bazel: [7.*, 8.*]
+    platform: [ubuntu2004, ubuntu2404, macos, macos_arm64]
+  tasks:
+    run_test_module:
+      name: Run test module
+      bazel: ${{ bazel }}
+      platform: ${{ platform }}
+      build_targets:
+        - //:all
+      test_targets:
+        - //:all

.bcr/source.template.json

@@ -0,0 +1,5 @@
+{
+  "integrity": "**leave this alone**",
+  "strip_prefix": "{REPO}-{TAG}",
+  "url": "https://github.com/{OWNER}/{REPO}/releases/download/{TAG}/toolchains_llvm-{TAG}.tar.gz"
+}

.buildifier.json

@@ -0,0 +1,60 @@
+{
+  "type": "auto",
+  "mode": "fix",
+  "lint": "fix",
+  "warningsList": [
+    "attr-applicable_licenses",
+    "attr-cfg",
+    "attr-license",
+    "attr-licenses",
+    "attr-non-empty",
+    "attr-output-default",
+    "attr-single-file",
+    "build-args-kwargs",
+    "bzl-visibility",
+    "confusing-name",
+    "constant-glob",
+    "ctx-actions",
+    "ctx-args",
+    "deprecated-function",
+    "depset-items",
+    "depset-iteration",
+    "depset-union",
+    "dict-concatenation",
+    "dict-method-named-arg",
+    "duplicated-name",
+    "filetype",
+    "git-repository",
+    "http-archive",
+    "integer-division",
+    "keyword-positional-params",
+    "list-append",
+    "load",
+    "name-conventions",
+    "native-android",
+    "native-build",
+    "native-cc",
+    "native-package",
+    "native-proto",
+    "native-py",
+    "no-effect",
+    "output-group",
+    "overly-nested-depset",
+    "package-name",
+    "package-on-top",
+    "positional-args",
+    "print",
+    "provider-params",
+    "redefined-variable",
+    "repository-name",
+    "return-value",
+    "rule-impl-return",
+    "skylark-comment",
+    "skylark-docstring",
+    "string-iteration",
+    "uninitialized",
+    "unnamed-macro",
+    "unreachable",
+    "unused-variable"
+  ]
+}

.github/CODEOWNERS

@@ -0,0 +1 @@
+* @rrbutani @jsharpe @fmeum @helly25 @dzbarsky

.github/workflows/release.yml

@@ -0,0 +1,30 @@
+# Cut a release whenever a new tag is pushed to the repo.
+# You should use an annotated tag, like `git tag -a v1.2.3`
+# and put the release notes into the commit message for the tag.
+name: Release
+
+on:
+  push:
+    tags:
+      - "*.*.*"
+
+permissions: read-all
+
+jobs:
+  release:
+    permissions:
+      contents: write
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+      - name: Prepare release
+        run: .github/workflows/release_prep.sh > release_notes.txt
+      - name: Release
+        uses: softprops/action-gh-release@v2
+        with:
+          prerelease: false
+          generate_release_notes: true
+          body_path: release_notes.txt
+          files: toolchains_llvm-*.tar.gz
+          fail_on_unmatched_files: true

.github/workflows/release_notes_template.txt

@@ -0,0 +1,68 @@
+Minimum bazel version: **7.0.0**
+
+If you're using `bzlmod`, add the following to `MODULE.bazel`:
+
+```starlark
+bazel_dep(name = "toolchains_llvm", version = "{version}")
+
+# Configure and register the toolchain.
+llvm = use_extension("@toolchains_llvm//toolchain/extensions:llvm.bzl", "llvm")
+llvm.toolchain(
+   llvm_version = "16.0.0",
+)
+
+use_repo(llvm, "llvm_toolchain")
+# use_repo(llvm, "llvm_toolchain_llvm") # if you depend on specific tools in scripts
+
+register_toolchains("@llvm_toolchain//:all")
+```
+
+To directly use a commit from GitHub, add this block and replace commit with the commit you want.
+```starlark
+git_override(
+  module_name = "toolchains_llvm",
+  commit = "{commit}",
+  remote = "https://github.com/bazel-contrib/toolchains_llvm",
+)
+```
+
+If not using `bzlmod`, include this section in your `WORKSPACE`:
+
+```starlark
+load("@bazel_tools//tools/build_defs/repo:http.bzl", "http_archive")
+
+http_archive(
+    name = "toolchains_llvm",
+    sha256 = "{sha}",
+    strip_prefix = "{prefix}",
+    canonical_id = "{tag}",
+    url = "https://github.com/bazel-contrib/toolchains_llvm/releases/download/{tag}/{archive}",
+)
+
+load("@toolchains_llvm//toolchain:deps.bzl", "bazel_toolchain_dependencies")
+
+bazel_toolchain_dependencies()
+
+load("@bazel_features//:deps.bzl", "bazel_features_deps")
+
+bazel_features_deps()
+
+load("@rules_cc//cc:extensions.bzl", "compatibility_proxy_repo")
+
+# If you see an error:
+#   ERROR: Cycle caused by autoloads, failed to load .bzl file '@@cc_compatibility_proxy//:symbols.bzl'.
+# then you might need to add the following to your .bzelrc:
+#   common --repositories_without_autoloads=cc_compatibility_proxy
+compatibility_proxy_repo()
+
+load("@toolchains_llvm//toolchain:rules.bzl", "llvm_toolchain")
+
+llvm_toolchain(
+    name = "llvm_toolchain",
+    llvm_version = "16.0.0",
+)
+
+load("@llvm_toolchain//:toolchains.bzl", "llvm_register_toolchains")
+
+llvm_register_toolchains()
+```

.github/workflows/release_prep.sh

@@ -0,0 +1,26 @@
+#!/usr/bin/env bash
+
+set -o errexit -o nounset -o pipefail
+
+git config user.email "you@example.com"
+git config user.name "Your Name"
+
+# Set by GH actions, see
+# https://docs.github.com/en/actions/learn-github-actions/environment-variables#default-environment-variables
+tag="${GITHUB_REF_NAME}"
+commit="${GITHUB_SHA}"
+# The prefix is chosen to match what GitHub generates for source archives
+prefix="toolchains_llvm-${tag}"
+archive="toolchains_llvm-${tag}.tar.gz"
+git archive --format=tar --prefix="${prefix}/" HEAD | gzip >"${archive}"
+sha=$(shasum -a 256 "${archive}" | cut -f1 -d' ')
+
+# Strip leading "v" from the tag if present to create the semver version.
+sed \
+  -e "s/{version}/${tag#v}/g" \
+  -e "s/{tag}/${tag}/g" \
+  -e "s/{commit}/${commit}/g" \
+  -e "s/{prefix}/${prefix}/g" \
+  -e "s/{archive}/${archive}/g" \
+  -e "s/{sha}/${sha}/g" \
+  .github/workflows/release_notes_template.txt