rclib 0.0.4__tar.gz

rclib-0.0.4/.clang-format

@@ -0,0 +1,13 @@
+---
+# from: https://github.com/pybind/pybind11/blob/master/.clang-format.yaml
+# See all possible options and defaults with:
+# clang-format --style=llvm --dump-config
+BasedOnStyle: LLVM
+ColumnLimit: 120
+CommentPragmas: 'NOLINT:.*|^ IWYU pragma:'
+IncludeBlocks: Regroup
+IndentCaseLabels: true
+IndentPPDirectives: AfterHash
+Standard: c++17
+StatementMacros: ['PyObject_HEAD']
+...

rclib-0.0.4/.cmake-format.yaml

@@ -0,0 +1,3 @@
+format:
+  line_width: 120
+  tab_size: 2

rclib-0.0.4/.geminiignore

@@ -0,0 +1 @@
+/cpp_core/third_party/

rclib-0.0.4/.github/workflows/ci.yml

@@ -0,0 +1,96 @@
+name: CI
+
+on:
+  push:
+    branches: ["main", "develop"]
+  pull_request:
+    branches: ["main", "develop"]
+  workflow_dispatch:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  tests-python:
+    name: Python Tests
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          submodules: recursive
+
+      - name: Install system dependencies
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y libomp-dev
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          version: "latest"
+
+      - name: Set up Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
+
+      - name: Run Tests
+        run: uv run nox -s tests-${{ matrix.python-version }}
+
+  tests-cpp:
+    name: C++ Tests
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          submodules: recursive
+
+      - name: Install system dependencies
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y libomp-dev
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          version: "latest"
+
+      - name: Set up Python
+        run: uv python install 3.12
+
+      - name: Run C++ Tests
+        run: uv run nox -s tests_cpp
+
+  lint-type-check:
+    name: Lint & Type Check
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          submodules: recursive
+
+      - name: Install system dependencies
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y libomp-dev
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          version: "latest"
+
+      - name: Set up Python
+        run: uv python install 3.12
+
+      - name: Run Lint
+        run: uv run nox -s lint
+
+      - name: Run Type Check
+        run: uv run nox -s type_check

rclib-0.0.4/.github/workflows/create-release-draft.yml

@@ -0,0 +1,28 @@
+name: Create Release Draft
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: write
+
+jobs:
+  create-draft:
+    name: Create Release Draft
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          submodules: recursive
+
+      - name: Create Release Draft
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          gh release create ${{ github.ref_name }} \
+            --draft \
+            --generate-notes \
+            --title "${{ github.ref_name }}"

rclib-0.0.4/.github/workflows/docs.yml

@@ -0,0 +1,47 @@
+name: Deploy Docs
+
+on:
+  push:
+    branches:
+      - main
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: write
+  pages: write
+  id-token: write
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          submodules: recursive
+
+      - name: Install system dependencies
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y libomp-dev
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          version: "latest"
+
+      - name: Set up Python
+        run: uv python install 3.12
+
+      - name: Build documentation
+        run: uv run nox -s docs
+
+      - name: Deploy documentation
+        run: |
+          uv run nox -s docs
+          uv run mkdocs gh-deploy --force --clean --verbose
+        env:
+          GH_TOKEN: ${{ github.token }}

rclib-0.0.4/.github/workflows/release.yml

