Add initial KDNetwork library

.clang-tidy

@@ -1,56 +1,58 @@
 ---
 Checks: '*,
-clang-analyzer-*,
-clang-diagnostic-*,
--abseil-*,
--altera-*,
--android-*,
--bugprone-suspicious-include,
--boost-use-ranges,
--clang-analyzer-alpha.core.CastToStruct,
--clang-analyzer-alpha.deadcode.UnreachableCode,
--clang-analyzer-alpha*,
--clang-analyzer-core.CallAndMessage,
--clang-analyzer-core.NonNullParamChecker,
--clang-analyzer-cplusplus.NewDeleteLeaks,
--clang-analyzer-optin.core.EnumCastOutOfRange,
--clang-diagnostic-gnu-zero-variadic-macro-arguments,
--cppcoreguidelines-*,
--fuchsia-*,
--google-*,
--hicpp-*,
--llvm-*,
--llvm-include-order,
--llvm-namespace-comment,
--llvmlibc-*,
--misc-include-cleaner,
--misc-no-recursion,
--misc-non-private-member-variables-in-classes,
--modernize-loop-convert,
--modernize-pass-by-value,
--modernize-raw-string-literal,
--modernize-return-braced-init-list,
--modernize-use-bool-literals,
--modernize-use-default-member-init,
--modernize-use-default,
--modernize-use-emplace,
--modernize-use-equals-default,
--modernize-use-override,
--modernize-use-trailing-return-type,
--modernize-use-using,
--readability-braces-around-statements,
--readability-else-after-return,
--readability-function-cognitive-complexity,
--readability-identifier-length,
--readability-implicit-bool-cast,
--readability-implicit-bool-conversion,
--readability-magic-numbers,
--readability-named-parameter,
--readability-qualified-auto,
--readability-uppercase-literal-suffix,
--readabilty-namespace-comments'
+  clang-analyzer-*,
+  clang-diagnostic-*,
+  -abseil-*,
+  -altera-*,
+  -android-*,
+  -boost-use-ranges,
+  -bugprone-branch-clone,
+  -bugprone-easily-swappable-parameters,
+  -bugprone-suspicious-include,
+  -clang-analyzer-alpha.core.CastToStruct,
+  -clang-analyzer-alpha.deadcode.UnreachableCode,
+  -clang-analyzer-alpha*,
+  -clang-analyzer-core.CallAndMessage,
+  -clang-analyzer-core.NonNullParamChecker,
+  -clang-analyzer-cplusplus.NewDeleteLeaks,
+  -clang-analyzer-optin.core.EnumCastOutOfRange,
+  -clang-diagnostic-gnu-zero-variadic-macro-arguments,
+  -cppcoreguidelines-*,
+  -fuchsia-*,
+  -google-*,
+  -hicpp-*,
+  -llvm-*,
+  -llvm-include-order,
+  -llvm-namespace-comment,
+  -llvmlibc-*,
+  -misc-include-cleaner,
+  -misc-no-recursion,
+  -misc-non-private-member-variables-in-classes,
+  -modernize-loop-convert,
+  -modernize-pass-by-value,
+  -modernize-raw-string-literal,
+  -modernize-return-braced-init-list,
+  -modernize-use-bool-literals,
+  -modernize-use-default-member-init,
+  -modernize-use-default,
+  -modernize-use-emplace,
+  -modernize-use-equals-default,
+  -modernize-use-override,
+  -modernize-use-trailing-return-type,
+  -modernize-use-using,
+  -performance-avoid-endl,
+  -readability-braces-around-statements,
+  -readability-else-after-return,
+  -readability-function-cognitive-complexity,
+  -readability-identifier-length,
+  -readability-implicit-bool-cast,
+  -readability-implicit-bool-conversion,
+  -readability-magic-numbers,
+  -readability-named-parameter,
+  -readability-qualified-auto,
+  -readability-uppercase-literal-suffix,
+  -readabilty-namespace-comments'
 WarningsAsErrors: ''
-HeaderFilterRegex: ''
 CheckOptions:
   - key:             cert-oop11-cpp.UseCERTSemantics
     value:           '1'

.github/workflows/build-external.yml

@@ -17,12 +17,13 @@ on:
 
 jobs:
   build:
-    runs-on: ${{ matrix.os }}
+    runs-on: ${{ matrix.platform.os }}
     strategy:
       fail-fast: true
       matrix:
-        os:
-          - macos-latest
+        platform:
+          - os: macos-latest
+            triplet: arm64-osx-release
         shared:
           - ON
           - OFF
@@ -39,11 +40,20 @@ jobs:
           brew tap KDAB/tap
           brew install fmt spdlog KDBindings mosquitto
 
+      - name: Set up vcpkg
+        id: vcpkg
+        uses: johnwason/vcpkg-action@v6
+        with:
+          token: ${{ github.token }}
+          triplet: ${{ matrix.platform.triplet }}
+          manifest-dir: ${{ github.workspace }}
+
       - name: Configure project
         run: >
           cmake -S . -B ./build -DCMAKE_BUILD_TYPE=Debug -G Ninja
           -DKDUTILS_BUILD_TESTS=ON
           -DBUILD_SHARED_LIBS=${{ matrix.shared }}
