Apply the latest Beman Standard

.ci/docker/rockylinux.Dockerfile

@@ -1,29 +1,34 @@
+# SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
+
 FROM rockylinux:9
 
-# Enable EPEL
+# Enable EPEL.
 RUN dnf update -y
 RUN dnf install -y 'dnf-command(config-manager)'
 RUN dnf config-manager --set-enabled crb -y
 RUN dnf install epel-release -y
 
-# Install dependencies
+# Install dependencies.
 RUN dnf install -y \
         clang \
         g++ \
         ninja-build \
-        cmake
+        cmake \
+        git
 RUN dnf clean all
 
-# Copy code
+# Copy code.
 WORKDIR /workarea
 COPY ./ ./
 
+# Set build arguments.
 ARG cc=gcc
 ARG cxx=g++
 ARG cmake_args=
 
+# Build.
 ENV CC="$cc" CXX="$cxx" CMAKE_GENERATOR="Ninja" CMAKE_EXPORT_COMPILE_COMMANDS=on
-RUN cmake -B build -S . "$cmake_args" && \
-  cmake --build build --verbose && \
-  DESTDIR=build/staging cmake --install build --prefix /opt/example --component libexample-dev && \
-  find build/staging -type f
+RUN cmake -B build -S . "$cmake_args"
+RUN cmake --build build --verbose
+RUN DESTDIR=build/staging cmake --install build --prefix /opt/beman/example --component libbeman_example-dev
+RUN find build/staging -type f

.ci/docker/ubuntu.Dockerfile

@@ -1,28 +1,33 @@
-# Using a non-LTS Ubuntu, just until CMake 3.23 is available on Ubuntu 24.04
+# SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
+
+# Using a non-LTS Ubuntu, just until CMake 3.23 is available on Ubuntu 24.04.
 FROM ubuntu:23.10
 
-# Install dependencies
+# Install dependencies,
 RUN apt-get update
 RUN apt-get install -y \
         clang \
         clang-tidy \
         g++ \
         ninja-build \
-        cmake
+        cmake \
+        git
 RUN apt-get clean
 
 WORKDIR /workarea
 COPY ./ ./
 
+# Set build arguments.
 ARG cc=gcc
 ARG cxx=g++
 ARG cmake_args=
 
 # Workaround Ubuntu broken ASan
 RUN sysctl vm.mmap_rnd_bits=28
 
+# Build.
 ENV CC="$cc" CXX="$cxx" CMAKE_GENERATOR="Ninja" CMAKE_EXPORT_COMPILE_COMMANDS=on
-RUN cmake -B build -S . "$cmake_args" && \
-  cmake --build build --verbose && \
-  DESTDIR=build/staging cmake --install build --prefix /opt/example --component libexample-dev && \
-  find build/staging -type f
+RUN cmake -B build -S . "$cmake_args"
+RUN cmake --build build --verbose
+RUN DESTDIR=build/staging cmake --install build --prefix /opt/beman/example --component libbeman_example-dev
+RUN find build/staging -type f

.github/CODEOWNERS

@@ -0,0 +1,4 @@
+# SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
+# Codeowners for reviews on PRs
+
+*  @bbrown105 @dustingooding @JamesAdkison @neatudarius

.github/workflows/cxx.yml → .github/workflows/ci_tests.yml

@@ -1,7 +1,6 @@
-# Copyright © 2024 Bret Brown
-# SPDX-License-Identifier: MIT
+# SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
 
-name: Test
+name: CI Test
 
 on:
   push:
@@ -30,14 +29,23 @@ jobs:
           - { id: ubuntu-gcc-aubsan, platform: ubuntu, cc: gcc, cpp: g++, cmake_args: "-DCMAKE_CXX_FLAGS=-fsanitize=address -fsanitize=undefined"}
           - { id: ubuntu-gcc-tsan, platform: ubuntu, cc: gcc, cpp: g++, cmake_args: "-DCMAKE_CXX_FLAGS=-fsanitize=thread"}
           - { id: ubuntu-gcc-static, platform: ubuntu, cc: gcc, cpp: g++, cmake_args: ""}
+          - { id: ubuntu-gcc-dynamic, platform: ubuntu, cc: gcc, cpp: g++, cmake_args: "-DBUILD_SHARED_LIBS=on"}
+          - { id: ubuntu-clang-static, platform: ubuntu, cc: clang, cpp: clang++, cmake_args: ""}
+          - { id: ubuntu-clang-dynamic, platform: ubuntu, cc: clang, cpp: clang++, cmake_args: "-DBUILD_SHARED_LIBS=on"}
           - { id: ubuntu-gcc-static-cxx98, platform: ubuntu, cc: gcc, cpp: g++, cmake_args: "-DCMAKE_CXX_STANDARD=98 -DCMAKE_CXX_STANDARD_REQUIRED=on"}
           - { id: ubuntu-gcc-static-cxx11, platform: ubuntu, cc: gcc, cpp: g++, cmake_args: "-DCMAKE_CXX_STANDARD=11 -DCMAKE_CXX_STANDARD_REQUIRED=on"}
           - { id: ubuntu-gcc-static-cxx14, platform: ubuntu, cc: gcc, cpp: g++, cmake_args: "-DCMAKE_CXX_STANDARD=14 -DCMAKE_CXX_STANDARD_REQUIRED=on"}
           - { id: ubuntu-gcc-static-cxx17, platform: ubuntu, cc: gcc, cpp: g++, cmake_args: "-DCMAKE_CXX_STANDARD=17 -DCMAKE_CXX_STANDARD_REQUIRED=on"}
           - { id: ubuntu-gcc-static-cxx20, platform: ubuntu, cc: gcc, cpp: g++, cmake_args: "-DCMAKE_CXX_STANDARD=20 -DCMAKE_CXX_STANDARD_REQUIRED=on"}
