About

A small Bazel registry for common libraries that do not ship with Bazel support out of the box.

• Native build overlays and patches
• Tested on macOS and Linux
• Focused on C and C++ developers

How to use

To consume modules from this registry, configure Bazel in two places:

1. Add the registry to your .bazelrc
2. Declare the module in your MODULE.bazel

1. Configure .bazelrc

Make sure Bzlmod is enabled and add this registry before the Bazel Central Registry.

# Enable Bzlmod
common --enable_bzlmod

# Add this registry
common --registry=https://raw.githubusercontent.com/tragisch/bazel-registry/main

# Keep the Bazel Central Registry as well
common --registry=https://bcr.bazel.build

Note: Once you add a custom registry, Bazel no longer uses the Bazel Central Registry implicitly, so you should list https://bcr.bazel.build explicitly if you still want access to BCR modules.

2. Declare the dependency in MODULE.bazel

Add the module you want to use with bazel_dep(...).

Example:

module(name = "my_project")

bazel_dep(name = "graphviz", version = "15.0.0")

Another example:

module(name = "my_project")

bazel_dep(name = "argon2", version = "20190702")
bazel_dep(name = "yyjson", version = "0.10.0")

After that, you can reference the exported Bazel targets from your BUILD.bazel files, for example:

cc_binary(
	name = "demo",
	srcs = ["main.c"],
	deps = [
		"@graphviz//:graphviz",
		"@yyjson//:yyjson",
	],
)

Available Modules

Module	Version	Description	Dependency	Build
argon2	20190702	Argon2 password hashing	@argon2//:argon2	✅
argtable3	3.2.2	ANSI C library for parsing GNU-style command line options	@argtable3//:argtable3	✅
box2d	3.0.0	2D physics engine for games	@box2d//:box2d	✅
cglm	0.9.6	Highly optimized 2D / 3D graphics math library for C	@cglm//:cglm	✅
cjson	1.7.19	Ultralightweight JSON parser in ANSI C	@cjson//:cjson	✅
csv_fast	0.1.0	Fast CSV parser and writer library in C	@csv_fast//:csv_fast	✅
czmq	4.2.1	High-level C binding for ZeroMQ	@czmq//:czmq	✅
gnuplot_i	1.0	gnuplot C interface library	@gnuplot_i//:gnuplot_i	✅
graphblas	10.3.1	SuiteSparse:GraphBLAS – a complete implementation of the GraphBLAS standard	@graphblas//:graphblas	✅
graphviz	15.0.0	Graph visualization tools with root alias for the cgraph library	@graphviz//:graphviz	✅
gunslinger	0.03-alpha	Header-only C99 framework for multimedia applications	@gunslinger//:gunslinger	✅
libb64	2.0.0.1	Base64 encode and decode library in C	@libb64//:libb64	✅
libcsv	b1d5212	CSV parser and writer library in C	@libcsv//:libcsv	✅
liblinear	247	A library for large linear classification	@liblinear//:liblinear	✅
libsodium	1.0.20	Portable, cross-compilable crypto library (NaCl-compatible)	@libsodium//:libsodium	✅
libzmq	4.3.5	High-performance asynchronous messaging library	@libzmq//:libzmq	✅
linmath	3eef828	Small linear math library for computer graphics	@linmath//:linmath	✅
lmdb	0.9.31	Lightning memory-mapped database library	@lmdb//:lmdb	✅
matio	1.5.27	MATLAB MAT file I/O library	@matio//:matio	✅
mpc	0.9.0	Parser combinator library for C	@mpc//:mpc	✅
openblas	0.3.33	(DRAFT) OpenBLAS with a native Bazel BLAS facade and OpenMP runtime integration	@openblas//:openblas	✅
openblas_lapack	0.3.33	(DRAFT) Separate LAPACK facade module built on top of openblas	@openblas_lapack//:openblas_lapack	✅
openmp	22.1.1	LLVM OpenMP runtime as native Bazel module with static libomp	@openmp//:libomp	✅
pbplots	0.1.9.1	Plotting library available in many programming languages	@pbplots//:pbPlots	✅
pcg	83252d9	PCG random number generation library, C edition	@pcg//:pcg	✅
raylib	5.5	Simple library to enjoy videogames programming	@raylib//:raylib	✅
sds	2.0.0	Simple Dynamic Strings library for C	@sds//:sds	✅
sha1	e1e2536	NIST Secure Hash Algorithm (SHA-1) implementation	@sha1//:sha1	✅
throw_the_switch	2.6.1-bazel.1	Unity – simple unit testing framework for C	@throw_the_switch//:Unity	✅
utest	f2fe288	Lightweight unit testing framework for C++/C projects	@utest//:utest	✅
uthash	2.3.0	C macros for hash tables and more	@uthash//:uthash	✅
yyjson	0.10.0	High performance JSON library written in ANSI C	@yyjson//:yyjson	✅

Note: openmp exposes the static runtime target @openmp//:libomp (alias for libomp_runtime_static) and is validated in CI via @openmp//:omp_smoke_test.

Note: openblas and openblas_lapack are currently supported on Linux in this registry.

Note: cglm exposes @cglm//:cglm (header-only) and @cglm//:cglmc (compiled glmc_* API).

Note: graphviz exposes @graphviz//:graphviz as the public root target; it currently resolves to the cgraph library.

Module Generator

There is a local helper script for new registry entries in tools/add_module.py. It is tailored to this repository and generates the standard layout with metadata.json, MODULE.bazel, source.json, and overlay/BUILD.bazel.

JSON mode

Example input file:

{
	"name": "demo",
	"version": "1.2.3",
	"url": "https://example.com/demo-1.2.3.tar.gz",
	"build_file": "/absolute/path/to/BUILD.bazel",
	"module_file": "/absolute/path/to/MODULE.bazel",
	"strip_prefix": "demo-1.2.3",
	"license": "MIT",
	"description": "Demo library",
	"homepage": "https://example.com/demo",
	"system": ["macos", "linux"],
	"patches": ["/absolute/path/to/fix.patch"]
}

Alternatively, the source can be derived from a git_repository-style input. The script normalizes that form internally into an archive URL so the registry entry can still be written as a source.json file with url and integrity.

{
	"name": "demo",
	"version": "1.2.3",
	"remote": "https://github.com/example/demo.git",
	"tag": "v1.2.3",
	"build_file": "/absolute/path/to/BUILD.bazel"
}

Run it with:

python3 tools/add_module.py --registry . --input /path/to/module.json

Interactive mode

python3 tools/add_module.py --registry .

The script automatically computes the source integrity as well as the hashes for overlay and patch files in source.json.