codex_rust_crate docstring omits live macro parameters

Open 💬 0 comments Opened Jun 1, 2026 by bar-d

What happened?

The codex_rust_crate macro signature in defs.bzl includes parameters that are not documented in the macro docstring's Args section.

Examples:

  • build_script_enabled
  • rustc_flags_extra

Both parameters are live: build_script_enabled is used to gate build script wiring, and rustc_flags_extra is passed into generated Bazel targets. BUILD files also use these parameters, for example codex-rs/bwrap/BUILD.bazel and several WebRTC-related crates.

Expected behavior

The codex_rust_crate docstring should describe all supported macro parameters, especially parameters already used by first-party BUILD files, so future Bazel changes have accurate local API documentation.

Additional context

I searched open issues and PRs for terms including codex_rust_crate, build_script_enabled, rustc_flags_extra, and docstring, and did not find an existing open item that appears to cover these missing Args entries.

View original on GitHub ↗