Adding dependency to new enum_ops library. (#572)

* Factored out enum_ops.
* Fixed potential issues with default_executor with libdispatch.
* clang-tidy fixes
* added a missing include.
* Removing install option - use CPM. Installation with public dependencies is far too complex.

Author: sean-parent

.clang-tidy

@@ -11,5 +11,7 @@ CheckOptions:
     value: >
       boost/test/.*;
       __chrono/.*
-HeaderFilterRegex: '^.*/include/stlab/.*$'
+  - key: modernize-*.MinimumCppVersion
+    value: "C++17"
+HeaderFilterRegex: "^.*/include/stlab/.*$"
 # WarningsAsErrors: "*"

.github/workflows/stlab.yml

@@ -56,23 +56,12 @@ jobs:
           sudo apt-get install -y ninja-build
         shell: bash
 
-      # - name: Install dependencies // Windows
-        # if: ${{ startsWith(matrix.config.os, 'windows') }}
-        # run: |
-        #  choco install --yes ninja
-        #  vcpkg install boost-test:x64-windows boost-multiprecision:x64-windows
-        # vcpkg install boost:x64-windows
-        # dotnet add package boost --version 1.85.0
-        # choco install --yes boost-msvc-14.3
-        # shell: cmd
-
       - name: Install dependencies // Linux Emscripten
         if: ${{ startsWith(matrix.config.compiler, 'emscripten') }}
         shell: bash
         run: |
           sudo apt-get update
           sudo apt-get install -y ninja-build
-          # git clone --depth 1 --recurse-submodules --shallow-submodules --jobs=8 https://github.com/boostorg/boost.git $HOME/boost
 
           git clone --depth 1 https://github.com/emscripten-core/emsdk.git $HOME/emsdk
           pushd $HOME/emsdk
@@ -100,19 +89,6 @@ jobs:
           echo "CC=clang-${{matrix.config.version}}" >> $GITHUB_ENV
           echo "CXX=clang++-${{matrix.config.version}}" >> $GITHUB_ENV
 
-      # - name: Compile Boost // Emscripten
-      #   if: ${{ startsWith(matrix.config.compiler, 'emscripten') }}
-      #   shell: bash -l {0}
-      #   run: |
-      #     mkdir -p ../build-boost
-      #     cmake -S $HOME/boost -B ../build-boost -GNinja -DCMAKE_BUILD_TYPE=Release -DCMAKE_CXX_STANDARD=23 \
-      #       -DCMAKE_CXX_FLAGS="-Wno-deprecated-builtins" \
-      #       -DCMAKE_TOOLCHAIN_FILE=$GITHUB_WORKSPACE/cmake/Platform/Emscripten-STLab.cmake \
-      #       -DBOOST_INCLUDE_LIBRARIES="multiprecision;test"
-
-      #     cmake --build ../build-boost
-      #     cmake --install ../build-boost
-
       - name: Configure // Unix !Emscripten
         if: ${{ (startsWith(matrix.config.os, 'ubuntu') || startsWith(matrix.config.os, 'macos')) && !startsWith(matrix.config.compiler, 'emscripten') }}
         shell: bash
@@ -154,63 +130,3 @@ jobs:
         run: |
           cd ../build/
           ctest --output-on-failure
-
-  test-install:
-    name: Test CMake Installation
-    needs: builds
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/[email protected]
-
-      - name: Install dependencies
-        run: |
-          sudo apt-get update
-          sudo apt-get install -y ninja-build
-
-      - name: Build and Install
-        run: |
-          # Build and install copy-on-write first
-          git clone --depth 1 --branch v1.0.3 https://github.com/stlab/copy-on-write.git
-          cd copy-on-write
-          mkdir build && cd build
-          cmake .. -GNinja -DCMAKE_BUILD_TYPE=Release -DCMAKE_CXX_STANDARD=20 -DCMAKE_INSTALL_PREFIX=/usr/local
-          cmake --build .
-          sudo cmake --install .
-          cd ../..
-
-          # Build and install stlab
-          mkdir build && cd build
-          cmake .. -GNinja -DCMAKE_BUILD_TYPE=Release -DCMAKE_CXX_STANDARD=20 -DCMAKE_INSTALL_PREFIX=/usr/local
-          cmake --build .
-          sudo cmake --install .
-
-      - name: Create Test Project
-        run: |
-          mkdir test-install && cd test-install
-          cat > CMakeLists.txt << 'EOL'
-          cmake_minimum_required(VERSION 3.23)
-          project(test_stlab_install)
-          
-          find_package(stlab REQUIRED)
-          
-          add_executable(test_stlab main.cpp)
-          target_link_libraries(test_stlab PRIVATE stlab::stlab)
-          EOL
-          
-          cat > main.cpp << 'EOL'
-          #include <stlab/version.hpp>
-          #include <iostream>
-          
-          int main() {
-              std::cout << "STLab version: " << STLAB_VERSION << std::endl;
-              return 0;
-          }
-          EOL
-
-      - name: Build Test Project
-        run: |
-          cd test-install
-          mkdir build && cd build
-          cmake .. -GNinja -DCMAKE_BUILD_TYPE=Release
-          cmake --build .
-          ./test_stlab

CHANGES.md

@@ -1,3 +1,6 @@
+## v2.1.0 - 2025 - August 27
+  - See [the release notes](https://github.com/stlab/libraries/releases/tag/v2.1.0) for details.
+
 ## v2.0.2 - 2025 - June 27
   - See [the release notes](https://github.com/stlab/libraries/releases/tag/v2.0.2) for details.
 

CMakeLists.txt

@@ -9,15 +9,16 @@ add_library(stlab::stlab ALIAS stlab)
 ########################################################
 # Dependencies
 # Enable CPM caching to avoid re-downloading dependencies
-set(CPM_SOURCE_CACHE ${CMAKE_SOURCE_DIR}/.cpm-cache CACHE PATH "Directory to cache CPM packages" FORCE)
-
+set(CPM_SOURCE_CACHE ${CMAKE_SOURCE_DIR}/.cache/cpm CACHE PATH "Directory to cache CPM packages" FORCE)
 include(cmake/CPM.cmake)
 
-
 # Add stlab-copy-on-write as a dependency
-CPMAddPackage("gh:stlab/[email protected].3")
+CPMAddPackage("gh:stlab/[email protected].4")
 target_link_libraries(stlab INTERFACE stlab::copy-on-write)
 
+CPMAddPackage("gh:stlab/[email protected]")
+target_link_libraries(stlab INTERFACE stlab::enum-ops)
+
 ########################################################
 # clangd
 
@@ -131,8 +132,7 @@ endif()
 #
 target_include_directories(stlab INTERFACE
   $<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/include>
-  $<BUILD_INTERFACE:${PROJECT_BINARY_DIR}/include>
-  $<INSTALL_INTERFACE:include>)
+  $<BUILD_INTERFACE:${PROJECT_BINARY_DIR}/include>)
 
 #
 # Several definitions are specified for the microsoft compiler. These have
@@ -170,41 +170,3 @@ message(STATUS "stlab: Main Executor: ${STLAB_MAIN_EXECUTOR}")
 if(BUILD_TESTING)
   add_subdirectory(test)
 endif()
-
-include(CMakePackageConfigHelpers) # provides `write_basic_package_version_file`
-write_basic_package_version_file(
-  "${stlab_BINARY_DIR}/stlabConfigVersion.cmake"
-  VERSION ${stlab_VERSION}
-  COMPATIBILITY SameMajorVersion)
-
-install(
-  TARGETS stlab
-  EXPORT stlabTargets
-  FILE_SET stlab
-)
-
-#
-# A CMake configuration file is generated describing the stlab exported targets.
-# This file is included by (and installed with) the cmake/CMakeConfig.cmake file
-# under version control.
-#
-install(EXPORT stlabTargets
-  FILE stlabTargets.cmake
-  NAMESPACE stlab::
-  DESTINATION share/cmake/stlab)
-
-#
-# Install the CMake configuration files to the `share/cmake/stlab` subdirectory
-# of `$INSTALL_DIR/${CMAKE_INSTALL_PREFIX}`. This path will be searched by
-# default by the `find_package` intrinsic, provided
-# `$INSTALL_DIR/${CMAKE_INSTALL_PREFIX}` is an element of the
-# `CMAKE_PREFIX_PATH` environment variable.
-#
-configure_file(
-  "${stlab_SOURCE_DIR}/cmake/stlabConfig.cmake.in"
-  "${stlab_BINARY_DIR}/stlabConfig.cmake"
-  @ONLY)
-install(FILES
-  "${stlab_BINARY_DIR}/stlabConfig.cmake"
-  "${stlab_BINARY_DIR}/stlabConfigVersion.cmake"
-  DESTINATION share/cmake/stlab)

cmake/stlabConfig.cmake.in

@@ -10,11 +10,12 @@ To run a local Jekyll server, see the instructions in the docker-tools [README](
 
 ## Running Hyde in Docker
 
+<!-- 
 Configure the build as follows:
 
 ```
 cmake --preset=hyde-build-docs
-```
+``` -->
 
 Login to [GitHub Packages registry](https://docs.github.com/en/packages/working-with-a-github-packages-registry/working-with-the-container-registry#authenticating-with-a-personal-access-token-classic)
 
@@ -41,7 +42,7 @@ cd /mnt/host/libraries/docs
 ./about.sh
 ```
 
-\[ this is from the old docs - need to update the docs and script.
+<!-- \[ this is from the old docs - need to update the docs and script.
 
 > (or, simply `-u`) to generate the boilerplate for it. Then, fill in any fields marked as `__MISSING__`. Fields marked as `__OPTIONAL__` may be omitted.
-> \]
+> \] -->

docs/README.md

@@ -41,7 +41,7 @@
     "type": "User",
     "user_view_type": "public",
     "site_admin": false,
-    "contributions": 175
+    "contributions": 180
   },
   {
     "login": "fosterbrereton",
@@ -373,6 +373,28 @@
     "site_admin": false,
     "contributions": 1
   },
+  {
+    "login": "bmedina",
+    "id": 41739,
+    "node_id": "MDQ6VXNlcjQxNzM5",
+    "avatar_url": "https://avatars.githubusercontent.com/u/41739?v=4",
+    "gravatar_id": "",
+    "url": "https://api.github.com/users/bmedina",
+    "html_url": "https://github.com/bmedina",
+    "followers_url": "https://api.github.com/users/bmedina/followers",
+    "following_url": "https://api.github.com/users/bmedina/following{/other_user}",
+    "gists_url": "https://api.github.com/users/bmedina/gists{/gist_id}",
+    "starred_url": "https://api.github.com/users/bmedina/starred{/owner}{/repo}",
+    "subscriptions_url": "https://api.github.com/users/bmedina/subscriptions",
+    "organizations_url": "https://api.github.com/users/bmedina/orgs",
+    "repos_url": "https://api.github.com/users/bmedina/repos",
+    "events_url": "https://api.github.com/users/bmedina/events{/privacy}",
+    "received_events_url": "https://api.github.com/users/bmedina/received_events",
+    "type": "User",
+    "user_view_type": "public",
+    "site_admin": false,
+    "contributions": 1
+  },
   {
     "login": "laserallan",
     "id": 1781787,
@@ -527,6 +549,28 @@
     "site_admin": false,
     "contributions": 1
   },
+  {
+    "login": "venik",
+    "id": 54374,
+    "node_id": "MDQ6VXNlcjU0Mzc0",
+    "avatar_url": "https://avatars.githubusercontent.com/u/54374?v=4",
+    "gravatar_id": "",
+    "url": "https://api.github.com/users/venik",
+    "html_url": "https://github.com/venik",
+    "followers_url": "https://api.github.com/users/venik/followers",
+    "following_url": "https://api.github.com/users/venik/following{/other_user}",
+    "gists_url": "https://api.github.com/users/venik/gists{/gist_id}",
+    "starred_url": "https://api.github.com/users/venik/starred{/owner}{/repo}",
+    "subscriptions_url": "https://api.github.com/users/venik/subscriptions",
+    "organizations_url": "https://api.github.com/users/venik/orgs",
+    "repos_url": "https://api.github.com/users/venik/repos",
+    "events_url": "https://api.github.com/users/venik/events{/privacy}",
+    "received_events_url": "https://api.github.com/users/venik/received_events",
+    "type": "User",
+    "user_view_type": "public",
+    "site_admin": false,
+    "contributions": 1
+  },
   {
     "login": "fernandopFF",
     "id": 132451124,
@@ -614,49 +658,5 @@
     "user_view_type": "public",
     "site_admin": false,
     "contributions": 1
-  },
-  {
-    "login": "superfunc",
-    "id": 1583002,
-    "node_id": "MDQ6VXNlcjE1ODMwMDI=",
-    "avatar_url": "https://avatars.githubusercontent.com/u/1583002?v=4",
-    "gravatar_id": "",
-    "url": "https://api.github.com/users/superfunc",
-    "html_url": "https://github.com/superfunc",
-    "followers_url": "https://api.github.com/users/superfunc/followers",
-    "following_url": "https://api.github.com/users/superfunc/following{/other_user}",
-    "gists_url": "https://api.github.com/users/superfunc/gists{/gist_id}",
-    "starred_url": "https://api.github.com/users/superfunc/starred{/owner}{/repo}",
-    "subscriptions_url": "https://api.github.com/users/superfunc/subscriptions",
-    "organizations_url": "https://api.github.com/users/superfunc/orgs",
-    "repos_url": "https://api.github.com/users/superfunc/repos",
-    "events_url": "https://api.github.com/users/superfunc/events{/privacy}",
-    "received_events_url": "https://api.github.com/users/superfunc/received_events",
-    "type": "User",
-    "user_view_type": "public",
-    "site_admin": false,
-    "contributions": 1
-  },
-  {
-    "login": "thinlang",
-    "id": 37256192,
-    "node_id": "MDQ6VXNlcjM3MjU2MTky",
-    "avatar_url": "https://avatars.githubusercontent.com/u/37256192?v=4",
-    "gravatar_id": "",
-    "url": "https://api.github.com/users/thinlang",
-    "html_url": "https://github.com/thinlang",
-    "followers_url": "https://api.github.com/users/thinlang/followers",
-    "following_url": "https://api.github.com/users/thinlang/following{/other_user}",
-    "gists_url": "https://api.github.com/users/thinlang/gists{/gist_id}",
-    "starred_url": "https://api.github.com/users/thinlang/starred{/owner}{/repo}",
-    "subscriptions_url": "https://api.github.com/users/thinlang/subscriptions",
-    "organizations_url": "https://api.github.com/users/thinlang/orgs",
-    "repos_url": "https://api.github.com/users/thinlang/repos",
-    "events_url": "https://api.github.com/users/thinlang/events{/privacy}",
-    "received_events_url": "https://api.github.com/users/thinlang/received_events",
-    "type": "User",
-    "user_view_type": "public",
-    "site_admin": false,
-    "contributions": 1
   }
 ]