Release-0.0.3

.cppcheck.suppress

@@ -1,2 +1 @@
-unusedFunction
-unusedStructMember
+unusedFunction

.devops.toml

@@ -0,0 +1,24 @@
+# DevOps Configuration File
+
+[exclude]
+buggy_cpp_macros = ["MSTD_WARN_BUGGY_HEADER", "MSTD_WARN_BUGGY_LIBRARY"]
+
+[logging]
+#global_level = "INFO"
+#utils_level = "INFO"
+#config_level = "INFO"
+#cpp_level = "INFO"
+
+[git]
+#tag_prefix = ""
+#empty_tag_list_allowed = true
+
+[cpp]
+#style_checks = true
+#license_header_check = true
+#check_only_staged_files = false
+license_header = "config/licenseHeader.txt"
+header_guards_according_to_filepath = true
+
+[file]
+#encoding = "utf-8"

.github/workflows/check-pr-for-release-version.yml

@@ -11,20 +11,31 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-      - name: Check PR Title or Description
+      - name: Check PR Title, Description, or Hotfix Branch
         run: |
           title="${{ github.event.pull_request.title }}"
           body="${{ github.event.pull_request.body }}"
-          echo "Checking PR title: $title"
-          echo "Checking PR body: $body"
+          head_ref="${{ github.head_ref }}"
 