+          ${{ steps.vcpkg.outputs.vcpkg-cmake-config }}
 
       - name: Check if external dependencies were used
         run: |

.github/workflows/build.yml

@@ -14,18 +14,25 @@ on:
 
 jobs:
   build:
-    runs-on: ${{ matrix.os }}
+    runs-on: ${{ matrix.platform.os }}
     strategy:
       fail-fast: true
       matrix:
-        os:
-          - ubuntu-24.04
-          - ubuntu-22.04
-          - ubuntu-24.04-arm
-          - windows-2022
-          - macos-13
-          - macos-14
-          - macos-15
+        platform:
+          - os: ubuntu-24.04
+            triplet: x64-linux-release
+          - os: ubuntu-22.04
+            triplet: x64-linux-release
+          - os: ubuntu-24.04-arm
+            triplet: arm64-linux-release
+          - os: windows-2022
+            triplet: x64-windows-release
+          - os: macos-13
+            triplet: x64-osx-release
+          - os: macos-14
+            triplet: arm64-osx-release
+          - os: macos-15
+            triplet: arm64-osx-release
         build_type:
           - Debug
           - Release
@@ -54,7 +61,8 @@ jobs:
           sudo apt install -y libxkbcommon-dev libxcb-xkb-dev \
           libxkbcommon-x11-dev wayland-scanner++ wayland-protocols \
           libwayland-dev xvfb ninja-build \
-          libmosquitto-dev gcovr
+          libmosquitto-dev gcovr \
+          linux-libc-dev
 
       - name: Download mosquitto (MacOS)
         if: runner.os == 'macOS'
@@ -68,13 +76,25 @@ jobs:
             https://mosquitto.org/files/binary/win64/mosquitto-$env:MOSQUITTO_VERSION-install-windows-x64.exe
           & .\mosquitto-$env:MOSQUITTO_VERSION-install-windows-x64.exe /S
 
+      - name: Set up vcpkg
+        id: vcpkg
+        uses: johnwason/vcpkg-action@v6
+        with:
+          token: ${{ github.token }}
+          triplet: ${{ matrix.platform.triplet }}
+          manifest-dir: ${{ github.workspace }}
+
       - name: Configure project
         run: >
           cmake -S . -B ./build -G Ninja
           -DCMAKE_BUILD_TYPE=${{ matrix.build_type }}
           -DKDUTILS_CODE_COVERAGE=${{ matrix.build_type == 'Debug' && runner.os == 'Linux' }}
           -DKDUTILS_BUILD_TESTS=${{ matrix.build_type == 'Debug' }}
           -DBUILD_SHARED_LIBS=${{ matrix.link_type == 'shared' }}
+          -DCMAKE_TOOLCHAIN_FILE=${{ github.workspace }}/vcpkg/scripts/buildsystems/vcpkg.cmake
+          -DVCPKG_TARGET_TRIPLET=${{ matrix.platform.triplet }}
+          -DVCPKG_MANIFEST_MODE=OFF
+          ${{ steps.vcpkg.outputs.vcpkg-cmake-config }}
 
       - name: Build Project
         run: cmake --build ./build

.github/workflows/linters.yml

@@ -20,11 +20,13 @@ jobs:
         include:
           - name: Ubuntu
             os: ubuntu-24.04
+            triplet: x64-linux-release
             # Specify executable name on Linux to have control over the version.
             # Sadly, on Linux these per-version executables aren't there.
             tidy-executable: clang-tidy-18
           - name: Windows
             os: windows-2022
+            triplet: x64-windows-release
             tidy-executable: clang-tidy
       fail-fast: false
 
@@ -44,11 +46,20 @@ jobs:
           libxkbcommon-x11-dev wayland-scanner++ wayland-protocols \
           libwayland-dev xvfb ninja-build cppcheck libmosquitto-dev
 
+      - name: Set up vcpkg
+        id: vcpkg
+        uses: johnwason/vcpkg-action@v6
+        with:
+          token: ${{ github.token }}
+          triplet: ${{ matrix.triplet }}
+          manifest-dir: ${{ github.workspace }}
+
       - name: Configure project
         run: >
           cmake -S . -B build -G Ninja -DKDUTILS_BUILD_TESTS=True
           -DCMAKE_CXX_CLANG_TIDY="${{matrix.tidy-executable}}"
           -DCMAKE_BUILD_TYPE=Release -DKDUTILS_BUILD_TESTS=ON
+          ${{ steps.vcpkg.outputs.vcpkg-cmake-config }}
 
       - name: Build Project
         shell: pwsh

.pre-commit-config.yaml

@@ -30,7 +30,7 @@ repos:
   rev: v0.18.1
   hooks:
   - id: markdownlint-cli2
