DEVEL.md

Development guide

Prerequisites

Ensure bazelisk is installed before running any tests or development scripts.

Testing

Unit tests

To run unit tests, execute development/cli/run_unit_test.bash.

Integration tests

To run integration tests, run development/cli/run_integration_test.bash.

Code formatting and linting

For formatting and linting, execute each script under development/cli/style_check.

Here is the list of formatting and linting scripts:

• buildifier.bash: Runs buildifier.
• clang_format.bash: Runs clang-format
• clang_tidy_integration_test.bash: Runs clang-tidy under the integration test module.
• clang_tidy_root.bash: Runs clang-tidy under the root module.

Release process

Only an admin user can release a new version. To initiate a release, the admin should push a tag in the format X.Y.Z (e.g., 1.0.0). This will trigger a CI job that:

• Builds and uploads a tarball
• Creates a GitHub release
• Opens a pull request in the Bazel Central Registry (BCR)

After the BCR PR is approved and merged, the libc_replacer module becomes available as a Bazel module.