README.md

Bazel build template for cpp

Bazel CPP project template

An awesome cpp project template with bazel build system to jumpstart your projects!

---

features

---

Features

This project includes support for:

Frameworks:

• Testing with Google Test
• Mocking with Google Mock
• Logging with Google glog
• Benchmarking with Google Benchmark
• Remote Procedure Call (RPC) with gRPC

Libraries:

• Abseil C++
• Protocol Buffers

Bazel Installation

Please refer to the official Bazel installation guide for your platform:

• Ubuntu Installation Guide
• macOS Installation Guide
• Windows Installation Guide

Project Setup

Step 1: Clone the repository

git clone git@github.com:IvoBrandao/template-bazel-project.git

Step 2: Build the project

bazel build //app:main

Step 3: Run the project

bazel run //app:main

Step 4: Test the project

bazel test //app:main
# or for a specific platform:
bazel run  //app:main --platforms=//platforms:windows_platform
bazel run  //app:main --platforms=//platforms:macos_platform
bazel run  //app:main --platforms=//platforms:ubuntu_platform

Step 5: Test individual libraries

To run tests for specific libraries (e.g., pkg library), use:

bazel test //lib/pkg:pkg_test --test_output=all

Dependencies

The project uses Bazel’s module system (MODULE.bazel) to manage dependencies. The following libraries are included:

• bazel_skylib for Bazel utility functions.
• rules_platform for platform configurations.
• rules_cc for C++ build rules.
• rules_testing for testing utilities.
• Google Test for unit testing.
• gRPC for RPC support.
• Protocol Buffers for message serialization.
• Abseil C++ for common utility libraries.
• glog for logging.
• Google Benchmark for benchmarking.