capio-calf 0.1.0__tar.gz

capio_calf-0.1.0/.clang-format

@@ -0,0 +1,10 @@
+AlignConsecutiveAssignments:
+  Enabled: true
+  AcrossComments: true
+BasedOnStyle: LLVM
+ColumnLimit: 100
+IndentWidth: 4
+InsertBraces: true
+Language: Cpp
+SpaceAfterCStyleCast: true
+Standard: c++17

capio_calf-0.1.0/.github/workflows/cpp-tests.yml

@@ -0,0 +1,90 @@
+name: C++ Unit Tests
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+concurrency:
+  group: cpp-tests-${{ github.event.pull_request.number || github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  linux-tests:
+    name: ${{ matrix.build_type }} with ${{ matrix.compiler }}
+    runs-on: ubuntu-24.04
+    strategy:
+      fail-fast: false
+      matrix:
+        build_type: [Debug, Release]
+        compiler:
+          - gcc:9
+          - gcc:10
+          - gcc:11
+          - gcc:12
+          - gcc:13
+          - silkeh/clang:13
+          - silkeh/clang:14
+          - silkeh/clang:15
+          - silkeh/clang:16
+          - silkeh/clang:17
+          - silkeh/clang:18
+
+    container:
+      image: ${{ matrix.compiler }}
+
+    steps:
+      - uses: actions/checkout@v7
+
+      - name: Install build tools
+        run: |
+          apt-get update
+          apt-get install -y cmake git ninja-build
+
+      - name: Configure
+        shell: bash
+        run: |
+          cmake -S "${GITHUB_WORKSPACE}" \
+                -B "${GITHUB_WORKSPACE}/build" \
+                -G Ninja \
+                -DCMAKE_BUILD_TYPE=${{ matrix.build_type }} \
+                -DCALF_TESTS=ON \
+                -DCALF_PYTHON_TESTS=OFF
+
+      - name: Build
+        run: cmake --build "${GITHUB_WORKSPACE}/build" --parallel
+
+      - name: Run C++ tests
+        working-directory: build
+        run: ctest --output-on-failure
+
+  macos-tests:
+    name: ${{ matrix.build_type }} with AppleClang
+    runs-on: macos-15
+    strategy:
+      fail-fast: false
+      matrix:
+        build_type: [Debug, Release]
+
+    steps:
+      - uses: actions/checkout@v7
+
+      - name: Install build tools
+        run: brew install cmake ninja
+
+      - name: Configure
+        run: |
+          cmake -S "${GITHUB_WORKSPACE}" \
+                -B "${GITHUB_WORKSPACE}/build" \
+                -G Ninja \
+                -DCMAKE_BUILD_TYPE=${{ matrix.build_type }} \
+                -DCALF_TESTS=ON \
+                -DCALF_PYTHON_TESTS=OFF
+
+      - name: Build
+        run: cmake --build "${GITHUB_WORKSPACE}/build" --parallel
+
+      - name: Run C++ tests
+        working-directory: build
+        run: ctest --output-on-failure

capio_calf-0.1.0/.github/workflows/python-tests.yml

@@ -0,0 +1,47 @@
+name: Python Bindings Unit Tests
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+concurrency:
+  group: python-tests-${{ github.event.pull_request.number || github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  python-tests:
+    name: Python ${{ matrix.python_version }} on ${{ matrix.os }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-24.04, macos-15-intel, macos-26]
+        python_version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
+
+    steps:
+      - uses: actions/checkout@v7
+
+      - name: Set up Python ${{ matrix.python_version }}
+        uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python_version }}
+
+      - name: Install build tools on Ubuntu
+        if: startsWith(matrix.os, 'ubuntu-')
+        run: sudo apt-get update && sudo apt-get install -y cmake git ninja-build
+
+      - name: Set up Homebrew
+        if: startsWith(matrix.os, 'macos-')
+        uses: Homebrew/actions/setup-homebrew@main
+
+      - name: Install build tools on macOS
+        if: startsWith(matrix.os, 'macos-')
+        run: brew install cmake ninja
+
+      - name: Build and install capio-calf
+        run: python -m pip install ".[test]"
+
+      - name: Run Python binding tests
+        run: python -m pytest -v tests/python_bindings_tests.py

capio_calf-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,159 @@
+name: Release Python Wheels
+
+on:
+  workflow_run:
+    workflows: [Python Bindings Unit Tests]
+    branches: [main]
+    types: [completed]
+  workflow_dispatch:
+
+concurrency:
+  group: python-release
+  cancel-in-progress: false
+
+jobs:
+  release-version:
+    name: Read release version
+    if: github.event_name == 'workflow_dispatch' || github.event.workflow_run.conclusion == 'success'
+    runs-on: ubuntu-24.04
+    outputs:
+      version: ${{ steps.version.outputs.version }}
+      should_publish: ${{ steps.version.outputs.should_publish }}
+
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          fetch-depth: 0
+          ref: ${{ github.event.workflow_run.head_sha || github.sha }}
+
+      - name: Read CMake project version
+        id: version
+        shell: bash
+        run: |
+          version="$(sed -nE 's/^project\(CALF VERSION ([0-9]+\.[0-9]+\.[0-9]+).*/\1/p' CMakeLists.txt)"
+          if [[ ! "${version}" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
+            echo "Unable to read a semantic version from CMakeLists.txt" >&2
+            exit 1
+          fi
+
+          echo "version=${version}" >> "${GITHUB_OUTPUT}"
+          if git ls-remote --exit-code --tags origin "refs/tags/v${version}" >/dev/null 2>&1; then
+            echo "Git tag v${version} already exists"
+            echo "should_publish=false" >> "${GITHUB_OUTPUT}"
+          elif curl --fail --silent "https://pypi.org/pypi/capio-calf/${version}/json" >/dev/null; then
+            echo "capio-calf ${version} is already published on PyPI"
+            echo "should_publish=false" >> "${GITHUB_OUTPUT}"
+          else
+            echo "Preparing release v${version}"
+            echo "should_publish=true" >> "${GITHUB_OUTPUT}"
+          fi
+
+  wheels:
+    name: Wheels on ${{ matrix.os }}
+    needs: release-version
+    if: needs.release-version.outputs.should_publish == 'true'
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, ubuntu-24.04-arm, macos-15-intel, macos-latest]
+
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          ref: ${{ github.event.workflow_run.head_sha || github.sha }}
+
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.x"
+
+      - name: Install cibuildwheel
+        run: python -m pip install --upgrade cibuildwheel
+
+      - name: Build wheels
+        env:
+          CIBW_BUILD: "cp310-* cp311-* cp312-* cp313-* cp314-*"
+          CIBW_BUILD_VERBOSITY: 1
+          CIBW_MANYLINUX_X86_64_IMAGE: manylinux_2_28
+          CIBW_MANYLINUX_AARCH64_IMAGE: manylinux_2_28
+          CIBW_TEST_COMMAND: >-
+            python -c "import calf; assert calf.__version__ == '${{ needs.release-version.outputs.version }}'"
+          MACOSX_DEPLOYMENT_TARGET: "15.0"
+        run: python -m cibuildwheel --output-dir wheelhouse
+
+      - uses: actions/upload-artifact@v7
+        with:
+          name: wheels-${{ matrix.os }}
+          path: wheelhouse/*.whl
+          if-no-files-found: error
+
+  sdist:
+    name: Source distribution
+    needs: release-version
+    if: needs.release-version.outputs.should_publish == 'true'
+    runs-on: ubuntu-24.04
+
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          ref: ${{ github.event.workflow_run.head_sha || github.sha }}
+
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.x"
+
+      - name: Build source distribution
+        run: |
+          python -m pip install --upgrade build
+          python -m build --sdist
+
+      - uses: actions/upload-artifact@v7
+        with:
+          name: sdist
+          path: dist/*.tar.gz
+          if-no-files-found: error
+
+  publish:
+    name: Publish to PyPI
+    needs: [release-version, wheels, sdist]
+    runs-on: ubuntu-24.04
+    environment: pypi
+
+    steps:
+      - uses: actions/download-artifact@v8
+        with:
+          path: dist
+          merge-multiple: true
+
+      - name: Validate distributions
+        run: |
+          python -m pip install --upgrade twine
+          python -m twine check dist/*
+
+      - name: Upload distributions
+        env:
+          TWINE_USERNAME: __token__
+          TWINE_PASSWORD: ${{ secrets.PYPI_DEPLOY_KEY }}
+        run: python -m twine upload --verbose dist/*
+
+  github-release:
+    name: Create GitHub release
+    needs: [release-version, publish]
+    runs-on: ubuntu-24.04
+    permissions:
+      contents: write
+
+    steps:
+      - uses: actions/download-artifact@v8
+        with:
+          path: dist
+          merge-multiple: true
+
+      - name: Create release v${{ needs.release-version.outputs.version }}
+        uses: softprops/action-gh-release@v3
+        with:
+          tag_name: v${{ needs.release-version.outputs.version }}
+          name: v${{ needs.release-version.outputs.version }}
+          target_commitish: ${{ github.event.workflow_run.head_sha || github.sha }}
+          generate_release_notes: true
+          files: dist/*

capio_calf-0.1.0/.gitignore

@@ -0,0 +1,76 @@
+# Prerequisites
+*.d
+
+# Compiled Object files
+*.slo
+*.lo
+*.o
+*.obj
+
+# Precompiled Headers
+*.gch
+*.pch
+
+# Linker files
+*.ilk
+
+# Debugger Files
+*.pdb
+
+# Compiled Dynamic libraries
+*.so
+*.dylib
+*.dll
+*.so.*
+
+
+# Fortran module files
+*.mod
+*.smod
+
+# Compiled Static libraries
+*.lai
+*.la
+*.a
+*.lib
+
+# Executables
+*.exe
+*.out
+*.app
+
+# Build directories
+build/
+Build/
+build-*/
+
+# CMake generated files
+CMakeFiles/
+CMakeCache.txt
+cmake_install.cmake
+Makefile
+install_manifest.txt
+compile_commands.json
+
+# Temporary files
+*.tmp
+*.log
+*.bak
+*.swp
+
+# vcpkg
+vcpkg_installed/
+
+# debug information files
+*.dwo
+
+# test output & cache
+Testing/
+.cache/
+
+*build*
+.idea
+.junie
+.venv
+*.egg-info
+__pycache__

capio_calf-0.1.0/CMakeLists.txt

@@ -0,0 +1,158 @@
+cmake_minimum_required(VERSION 3.16)
+project(CALF VERSION 0.1.0 LANGUAGES CXX)
+
+# -------------------------------------------------------------------------
+#  Options & Defaults
+# -------------------------------------------------------------------------
+option(CALF_LOG "Enable CALF logging globally by default" ON)
+option(CALF_TESTS "Enable CALF unit tests" OFF)
+option(CALF_PYTHON_TESTS "Enable CALF Python binding tests" ${CALF_TESTS})
+option(CALF_BUILD_PYTHON_BINDINGS "Build Python bindings for CALF" OFF)
+
+set(CALF_DEFAULT_COMPONENT_NAME "calf" CACHE STRING "Fallback component name")
+set(CALF_DEFAULT_LOG_DIR_NAME "./calf_logs" CACHE STRING "Fallback default log dir name")
+
+# ---------------------------------------------------------------------------
+#  Helper functions (Now modifying targets directly)
+# ---------------------------------------------------------------------------
+
+function(calf_set_component target)
+    if (${ARGC} LESS 1 OR ${ARGC} GREATER 2)
+        message(FATAL_ERROR "calf_set_component invoked with incorrect number of arguments")
+    endif ()
+
+    set(val "${CALF_DEFAULT_COMPONENT_NAME}")
+    if(${ARGC} EQUAL 2)
+        set(val "${ARGV1}")
+    endif()
+
+    # Apply directly to the target scope
+    target_compile_definitions(${target} PRIVATE _CALF_COMPONENT_NAME="${val}")
+endfunction()
+
+function(calf_set_default_log_dir target)
+    if (${ARGC} LESS 1 OR ${ARGC} GREATER 2)
+        message(FATAL_ERROR "calf_set_default_log_dir invoked with incorrect number of arguments")
+    endif ()
+
+    set(val "${CALF_DEFAULT_LOG_DIR_NAME}")
+    if(${ARGC} EQUAL 2)
+        set(val "${ARGV1}")
+    endif()
+
+    # Apply directly to the target scope
+    target_compile_definitions(${target} PRIVATE _CALF_DEFAULT_LOG_DIR_NAME="${val}")
+endfunction()
+
+function(calf_enable_log target ENABLE)
+    if (ENABLE)
+        target_compile_definitions(${target} PRIVATE CALF_LOG)
+    endif ()
+    target_include_directories(${target} PRIVATE "${CMAKE_CURRENT_FUNCTION_LIST_DIR}")
+    message(STATUS "calf_enable_log(${target}) -> include dir: ${CMAKE_CURRENT_FUNCTION_LIST_DIR}")
+endfunction()
+
+
+# ---------------------------------------------------------------------------
+#  Tests
+# ---------------------------------------------------------------------------
+if(CALF_TESTS)
+    include(FetchContent)
+    FetchContent_Declare(
+            googletest
+            GIT_REPOSITORY https://github.com/google/googletest.git
+            GIT_TAG v1.17.0
+            GIT_SHALLOW TRUE
+    )
+    FetchContent_Declare(
+            nlohmann_json
+            GIT_REPOSITORY https://github.com/nlohmann/json.git
+            GIT_TAG v3.12.0
+            GIT_SHALLOW TRUE
+    )
+    FetchContent_MakeAvailable(googletest)
+    FetchContent_MakeAvailable(nlohmann_json)
+
+    enable_testing()
+    include(GoogleTest)
+
+    add_executable(calf_core_tests tests/core_tests.cpp)
+    calf_enable_log(calf_core_tests ON)
+    target_compile_features(calf_core_tests PRIVATE cxx_std_17)
+    target_link_libraries(calf_core_tests PRIVATE GTest::gtest_main nlohmann_json::nlohmann_json)
+    gtest_discover_tests(calf_core_tests)
+
+    add_executable(calf_stl_tests tests/stl_tests.cpp)
+    calf_enable_log(calf_stl_tests ON)
+    target_compile_features(calf_stl_tests PRIVATE cxx_std_17)
+    target_link_libraries(calf_stl_tests PRIVATE GTest::gtest_main nlohmann_json::nlohmann_json)
+    gtest_discover_tests(calf_stl_tests)
+
+    if(CMAKE_SYSTEM_NAME STREQUAL "Linux")
+        add_executable(calf_syscall_tests tests/syscall_tests.cpp)
+        calf_enable_log(calf_syscall_tests ON)
+        target_compile_definitions(calf_syscall_tests PRIVATE __CALF_POSIX)
+        target_compile_features(calf_syscall_tests PRIVATE cxx_std_17)
+        target_link_libraries(calf_syscall_tests PRIVATE GTest::gtest_main
+                                                                 nlohmann_json::nlohmann_json)
+        gtest_discover_tests(calf_syscall_tests)
+    endif()
+
+    add_executable(calf_disabled_tests tests/disabled_tests.cpp)
+    calf_enable_log(calf_disabled_tests OFF)
+    target_compile_features(calf_disabled_tests PRIVATE cxx_std_17)
+    target_link_libraries(calf_disabled_tests PRIVATE GTest::gtest_main)
+    gtest_discover_tests(calf_disabled_tests)
+endif ()
+
+# ---------------------------------------------------------------------------
+#  Python bindings
+# ---------------------------------------------------------------------------
+if(CALF_BUILD_PYTHON_BINDINGS OR CALF_PYTHON_TESTS)
+    include(FetchContent)
+    find_package(Python 3.10 COMPONENTS Interpreter Development.Module REQUIRED)
+
+    FetchContent_Declare(
+            pybind11
+            GIT_REPOSITORY https://github.com/pybind/pybind11.git
+            GIT_TAG v3.0.1
+    )
+    FetchContent_MakeAvailable(pybind11)
+
+    pybind11_add_module(_py_calf bindings/python_bindings.cpp)
+    target_include_directories(_py_calf PRIVATE "${CMAKE_CURRENT_SOURCE_DIR}")
+    target_compile_features(_py_calf PRIVATE cxx_std_17)
+    calf_set_component(_py_calf)
+    calf_set_default_log_dir(_py_calf)
+
+    if(CALF_BUILD_PYTHON_BINDINGS)
+        install(TARGETS _py_calf LIBRARY DESTINATION calf)
+    endif()
+
+    if(CALF_PYTHON_TESTS)
+        if(NOT CALF_TESTS)
+            enable_testing()
+        endif()
+
+        if(WIN32)
+            set(CALF_TEST_PYTHON ${CMAKE_CURRENT_BINARY_DIR}/calf-python-test-env/Scripts/python.exe)
+        else()
+            set(CALF_TEST_PYTHON ${CMAKE_CURRENT_BINARY_DIR}/calf-python-test-env/bin/python)
+        endif()
+
+        add_custom_target(
+                calf_python_tests
+                COMMAND ${Python_EXECUTABLE} -m venv
+                        ${CMAKE_CURRENT_BINARY_DIR}/calf-python-test-env
+                COMMAND ${CALF_TEST_PYTHON} -m pip install "${CMAKE_CURRENT_SOURCE_DIR}[test]"
+                COMMAND ${CALF_TEST_PYTHON} -m pytest -v
+                        ${CMAKE_CURRENT_SOURCE_DIR}/tests/python_bindings_tests.py
+                USES_TERMINAL
+        )
+        add_test(
+                NAME calf_python_bindings_tests
+                COMMAND ${CMAKE_COMMAND} --build ${CMAKE_CURRENT_BINARY_DIR}
+                        --target calf_python_tests
+        )
+    endif()
+endif ()

capio_calf-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 High-Performance-IO
+
+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.