-          # Regex: Release-x.y.z (case-insensitive, numeric x, y, z of variable length)
+          echo "PR title: $title"
+          echo "PR body: $body"
+          echo "PR source branch: $head_ref"
+
+          # Allow hotfix branches unconditionally
+          if [[ "$head_ref" == hotfix/* ]]; then
+            echo "✅ Hotfix branch detected ($head_ref). Skipping release pattern check."
+            exit 0
+          fi
+
+          # Regex: Release-x.y.z (case-insensitive)
           regex='[Rr][Ee][Ll][Ee][Aa][Ss][Ee]-[0-9]+\.[0-9]+\.[0-9]+'
 
           if [[ "$title" =~ $regex ]] || [[ "$body" =~ $regex ]]; then
             echo "✅ Found valid Release pattern in title or description."
             exit 0
           else
-            echo "❌ Invalid PR. Title or description must contain: Release-x.y.z (e.g., Release-1.2.3)"
+            echo "❌ Invalid PR."
+            echo "   Title or description must contain: Release-x.y.z (e.g., Release-1.2.3)"
+            echo "   OR the branch must start with: hotfix/"
             exit 1
           fi

.github/workflows/create-tag.yml

@@ -22,12 +22,44 @@ jobs:
           fetch-depth: 0
           submodules: recursive
 
-      - name: Extract release version from PR
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: 3.13
+          cache: 'pip'
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e external/devops
+
+      - name: Extract release version (Release-x.y.z OR hotfix bump)
         id: extract_version
+        shell: bash
         run: |
+          set -euo pipefail
+
           title="${{ github.event.pull_request.title }}"
           body="${{ github.event.pull_request.body }}"
+          head_ref="${{ github.head_ref }}"   # PR source branch name, e.g. hotfix/...
+
+          echo "PR source branch: $head_ref"
+          echo "PR title: $title"
+
+          # Hotfix: version = latest tag + 1 in patch
+          if [[ "$head_ref" == hotfix/* ]]; then
+            echo "✅ Hotfix PR detected. Deducing version from latest tag + patch bump..."
 
+            git fetch --tags --force
+
+            version="$(increase_latest_tag --patch)"
+
+            echo "✅ Hotfix release version: $version"
+            echo "version=$version" >> "$GITHUB_OUTPUT"
+            exit 0
+          fi
+
+          # Non-hotfix: expect Release-x.y.z in title/body
           regex='[Rr][Ee][Ll][Ee][Aa][Ss][Ee]-([0-9]+\.[0-9]+\.[0-9]+)'
 
           if [[ "$title" =~ $regex ]]; then
@@ -36,16 +68,18 @@ jobs:
             version="${BASH_REMATCH[1]}"
           else
             echo "❌ No valid release version found in PR title or description."
+            echo "   Expected: Release-x.y.z (e.g., Release-1.2.3)"
+            echo "   Or use a hotfix/* branch to auto-bump patch."
             exit 1
           fi
 
           echo "✅ Found release version: $version"
-          echo "version=$version" >> $GITHUB_OUTPUT
+          echo "version=$version" >> "$GITHUB_OUTPUT"
 
       - name: Update CHANGELOG.md
         run: |
           version="${{ steps.extract_version.outputs.version }}"
-          python3 scripts/update_changelog.py "$version"
+          update_changelog "$version"
 
       - name: Commit and push changelog update
         run: |
@@ -54,16 +88,21 @@ jobs:
           git config user.email "github-actions[bot]@users.noreply.github.com"
 
           git add CHANGELOG.md
-          git commit -m "docs: update changelog for $version"
+          git commit -m "docs: update changelog for $version" || echo "No changes to commit"
           git push origin HEAD:main
 
       - name: Create Git tag
-        id: create_tag
         run: |
           version="${{ steps.extract_version.outputs.version }}"
           git config user.name "github-actions[bot]"
           git config user.email "github-actions[bot]@users.noreply.github.com"
 
+          # Safety: don't fail if tag already exists (e.g., re-runs)
+          if git rev-parse -q --verify "refs/tags/$version" >/dev/null; then
+            echo "Tag $version already exists. Skipping tag creation."
+            exit 0
+          fi
+
           git tag "$version"
           git push origin "$version"
 

.github/workflows/docs.yml

@@ -0,0 +1,35 @@
+name: DOCS
+
+on:
+  pull_request:
+    branches:
+      - '*'
+  workflow_dispatch:
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: recursive  # ✅ ensure Catch2 is pulled in
+
+      - name: Install gcc14
+        run: |
+          sudo apt update
+          sudo apt install -y gcc-14 g++-14
+        shell: bash
+
+      - name: Install Doxygen
+        run: |
+          sudo apt update
+          sudo apt install -y doxygen
+
+      - name: Build and Test Project
+        run: |
+          cmake -S . -B build -DCMAKE_BUILD_TYPE=Release -DMSTD_BUILD_DOCS=ON
+          make docs # at the moment only building docs to verify no doc-related build issues
+        env:
+          CC: gcc-14
+          CXX: g++-14

.github/workflows/static-analysis.yml

@@ -0,0 +1,60 @@
+name: Static Analysis
+
+on:
+  pull_request:
+    branches:
+      - '*'
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  cppcheck:
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: recursive
+
+      - name: Install cppcheck
+        run: |
+          sudo apt update
+          sudo apt install -y cppcheck
+
+      - name: Run cppcheck
+        run: |
+          cppcheck --enable=all \
+              --enable=performance \
+              --enable=style \
+              --enable=information \
+              --enable=portability \
+              --error-exitcode=1 \
+              --suppressions-list=.cppcheck.suppress \
+              --suppress=missingIncludeSystem \
+              --inline-suppr \
+              --inconclusive \
+              -I include \
+              include test
+
+  clang-tidy:
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: recursive
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: 3.13
+          cache: 'pip'
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e external/devops
+
+      - name: Install clang-tidy and dependencies
+        run: |
+          cpp_checks --dirs include --dirs test

.gitignore

@@ -1,3 +1,8 @@
 .build
 build
 .cache
+checks.egg-info/
+__pycache__/
+.venv
+docs/output/
+compile_commands.json

.gitmodules

@@ -1,3 +1,6 @@
 [submodule "external/Catch2"]
 	path = external/Catch2
 	url = https://github.com/catchorg/Catch2
+[submodule "external/devops"]
+	path = external/devops
+	url = https://github.com/97gamjak/devops

.vscode/settings.json

@@ -108,6 +108,12 @@
         "__nullptr": "cpp",
         "csignal": "cpp",
         "list": "cpp",
-        "text_encoding": "cpp"
+        "text_encoding": "cpp",
+        "__locale": "cpp",
+        "__hash_table": "cpp",
+        "__split_buffer": "cpp",
+        "__tree": "cpp",
+        "queue": "cpp",
+        "stack": "cpp"
     },
 }

CHANGELOG.md

@@ -4,6 +4,32 @@ All notable changes to this project will be documented in this file.
 
 ## Next Release
 
+### CI
+
+- Add devops python library first version for all kind of custom static code analysis
+- Add `update_changelog` from devops package to create_tag CI
+- Add hotfix branch release handling to auto increment version patch aka `major.minor.patch`
+
+### Error Handling
+
+- Add compile time warning macros for buggy libraries and buggy headers (used atm in quantity lib as long as it is not fixed)
+
+### Compilation
+
+- Add Compile flag `MSTD_IGNORE_BUGGY_CODE` to ignore any kind of warnings for buggy libraries or headers
+- Add exhaustive error flags for compilation
+- Add checking of doxygen comments via building docs (no docs is building for gh pages - yet)
+
+### Cleanup
+
+- Cleanup header guards to follow common rule with folder and file structure
+
+### Enums
+
+- Introduce type traits for mstd enums: `using EnumMeta = typename enum_meta<Enum>::type`
+- Make `EnumMeta::index` return std::optional instead of -1 in case of error
+- Add a `values_view` to `EnumMeta` returning a `std::span` for having a nicer API in special cases
+
 <!-- insertion marker -->
 ## [0.0.2](https://github.com/97gamjak/mstd/releases/tag/0.0.2) - 2025-11-20
 

CMakeLists.txt

@@ -9,6 +9,7 @@ project(mstd
 )
 
 option(MSTD_BUILD_TESTS "Build mstd test" ON)
+option(MSTD_BUILD_DOCS "Build mstd documentation" OFF)
 
 add_library(mstd INTERFACE)
 target_include_directories(mstd
@@ -21,10 +22,58 @@ target_compile_features(mstd
     cxx_std_20
 )
 
+if (CMAKE_CXX_COMPILER_ID STREQUAL "GNU")
+    target_compile_options(mstd INTERFACE
+        -Wall
+        -Wextra
+        -Wpedantic
+        -Werror
+
+        # correctness
+        -Wshadow
+        -Wconversion
+        -Wsign-conversion
+        -Wcast-align
+        -Wformat=2
+        -Wnull-dereference
+        -Wdouble-promotion
+        -Wimplicit-fallthrough
+        -Woverloaded-virtual
+        -Wnon-virtual-dtor
+        -Wold-style-cast
+        -Wuseless-cast
+        -Wduplicated-cond
+        -Wduplicated-branches
+        -Wlogical-op
+        -Wmisleading-indentation
+
+        # lifetime / safety
+        -Wuninitialized
+        -Wmaybe-uninitialized
+        -Winit-self
+
+        -Wno-error=deprecated-declarations
+    )
+endif()
+
 if(MSTD_BUILD_TESTS)
     include(CTest)
     enable_testing()
     add_subdirectory(test)
 else()
     message(STATUS "Tests are disabled. Set MSTD_BUILD_TESTS to ON to enable them.")
 endif()
+
+if(MSTD_BUILD_DOCS)
+    find_package(Doxygen REQUIRED)
+    set(DOXYGEN_IN ${CMAKE_CURRENT_SOURCE_DIR}/docs/Doxyfile)
+    add_custom_target(docs
+        COMMAND ${DOXYGEN_EXECUTABLE} ${DOXYGEN_IN}
+        WORKING_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}
+        COMMENT "Generating API documentation with Doxygen"
+        VERBATIM
+    )
+    message(STATUS "Doxygen found. Use 'make docs' to build documentation.")
+else()
+    message(STATUS "Documentation is disabled. Set MSTD_BUILD_DOCS to ON to enable it.")
+endif()