@@ -0,0 +1,67 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+jobs:
+  build_wheels:
+    name: Build wheels on ${{ matrix.os }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest]
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          submodules: recursive
+
+      - name: Build wheels
+        uses: pypa/cibuildwheel@v3.3.0
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: cibw-wheels-${{ matrix.os }}-${{ strategy.job-index }}
+          path: ./wheelhouse/*.whl
+
+  build_sdist:
+    name: Build source distribution
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          submodules: recursive
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+
+      - name: Build sdist
+        run: |
+          uv run --with scikit-build-core --with pybind11 uv build --sdist --no-build-isolation
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: cibw-sdist
+          path: dist/*.tar.gz
+
+  publish:
+    name: Publish to PyPI
+    needs: [build_wheels, build_sdist]
+    runs-on: ubuntu-latest
+    permissions:
+      # IMPORTANT: this permission is mandatory for Trusted Publishing
+      id-token: write
+    steps:
+      - name: Download all the dists
+        uses: actions/download-artifact@v4
+        with:
+          pattern: cibw-*
+          path: dist
+          merge-multiple: true
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

rclib-0.0.4/.gitignore

@@ -0,0 +1,115 @@
+# Build artifacts
+build/
+_build/
+build_serial/
+build_user_omp/
+build_eigen_omp/
+build_scikit/
+build_nox/
+
+# Python
+.venv/
+env/
+venv/
+__pycache__/
+*.pyc
+*.egg-info/
+dist/
+.eggs/
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+wheelhouse/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# mkdocs documentation
+/site
+
+# uv
+uv.lock
+
+# ruff
+.ruff_cache/
+
+# LSP config files
+pyrightconfig.json
+
+# CMake
+CMakeCache.txt
+CMakeFiles/
+Makefile
+cmake_install.cmake
+install_manifest.txt
+CTestTestfile.cmake
+
+# C++
+*.o
+*.so
+*.a
+*.lo
+*.la
+*.dll
+
+# Logs
+*.log
+
+# Temporary files
+*.tmp
+*~
+*.png
+!/docs/assets/*.png
+*.csv
+
+# IDEs
+.vscode/
+.idea/
+
+# Caches
+.cache/
+
+# Build artifacts
+.skbuild-info.json
+.cmake/
+CMakeInit.txt
+
+# LaTeX build artifacts in docs/
+/docs/*.aux
+/docs/*.log
+/docs/*.tex
+/docs/*.fls
+/docs/*.fdb_latexmk
+/docs/*.synctex.gz
+/docs/*.toc
+/docs/*.out
+/docs/listings_setup.tex

rclib-0.0.4/.gitmodules

@@ -0,0 +1,9 @@
+[submodule "cpp_core/third_party/eigen"]
+	path = cpp_core/third_party/eigen
+	url = https://gitlab.com/libeigen/eigen.git
+[submodule "cpp_core/third_party/catch2"]
+	path = cpp_core/third_party/catch2
+	url = https://github.com/catchorg/Catch2.git
+[submodule "cpp_core/third_party/pybind11"]
+	path = cpp_core/third_party/pybind11
+	url = https://github.com/pybind/pybind11.git

rclib-0.0.4/.pre-commit-config.yaml

@@ -0,0 +1,85 @@
+# To use:
+#
+#     pre-commit run -a
+#
+# Or:
+#
+#     pre-commit install  # (runs every time you commit in git)
+#
+# To update this file:
+#
+#     pre-commit autoupdate
+#
+# See https://github.com/pre-commit/pre-commit
+
+ci:
+  autoupdate_commit_msg: "chore: update pre-commit hooks"
+  autofix_commit_msg: "style: pre-commit fixes"
+
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v6.0.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+        args: [--unsafe]
+      - id: check-toml
+      - id: check-added-large-files
+      - id: check-merge-conflict
+      - id: check-executables-have-shebangs
+      - id: check-illegal-windows-names
+      - id: check-symlinks
+      - id: debug-statements
+
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.14.10 # Ensure this matches or is newer than pyproject.toml
+    hooks:
+      # Run the linter and apply fixes
+      - id: ruff-check
+        args: [--fix, --exit-non-zero-on-fix, --config=pyproject.toml]
+      # Run the formatter
+      - id: ruff-format
+        exclude: ^(docs)
+        files: \.py$
+
+  # Changes tabs to spaces
+  - repo: https://github.com/Lucas-C/pre-commit-hooks
+    rev: v1.5.5
+    hooks:
+      - id: remove-tabs
+        exclude: ^(docs|.gitmodules|[Mm]akefile)
+
+  # Shell script linting
+  - repo: https://github.com/shellcheck-py/shellcheck-py
+    rev: v0.11.0.1
+    hooks:
+      - id: shellcheck
+
+  # CMake formatting
+  - repo: https://github.com/cheshirekow/cmake-format-precommit
+    rev: v0.6.13
+    hooks:
+      - id: cmake-format
+        additional_dependencies: [pyyaml>=5.1]
+        types: [file]
+        files: (\.cmake|CMakeLists.txt)(.in)?$
+      - id: cmake-lint
+        additional_dependencies: [pyyaml>=5.1]
+
+  # C++ formatting
+  - repo: https://github.com/pre-commit/mirrors-clang-format
+    rev: v21.1.8
+    hooks:
+      - id: clang-format
+        types_or: [c++, c, cuda]
+        exclude: ^cpp_core/third_party/
+
+  - repo: local
+    hooks:
+      - id: basedpyright
+        name: basedpyright
+        entry: uv run basedpyright
+        language: system
+        types: [python]
+        pass_filenames: false # Pyright needs full project context, not just changed files

rclib-0.0.4/CMakeLists.txt

@@ -0,0 +1,34 @@
+cmake_minimum_required(VERSION 3.15)
+project(rclib LANGUAGES CXX)
+
+set(CMAKE_EXPORT_COMPILE_COMMANDS ON)
+
+if(NOT CMAKE_BUILD_TYPE)
+  set(CMAKE_BUILD_TYPE
+      Release
+      CACHE STRING "Choose the type of build." FORCE)
+endif()
+
+enable_testing()
+
+# Add subdirectories for third-party dependencies
+add_subdirectory(cpp_core/third_party/catch2)
+set(PYBIND11_FINDPYTHON NEW)
+add_subdirectory(cpp_core/third_party/pybind11)
+add_subdirectory(cpp_core/third_party/eigen)
+
+# Add the C++ core subdirectory
+add_subdirectory(cpp_core)
+
+# Add the Python binding subdirectory
+add_subdirectory(python)
+
+# Add the C++ tests subdirectory
+if(BUILD_TESTING)
+  add_subdirectory(tests/cpp)
+endif()
+
+option(BUILD_EXAMPLES "Build examples" OFF)
+if(BUILD_EXAMPLES)
+  add_subdirectory(examples/cpp)
+endif()