-    exclude: ^(3rdParty/|common/ui/resources/licenses/)
+    exclude: ^(3rdParty/|common/ui/resources/licenses/|kdnetwork-plan.md|sse-plan.md|websockets-plan.md)
     files: \.(md|mdown|markdown)$
 - repo: https://github.com/fsfe/reuse-tool
   rev: v5.0.2

CMakeLists.txt

@@ -38,8 +38,10 @@ set(CMAKE_CXX_STANDARD_REQUIRED ON)
 
 cmake_policy(SET CMP0090 NEW) # Stop export(PACKAGE) from modifying the system-wide cmake package system
 cmake_policy(SET CMP0117 NEW) # Do not add /GR to CMAKE_CXX_FLAGS
+cmake_policy(SET CMP0135 NEW) # Use current timestamp when extracting tarball for FetchContent
 
 option(KDUTILS_BUILD_EXAMPLES "Build examples" ON)
+option(KDUTILS_BUILD_NETWORK_SUPPORT "Build KDNetwork" ON)
 
 include(FeatureSummary)
 include(CMakeDependentOption)
@@ -72,6 +74,10 @@ add_subdirectory(src/KDUtils)
 add_subdirectory(src/KDFoundation)
 add_subdirectory(src/KDGui)
 
+if(KDUTILS_BUILD_NETWORK_SUPPORT)
+    add_subdirectory(src/KDNetwork)
+endif()
+
 if(KDUTILS_BUILD_MQTT_SUPPORT)
     add_subdirectory(src/KDMqtt)
 endif()

CMakePresets.json

@@ -1,5 +1,5 @@
 {
-    "version": 2,
+    "version": 3,
     "configurePresets": [
         {
             "name": "configure-base",
@@ -25,7 +25,8 @@
             "cacheVariables": {
                 "CMAKE_C_COMPILER": "cl",
                 "CMAKE_CXX_COMPILER": "cl"
-            }
+            },
+            "toolchainFile": "${env.VCPKG_ROOT}/scripts/buildsystems/vcpkg.cmake"
         },
         {
             "name": "debug",
@@ -85,8 +86,10 @@
             "binaryDir": "${sourceDir}/build/Release-clangtidy",
             "cacheVariables": {
                 "CMAKE_CXX_CLANG_TIDY": "clang-tidy",
-                "KDUTILS_BUILD_TESTS": "ON"
-            }
+                "KDUTILS_BUILD_TESTS": "ON",
+                "KDUTILS_BUILD_MQTT_SUPPORT": "OFF"
+            },
+            "toolchainFile": "${env.VCPKG_ROOT}/scripts/buildsystems/vcpkg.cmake"
         },
         {
             "name": "profile",

README.md

@@ -50,6 +50,18 @@ You may also want to have a look at the
 [CI configuration](https://github.com/KDAB/KDUtils/blob/main/.github/workflows/build.yml)
 of this project to see which dependencies we use to build KDMqtt.
 
+## KDNetwork
+
+KDNetwork provides an experimental event-driven networking library on top of raw BSD sockets,
+KDFoundation and KDBindings.
+
+This library is still considered unstable and in development. As such we do not make any promises
+for API or ABI stability at this time. Please do feel free to take it for a test drive on Windows
+or Linux.
+
+KDNetwork offers support for TCP and SSL/TLS socket communications; non-blocking DNS resolution
+queries; higher-level protocols such as HTTPS, Server Sent Events and WebSockets.
+
 ## KDUtils/KDUtils
 
 This namespace is the namesake of the entire library, and contains the STL

REUSE.toml

@@ -12,14 +12,14 @@ SPDX-License-Identifier = "MIT"
 
 #misc documentation
 [[annotations]]
-path = ["ChangeLog", "**README.md"]
+path = ["ChangeLog", "**README.md", "kdnetwork-plan.md", "sse-plan.md", "websockets-plan.md"]
 precedence = "aggregate"
 SPDX-FileCopyrightText = "Klarälvdalens Datakonsult AB, a KDAB Group company <info@kdab.com>"
 SPDX-License-Identifier = "MIT"
 
 #misc config files
 [[annotations]]
-path = [".pre-commit-config.yaml", ".codespellrc", ".krazy", ".cmake-format.py", "**.clang-format", ".clang-tidy", "**.gitignore", ".gitreview", ".markdownlint.jsonc", "appveyor.yml", "REUSE.toml"]
+path = [".pre-commit-config.yaml", ".codespellrc", ".krazy", ".cmake-format.py", "**.clang-format", ".clang-tidy", "**.gitignore", ".gitreview", ".markdownlint.jsonc", ".markdownlintignore", "appveyor.yml", "REUSE.toml", "vcpkg.json"]
 precedence = "aggregate"
 SPDX-FileCopyrightText = "Klarälvdalens Datakonsult AB, a KDAB Group company <info@kdab.com>"
 SPDX-License-Identifier = "BSD-3-Clause"