-          - { id: ubuntu-gcc-dynamic, platform: ubuntu, cc: gcc, cpp: g++, cmake_args: "-DBUILD_SHARED_LIBS=on"}
-          - { id: ubuntu-clang-static, platform: ubuntu, cc: clang, cpp: clang++, cmake_args: ""}
-          - { id: ubuntu-clang-dynamic, platform: ubuntu, cc: clang, cpp: clang++, cmake_args: "-DBUILD_SHARED_LIBS=on"}
+          - { id: ubuntu-gcc-static-cxx23, platform: ubuntu, cc: gcc, cpp: g++, cmake_args: "-DCMAKE_CXX_STANDARD=23 -DCMAKE_CXX_STANDARD_REQUIRED=on"}
+          - { id: ubuntu-gcc-static-cxx26, platform: ubuntu, cc: gcc, cpp: g++, cmake_args: "-DCMAKE_CXX_STANDARD=26 -DCMAKE_CXX_STANDARD_REQUIRED=on"}
+          - { id: ubuntu-clang-static-cxx98, platform: ubuntu, cc: clang, cpp: clang++, cmake_args: "-DCMAKE_CXX_STANDARD=98 -DCMAKE_CXX_STANDARD_REQUIRED=on"}
+          - { id: ubuntu-clang-static-cxx11, platform: ubuntu, cc: clang, cpp: clang++, cmake_args: "-DCMAKE_CXX_STANDARD=11 -DCMAKE_CXX_STANDARD_REQUIRED=on"}
+          - { id: ubuntu-clang-static-cxx14, platform: ubuntu, cc: clang, cpp: clang++, cmake_args: "-DCMAKE_CXX_STANDARD=14 -DCMAKE_CXX_STANDARD_REQUIRED=on"}
+          - { id: ubuntu-clang-static-cxx17, platform: ubuntu, cc: clang, cpp: clang++, cmake_args: "-DCMAKE_CXX_STANDARD=17 -DCMAKE_CXX_STANDARD_REQUIRED=on"}
+          - { id: ubuntu-clang-static-cxx20, platform: ubuntu, cc: clang, cpp: clang++, cmake_args: "-DCMAKE_CXX_STANDARD=20 -DCMAKE_CXX_STANDARD_REQUIRED=on"}
+          - { id: ubuntu-clang-static-cxx23, platform: ubuntu, cc: clang, cpp: clang++, cmake_args: "-DCMAKE_CXX_STANDARD=23 -DCMAKE_CXX_STANDARD_REQUIRED=on"}
+          - { id: ubuntu-clang-static-cxx26, platform: ubuntu, cc: clang, cpp: clang++, cmake_args: "-DCMAKE_CXX_STANDARD=26 -DCMAKE_CXX_STANDARD_REQUIRED=on"}
           # Disabling Rocky until it catches up on CMake versions or a way to sideload newer version of CMake
           # is identified.
           # - { id: rockylinux-gcc-static, platform: rockylinux, cc: gcc, cpp: g++, cmake_args: ""}

.gitignore

@@ -0,0 +1,8 @@
+cmake.bld
+compile_commands.json
+/.build/
+/build/
+/.cache/
+*.pyg
+.update-submodules
+.vscode/

CMakeLists.txt

@@ -1,16 +1,32 @@
-# Copyright © 2024 Bret Brown
-# SPDX-License-Identifier: MIT
+# SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
 
 cmake_minimum_required(VERSION 3.23)
-project(example
+
+project(beman_example
   VERSION 1.0.0
   DESCRIPTION "An example Beman library"
   LANGUAGES CXX
 )
-include(CTest)
 
-add_subdirectory(src/example)
+# Include the CTest module.
+include(CTest)
 
+# Build the tests only if enabled via the CLI flag: BUILD_TESTING.
 if (BUILD_TESTING)
-  add_subdirectory(test/example)
+  enable_testing()
+
+  # Fetch GoogleTest
+  include(FetchContent)
+  FetchContent_Declare(
+    googletest
+    GIT_REPOSITORY https://github.com/google/googletest.git
+    GIT_TAG        f8d7d77c06936315286eb55f8de22cd23c188571 # release-1.14.0
+  )
+  FetchContent_MakeAvailable(googletest)
 endif ()
+
+# Build the library.
+add_subdirectory(src/Beman/Example)
+
+# Build the examples.
+add_subdirectory(examples)