Initial commit

Author: eel76

.clang-format

@@ -0,0 +1,3 @@
+BasedOnStyle: Google
+IndentWidth: 4
+ColumnLimit: 100

.devcontainer/Dockerfile

@@ -0,0 +1,10 @@
+FROM ubuntu:latest
+
+RUN apt-get update && apt-get install -y \
+    build-essential \
+    cmake \
+    git \
+    clang \
+    lldb \
+    gdb \
+    && rm -rf /var/lib/apt/lists/*

.devcontainer/devcontainer.json

@@ -0,0 +1,30 @@
+// For format details, see https://aka.ms/devcontainer.json. For config options, see the
+// README at: https://github.com/devcontainers/templates/tree/main/src/cpp
+{
+	"name": "C++",
+	"build": {
+		"dockerfile": "Dockerfile"
+	},
+
+	// Features to add to the dev container. More info: https://containers.dev/features.
+	// "features": {},
+
+	// Use 'forwardPorts' to make a list of ports inside the container available locally.
+	// "forwardPorts": [],
+
+	// Use 'postCreateCommand' to run commands after the container is created.
+	// "postCreateCommand": "gcc -v",
+
+	// Configure tool-specific properties.
+    "customizations": {
+        "vscode": {
+            "extensions": [
+                "ms-vscode.cpptools",
+                "ms-vscode.cmake-tools"
+            ]
+        }
+    }
+
+	// Uncomment to connect as root instead. More info: https://aka.ms/dev-containers-non-root.
+	// "remoteUser": "root"
+}

.gitattributes

@@ -0,0 +1,3 @@
+* text=auto eol=lf
+*.{cmd,[cC][mM][dD]} text eol=crlf
+*.{bat,[bB][aA][tT]} text eol=crlf

.github/dependabot.yml

@@ -0,0 +1,12 @@
+# To get started with Dependabot version updates, you'll need to specify which
+# package ecosystems to update and where the package manifests are located.
+# Please see the documentation for more information:
+# https://docs.github.com/github/administering-a-repository/configuration-options-for-dependency-updates
+# https://containers.dev/guide/dependabot
+
+version: 2
+updates:
+ - package-ecosystem: "devcontainers"
+   directory: "/"
+   schedule:
+     interval: weekly

.github/workflows/create-package.yml

@@ -0,0 +1,33 @@
+name: create package
+permissions:
+  contents: write
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  create-package:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Create build environment
+        run: cmake -E make_directory build
+
+      - name: Configure CMake
+        run: cmake -B ./build
+
+      - name: Create package
+        run: cmake --build ./build --target package
+
+      - name: Get package name
+        id: package_name
+        run: cat ./build/package_name >> "$GITHUB_OUTPUT"
+
+      - name: Upload package
+        uses: svenstaro/upload-release-action@v2
+        with:
+          repo_token: ${{ secrets.GITHUB_TOKEN }}
+          file: build/${{ steps.package_name.outputs.name }}
+          tag: ${{ github.ref }}

.github/workflows/examples.yml

@@ -0,0 +1,47 @@
+name: examples
+
+on:
+  workflow_call:
+    inputs:
+      os:
+        description: 'Operating system to run the job on (ubuntu-latest, windows-latest, macos-latest)'
+        required: true
+        type: string
+      cxx_compilers:
+        description: 'List of compilers to use'
+        required: true
+        type: string
+
+jobs:
+  examples:
+    runs-on: ${{ inputs.os }}
+    
+    strategy:
+      fail-fast: true
+
+      matrix:
+        cxx_compiler: ${{ fromJSON(inputs.cxx_compilers) }}
+        build_type: [Debug, Release]
+  
+    steps:
+    - name: Checkout
+      uses: actions/checkout@v4
+
+    - name: Setup build directory
+      id: strings
+      shell: bash
+      run: |
+        echo "build-output-dir=${{ github.workspace }}/build.examples" >> "$GITHUB_OUTPUT"
+
+    - name: Configure CMake
+      run: >
+        cmake -B ${{ steps.strings.outputs.build-output-dir }}
+        -DCMAKE_CXX_COMPILER=${{ matrix.cxx_compiler }}
+        -DCMAKE_BUILD_TYPE=${{ matrix.build_type }}
+        -S ${{ github.workspace }}/examples
+
+    - name: Build examples
+      run: cmake --build ${{ steps.strings.outputs.build-output-dir }} --config ${{ matrix.build_type }}
+
+    - name: Run examples
+      run: ctest --output-on-failure --build-config ${{ matrix.build_type }} --test-dir ${{ steps.strings.outputs.build-output-dir }}

.github/workflows/lint.yml

@@ -0,0 +1,19 @@
+name: lint
+
+on:
+  push:
+    branches: [ "main" ]
+  pull_request:
+    branches: [ "main" ]
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Check formatting
+      run: |
+        find examples include tests -name '*.cpp' -o -name '*.h' |
+        xargs clang-format -style=file -i # --dry-run --Werror

.github/workflows/linux.yml

@@ -0,0 +1,14 @@
+name: linux
+
+on:
+  push:
+    branches: [ "main" ]
+  pull_request:
+    branches: [ "main" ]
+
+jobs:
+  tests-and-examples:
+    uses: ./.github/workflows/tests-and-examples.yml
+    with:
+      os: 'ubuntu-24.04'
+      cxx_compilers: '["g++-14", "clang++-17"]'

.github/workflows/macos.yml

@@ -0,0 +1,14 @@
+name: macos
+
+on:
+  push:
+    branches: [ "main" ]
+  pull_request:
+    branches: [ "main" ]
+
+jobs:
+  tests-and-examples:
+    uses: ./.github/workflows/tests-and-examples.yml
+    with:
+      os: 'macos-15'
+      cxx_compilers: '["clang++"]'