Initial release: Modern C++17 Thread Pool Library

Features:
- Header-only library with zero dependencies
- Configurable worker thread count
- Typed futures for return values
- Work-stealing scheduler for load balancing
- Priority task scheduling
- Thread-safe task queue with condition variables
- Graceful shutdown with wait/cancel options
- Pool statistics and metrics
- Comprehensive test suite
- Performance benchmarks
- Example applications (parallel sort, web crawler)

Author: Rishabh Rohil

.github/workflows/ci.yml

@@ -0,0 +1,68 @@
+name: CI
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  build-linux:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        compiler: [gcc, clang]
+        build_type: [Debug, Release]
+    
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Install dependencies
+      run: |
+        sudo apt-get update
+        sudo apt-get install -y cmake ninja-build
+    
+    - name: Configure CMake
+      run: |
+        cmake -B build -G Ninja \
+          -DCMAKE_BUILD_TYPE=${{ matrix.build_type }} \
+          -DCMAKE_CXX_COMPILER=${{ matrix.compiler == 'gcc' && 'g++' || 'clang++' }}
+    
+    - name: Build
+      run: cmake --build build
+    
+    - name: Test
+      working-directory: build
+      run: ctest --output-on-failure
+
+  build-macos:
+    runs-on: macos-latest
+    
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Configure CMake
+      run: cmake -B build -DCMAKE_BUILD_TYPE=Release
+    
+    - name: Build
+      run: cmake --build build
+    
+    - name: Test
+      working-directory: build
+      run: ctest --output-on-failure
+
+  build-windows:
+    runs-on: windows-latest
+    
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Configure CMake
+      run: cmake -B build
+    
+    - name: Build
+      run: cmake --build build --config Release
+    
+    - name: Test
+      working-directory: build
+      run: ctest -C Release --output-on-failure

.gitignore

@@ -0,0 +1,39 @@
+# Build directories
+build/
+cmake-build-*/
+out/
+
+# IDE files
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# Compiled files
+*.o
+*.obj
+*.exe
+*.out
+*.app
+
+# CMake generated
+CMakeCache.txt
+CMakeFiles/
+cmake_install.cmake
+Makefile
+compile_commands.json
+
+# Testing
+Testing/
+CTestTestfile.cmake
+
+# Package files
+*.tar.gz
+*.zip
+
+# macOS
+.DS_Store
+
+# Windows
+Thumbs.db

CMakeLists.txt

@@ -0,0 +1,63 @@
+cmake_minimum_required(VERSION 3.16)
+project(cpp-threadpool 
+    VERSION 1.0.0
+    DESCRIPTION "Modern C++17 thread pool library"
+    LANGUAGES CXX
+)
+
+# C++17 required
+set(CMAKE_CXX_STANDARD 17)
+set(CMAKE_CXX_STANDARD_REQUIRED ON)
+set(CMAKE_CXX_EXTENSIONS OFF)
+
+# Options
+option(THREADPOOL_BUILD_TESTS "Build unit tests" ON)
+option(THREADPOOL_BUILD_EXAMPLES "Build examples" ON)
+option(THREADPOOL_BUILD_BENCHMARKS "Build benchmarks" ON)
+
+# Header-only library target
+add_library(threadpool INTERFACE)
+add_library(tp::threadpool ALIAS threadpool)
+
+target_include_directories(threadpool INTERFACE
+    $<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/include>
+    $<INSTALL_INTERFACE:include>
+)
+
+target_compile_features(threadpool INTERFACE cxx_std_17)
+
+# Find threads
+find_package(Threads REQUIRED)
+target_link_libraries(threadpool INTERFACE Threads::Threads)
+
+# Tests
+if(THREADPOOL_BUILD_TESTS)
+    enable_testing()
+    add_subdirectory(tests)
+endif()
+
+# Examples
+if(THREADPOOL_BUILD_EXAMPLES)
+    add_subdirectory(examples)
+endif()
+
+# Benchmarks
+if(THREADPOOL_BUILD_BENCHMARKS)
+    add_subdirectory(benchmarks)
+endif()
+
+# Installation
+include(GNUInstallDirs)
+install(TARGETS threadpool
+    EXPORT threadpool-targets
+)
+
+install(DIRECTORY include/threadpool
+    DESTINATION ${CMAKE_INSTALL_INCLUDEDIR}
+)
+
+install(EXPORT threadpool-targets
+    FILE threadpool-config.cmake
+    NAMESPACE tp::
+    DESTINATION ${CMAKE_INSTALL_LIBDIR}/cmake/threadpool
+)

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Rishabh Rohil
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.