tool/

directory
v0.3.0-20260814204056-... Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Aug 14, 2026 License: Apache-2.0

README

Tools Directory

This directory contains tooling scripts and configurations for the submitqueue repository.

Bazel Wrapper

The tool/bazel script is a Python-based Bazelisk implementation that:

  • Reads .bazelversion from the repository root
  • Automatically downloads and caches the correct Bazel version
  • Delegates all commands to that version
Usage
# Use the wrapper directly
./tool/bazel build //...

# Or add tool/ to your PATH (via .envrc with direnv)
bazel build //...
Version Management

The Bazel version is controlled by .bazelversion at the repository root. Update that file to change the Bazel version used by the wrapper.

Adding New Tools

When adding new tools to this directory:

  1. Create the script in tool/
  2. Make it executable: chmod +x tool/<script-name>
  3. Add it to tool/BUILD.bazel if it needs to be referenced by Bazel rules
  4. Document it in this README

Environment Setup

This directory is added to PATH via .envrc (for direnv users), allowing you to run bazel commands without prefixing with ./tool/.

Directories

Path Synopsis
linter
binaryfile command
Command binaryfile checks that no binary file is tracked in the repository.
Command binaryfile checks that no binary file is tracked in the repository.
licenseheader command
messageid command
Command messageid checks that queue messages are only constructed where the message-ID convention is enforced.
Command messageid checks that queue messages are only constructed where the message-ID convention is enforced.
queueshard command
Command queueshard checks that every domain table is shardable by queue: its primary key must lead with the queue column, and no secondary index may span queues.
Command queueshard checks that every domain table is shardable by queue: its primary key must lead with the queue column, and no secondary index may span queues.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL