# registry

**Repository Path**: hilbert-wang/registry

## Basic Information

- **Project Name**: registry
- **Description**: https://github.com/bazelboost/registry.git
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-12-27
- **Last Updated**: 2024-12-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<p align="center">
  <img width="200" src="https://avatars.githubusercontent.com/u/33623778?s=200&v=4" />
</p>

# Bazel Registry for Boost

The bazelboost project is an attempt to build Boost modules as Bazel modules. This is the [bazel registry](https://bazel.build/external/registry) for bazelboost.

## Usage

To use the bazelboost registry add it to your projects `.bazelrc` file.

```sh
# make sure bzlmod is enabled
common --enable_bzlmod

# add bazelboost registry
common --registry=https://raw.githubusercontent.com/bazelboost/registry/main
# by adding the bazelboost registry the BCR gets removed so you must add it here as well
common --registry=https://bcr.bazel.build
```

Now all the bazelboost modules may be added to your projects `MODULE.bazel` file.

```starlark
module(name = "my_project")

bazel_dep(name = "boost.asio", version = "1.83.0.bzl.X") # replace 'X' with latest version
```

All bazelboost modules have a target at the root with the same name as the module. For most cases you simple can use the module like so:

```starlark
cc_library(
    name = "my_library",
    # ...
    deps = [
        # ...
        "@boost.asio",
    ],
)
```

Some modules may have multiple targets. Review the `BUILD.bazel` file(s) or use [`bazel query`](https://bazel.build/query/guide) to find out whats available.

```sh
bazel query 'kind(cc_.*, @boost.test//...)'
```

```txt
@boost.test//:boost.test
@boost.test//:cpp_main
@boost.test//:test_main
@boost.test//:unit_test_main
```

If a feature is missing please file an issue in the bazelboost module.

## Bazel Boost Repository Structure

Each repository in the bazelboost org maintains a `bazelboost-*` branch for each version it supports. At this time we're limiting support to `1.83.0` until everything is relatively stable. No source file modifications are permitted, only Bazel-related files may be added.