Safety, Zig, and C APIs

.github/workflows/prerelease.yml

@@ -24,22 +24,22 @@ jobs:
           fetch-depth: 0
           persist-credentials: false
       - name: Run TinySemVer
-        uses: ashvardanian/tinysemver@v2.1.1
+        uses: ashvardanian/tinysemver@v3
         with:
           verbose: "true"
           version-file: "VERSION"
           update-version-in: |
             CMakeLists.txt:^\s*VERSION (\d+\.\d+\.\d+)
             Cargo.toml:^version = "(\d+\.\d+\.\d+)"
             README.md:^\s*GIT_TAG v(\d+\.\d+\.\d+)
-            README.md:^\s*fork_union\s*=\s*"(\d+\.\d+\.\d+)"
-            README.md:^\s*fork_union\s*=\s*\{\s*version\s*=\s*"(\d+\.\d+\.\d+)"
+            README.md:^\s*forkunion\s*=\s*"(\d+\.\d+\.\d+)"
+            README.md:^\s*forkunion\s*=\s*\{\s*version\s*=\s*"(\d+\.\d+\.\d+)"
           update-major-version-in: |
-            include/fork_union.hpp:^#define FORK_UNION_VERSION_MAJOR (\d+)
+            include/forkunion.hpp:^#define FORKUNION_VERSION_MAJOR (\d+)
           update-minor-version-in: |
-            include/fork_union.hpp:^#define FORK_UNION_VERSION_MINOR (\d+)
+            include/forkunion.hpp:^#define FORKUNION_VERSION_MINOR (\d+)
           update-patch-version-in: |
-            include/fork_union.hpp:^#define FORK_UNION_VERSION_PATCH (\d+)
+            include/forkunion.hpp:^#define FORKUNION_VERSION_PATCH (\d+)
           dry-run: "true"
 
   test_ubuntu_gcc:
@@ -62,9 +62,15 @@ jobs:
       - name: Test C++
         run: |
           set -euxo pipefail
-          build_artifacts/fork_union_test_cpp17
-          build_artifacts/fork_union_test_cpp20
-          build_artifacts/fork_union_test_cpp23
+          build_artifacts/forkunion_test_cpp17
+          build_artifacts/forkunion_test_cpp20
+          build_artifacts/forkunion_test_cpp23
+
+      - name: Test C
+        run: |
+          set -euxo pipefail
+          build_artifacts/forkunion_test_c11
+          build_artifacts/forkunion_test_c_gcc_nested
 
       - name: Set up Rust
         run: |
@@ -91,15 +97,21 @@ jobs:
       - name: Build C/C++
         run: |
           sudo apt update
-          sudo apt install -y cmake build-essential clang
+          sudo apt install -y cmake build-essential clang libblocksruntime-dev
           cmake -B build_artifacts -D CMAKE_BUILD_TYPE=RelWithDebInfo
           cmake --build build_artifacts --config RelWithDebInfo
       - name: Test C++
         run: |
           set -euxo pipefail
-          build_artifacts/fork_union_test_cpp17
-          build_artifacts/fork_union_test_cpp20
-          build_artifacts/fork_union_test_cpp23
+          build_artifacts/forkunion_test_cpp17
+          build_artifacts/forkunion_test_cpp20
+          build_artifacts/forkunion_test_cpp23
+
+      - name: Test C
+        run: |
+          set -euxo pipefail
+          build_artifacts/forkunion_test_c11
+          build_artifacts/forkunion_test_c_clang_blocks
 
       - name: Set up Rust
         run: |
@@ -128,9 +140,14 @@ jobs:
       - name: Test C++
         run: |
           set -euxo pipefail
-          build_artifacts/fork_union_test_cpp17
-          build_artifacts/fork_union_test_cpp20
-          build_artifacts/fork_union_test_cpp23
+          build_artifacts/forkunion_test_cpp17
+          build_artifacts/forkunion_test_cpp20
+          build_artifacts/forkunion_test_cpp23
+
+      - name: Test C
+        run: |
+          set -euxo pipefail
+          build_artifacts/forkunion_test_c11
 
       - name: Set up Rust
         run: |
@@ -159,19 +176,23 @@ jobs:
           brew update
           brew reinstall cmake llvm@${{ matrix.llvm }}
 
-      - name: Configure (CMake)
+      - name: Build C/C++
         run: |
           cmake -S . -B build_artifacts -D CMAKE_BUILD_TYPE=${{ matrix.config }} -D CMAKE_CXX_COMPILER=$(brew --prefix llvm@${{ matrix.llvm }})/bin/clang++
+          cmake --build build_artifacts --config ${{ matrix.config }} --parallel
 
-      - name: Build
-        run: cmake --build build_artifacts --config ${{ matrix.config }} --parallel
+      - name: Test C++
+        run: |
+          set -euxo pipefail
+          build_artifacts/forkunion_test_cpp17
+          build_artifacts/forkunion_test_cpp20
+          build_artifacts/forkunion_test_cpp23
 
-      - name: Run C++ tests
+      - name: Test C
         run: |
           set -euxo pipefail
-          build_artifacts/fork_union_test_cpp17
-          build_artifacts/fork_union_test_cpp20
-          build_artifacts/fork_union_test_cpp23
+          build_artifacts/forkunion_test_c11
+          build_artifacts/forkunion_test_c_clang_blocks
 
   test_windows:
     name: Windows
@@ -190,9 +211,13 @@ jobs:
       - name: Test C++
         run: |
           $ErrorActionPreference = "Stop"
-          .\build_artifacts\fork_union_test_cpp17.exe
-          .\build_artifacts\fork_union_test_cpp20.exe
-          .\build_artifacts\fork_union_test_cpp23.exe
+          .\build_artifacts\forkunion_test_cpp17.exe
+          .\build_artifacts\forkunion_test_cpp20.exe
+          .\build_artifacts\forkunion_test_cpp23.exe
+
+      - name: Test C
+        run: |
+          Write-Host "MSVC still lacks <stdatomic.h>; skipping C test binary"
 
       - name: Set up Rust
         run: |
@@ -226,9 +251,13 @@ jobs:
       - name: Test C++
         run: |
           $ErrorActionPreference = "Stop"
-          .\build_artifacts\fork_union_test_cpp17.exe
-          .\build_artifacts\fork_union_test_cpp20.exe
-          .\build_artifacts\fork_union_test_cpp23.exe
+          .\build_artifacts\forkunion_test_cpp17.exe
+          .\build_artifacts\forkunion_test_cpp20.exe
+          .\build_artifacts\forkunion_test_cpp23.exe
+
+      - name: Test C
+        run: |
+          Write-Host "MSVC still lacks <stdatomic.h>; skipping C test binary"
 
   test_i386:
     name: Cross-compilation (i386)
@@ -245,12 +274,16 @@ jobs:
       - name: Build C++
         run: |
           cmake -B build_i386 -D CMAKE_C_FLAGS=-m32 -D CMAKE_CXX_FLAGS=-m32 -D CMAKE_BUILD_TYPE=RelWithDebInfo
-          cmake --build build_i386 --target fork_union_test_cpp17 fork_union_test_cpp20
+          cmake --build build_i386 --target forkunion_test_cpp17 forkunion_test_cpp20 forkunion_test_c11
 
       - name: Test C++
         run: |
-          build_i386/fork_union_test_cpp17
-          build_i386/fork_union_test_cpp20
+          build_i386/forkunion_test_cpp17
+          build_i386/forkunion_test_cpp20
+
+      - name: Test C
+        run: |
+          build_i386/forkunion_test_c11
 
   test_armhf:
     name: Cross-compilation (armhf)
@@ -266,13 +299,17 @@ jobs:
 
       - name: Build C++
         run: |
-          cmake -B build_armhf -D CMAKE_CXX_COMPILER=arm-linux-gnueabihf-g++ -D CMAKE_BUILD_TYPE=RelWithDebInfo
-          cmake --build build_armhf --target fork_union_test_cpp17 fork_union_test_cpp20
+          cmake -B build_armhf -D CMAKE_C_COMPILER=arm-linux-gnueabihf-gcc -D CMAKE_CXX_COMPILER=arm-linux-gnueabihf-g++ -D CMAKE_BUILD_TYPE=RelWithDebInfo
+          cmake --build build_armhf --target forkunion_test_cpp17 forkunion_test_cpp20 forkunion_test_c11
 
       - name: Test C++
         run: |
-          qemu-arm-static -L /usr/arm-linux-gnueabihf build_armhf/fork_union_test_cpp17
-          qemu-arm-static -L /usr/arm-linux-gnueabihf build_armhf/fork_union_test_cpp20
+          qemu-arm-static -L /usr/arm-linux-gnueabihf build_armhf/forkunion_test_cpp17
+          qemu-arm-static -L /usr/arm-linux-gnueabihf build_armhf/forkunion_test_cpp20
+
+      - name: Test C
+        run: |
+          qemu-arm-static -L /usr/arm-linux-gnueabihf build_armhf/forkunion_test_c11
 
   test_s390x:
     name: Cross-compilation (s390x)
@@ -288,10 +325,14 @@ jobs:
 
       - name: Build C++
         run: |
-          cmake -B build_s390x -D CMAKE_CXX_COMPILER=s390x-linux-gnu-g++ -D CMAKE_BUILD_TYPE=RelWithDebInfo
-          cmake --build build_s390x --target fork_union_test_cpp17 fork_union_test_cpp20
+          cmake -B build_s390x -D CMAKE_C_COMPILER=s390x-linux-gnu-gcc -D CMAKE_CXX_COMPILER=s390x-linux-gnu-g++ -D CMAKE_BUILD_TYPE=RelWithDebInfo
+          cmake --build build_s390x --target forkunion_test_cpp17 forkunion_test_cpp20 forkunion_test_c11
 
       - name: Test C++
         run: |
-          qemu-s390x-static -L /usr/s390x-linux-gnu build_s390x/fork_union_test_cpp17
-          qemu-s390x-static -L /usr/s390x-linux-gnu build_s390x/fork_union_test_cpp20
+          qemu-s390x-static -L /usr/s390x-linux-gnu build_s390x/forkunion_test_cpp17
+          qemu-s390x-static -L /usr/s390x-linux-gnu build_s390x/forkunion_test_cpp20
+
+      - name: Test C
+        run: |
+          qemu-s390x-static -L /usr/s390x-linux-gnu build_s390x/forkunion_test_c11

.github/workflows/release.yml

@@ -27,22 +27,22 @@ jobs:
           fetch-depth: 0
           persist-credentials: false
       - name: Run TinySemVer
-        uses: ashvardanian/tinysemver@v2.1.1
+        uses: ashvardanian/tinysemver@v3
         with:
           verbose: "true"
           version-file: "VERSION"
           update-version-in: |
             CMakeLists.txt:^\s*VERSION (\d+\.\d+\.\d+)
             Cargo.toml:^version = "(\d+\.\d+\.\d+)"
             README.md:^\s*GIT_TAG v(\d+\.\d+\.\d+)
-            README.md:^\s*fork_union\s*=\s*"(\d+\.\d+\.\d+)"
-            README.md:^\s*fork_union\s*=\s*\{\s*version\s*=\s*"(\d+\.\d+\.\d+)"
+            README.md:^\s*forkunion\s*=\s*"(\d+\.\d+\.\d+)"
+            README.md:^\s*forkunion\s*=\s*\{\s*version\s*=\s*"(\d+\.\d+\.\d+)"
           update-major-version-in: |
-            include/fork_union.hpp:^#define FORK_UNION_VERSION_MAJOR (\d+)
+            include/forkunion.hpp:^#define FORKUNION_VERSION_MAJOR (\d+)
           update-minor-version-in: |
-            include/fork_union.hpp:^#define FORK_UNION_VERSION_MINOR (\d+)
+            include/forkunion.hpp:^#define FORKUNION_VERSION_MINOR (\d+)
           update-patch-version-in: |
-            include/fork_union.hpp:^#define FORK_UNION_VERSION_PATCH (\d+)
+            include/forkunion.hpp:^#define FORKUNION_VERSION_PATCH (\d+)
           dry-run: "false"
           push: "true"
           create-release: "true"

.gitignore

@@ -38,3 +38,6 @@
 # Rust build artifacts
 Cargo.lock
 target/
+.zig-cache/
+zig-out/
+zig-cache/

.vscode/launch.json

@@ -9,7 +9,7 @@
             "type": "cppdbg",
             "request": "launch",
             "preLaunchTask": "Build: Debug with GDB",
-            "program": "${workspaceFolder}/build_debug/fork_union_test_cpp20",
+            "program": "${workspaceFolder}/build_debug/forkunion_test_cpp20",
             "cwd": "${workspaceFolder}",
             "args": [],
             "setupCommands": [
@@ -40,7 +40,7 @@
                 "MIMode": "gdb"
             },
             "windows": {
-                "program": "${workspaceFolder}\\build_debug\\scripts\\fork_union_test_cpp20.exe",
+                "program": "${workspaceFolder}\\build_debug\\scripts\\forkunion_test_cpp20.exe",
                 "MIMode": "gdb",
                 "miDebuggerPath": "C:\\MinGw\\bin\\gdb.exe"
             }
@@ -50,7 +50,7 @@
             "type": "cppdbg",
             "request": "launch",
             "preLaunchTask": "Build: Debug i386 with GDB",
-            "program": "${workspaceFolder}/build_i386/fork_union_test_cpp20",
+            "program": "${workspaceFolder}/build_i386/forkunion_test_cpp20",
             "cwd": "${workspaceFolder}",
             "args": [],
             "setupCommands": [
@@ -86,7 +86,7 @@
             "type": "cppdbg",
             "request": "launch",
             "preLaunchTask": "Build: Debug with LLDB",
-            "program": "${workspaceFolder}/build_debug/fork_union_test_cpp20",
+            "program": "${workspaceFolder}/build_debug/forkunion_test_cpp20",
             "cwd": "${workspaceFolder}",
             "args": [],
             "setupCommands": [
@@ -116,7 +116,7 @@
             "type": "cppdbg",
             "request": "launch",
             "preLaunchTask": "Build: Debug with GDB",
-            "program": "${workspaceFolder}/build_debug/fork_union_nbody",
+            "program": "${workspaceFolder}/build_debug/forkunion_nbody",
             "cwd": "${workspaceFolder}",
             "args": [],
             "setupCommands": [
@@ -146,7 +146,7 @@
                 },
                 {
                     "name": "NBODY_BACKEND",
-                    "value": "fork_union_dynamic"
+                    "value": "forkunion_dynamic"
                 }
             ],
             "stopAtEntry": false,

.vscode/settings.json

@@ -9,28 +9,52 @@
         "editor.insertSpaces": true,
         "editor.tabSize": 4
     },
+    "[yaml]": {
+        "editor.detectIndentation": false,
+        "editor.insertSpaces": true,
+        "editor.tabSize": 2,
+        "prettier.tabWidth": 2
+    },
+    "[yml]": {
+        "editor.detectIndentation": false,
+        "editor.insertSpaces": true,
+        "editor.tabSize": 2,
+        "prettier.tabWidth": 2
+    },
     "cSpell.words": [
+        "anyopaque",
+        "anytype",
         "ashvardanian",
+        "callconv",
         "cntfrq",
         "cntvct",
         "codegen",
         "colocations",
         "combinators",
+        "comptime",
         "Condvar",
         "constexpr",
         "coprime",
         "ctest",
+        "forkunion",
         "fprintf",
         "futex",
         "gethugepagesizes",
+        "Hashimoto",
         "hugepages",
         "HugeTLBfs",
         "inclusivity",
         "libnuma",
+        "libxev",
+        "Miri",
+        "MSRV",
+        "MSVC",
         "nbody",
         "noexcept",
         "NUMA",
         "OpenMP",
+        "orelse",
+        "overaligned",
         "prefetcher",
         "println",
         "pthreads",
@@ -43,8 +67,10 @@
         "STREQUAL",
         "SysCall",
         "SysFS",
+        "tinysemver",
         "topo",
         "TSAN",
+        "usize",
         "Vardanian",
         "vecs",
         "WFET"