disco-engine 0.0.1__tar.gz

disco_engine-0.0.1/.github/CLA/CCLA.md

@@ -0,0 +1,35 @@
+# Corporate Contributor License Agreement (CCLA)
+
+This Corporate Contributor License Agreement ("Agreement") is entered
+into between the contributing organization ("Corporation") and the
+project owner ("Project").
+
+## 1. Grant of Copyright License
+
+The Corporation hereby grants the Project a perpetual, worldwide,
+non-exclusive, no-charge, royalty-free, irrevocable copyright license
+to reproduce, prepare derivative works of, publicly display, publicly
+perform, sublicense, and distribute contributions made by its employees.
+
+## 2. Grant of Patent License
+
+The Corporation hereby grants the Project a perpetual, worldwide,
+non-exclusive, no-charge, royalty-free, irrevocable patent license
+covering patent claims necessarily infringed by the contributions.
+
+## 3. Authority
+
+The Corporation represents that it has the legal authority to grant
+these licenses and that contributions are made by authorized employees.
+
+## 4. No Warranty
+
+Contributions are provided on an "AS IS" basis.
+
+---
+
+Authorized Signature:
+Name:
+Title:
+Organization:
+Date:

disco_engine-0.0.1/.github/CLA/CONTRIBUTING.md

@@ -0,0 +1,18 @@
+# Contributing
+
+We welcome contributions from the community.
+
+## License and CLA
+
+This project is licensed under the Apache License 2.0.
+
+By submitting a pull request, you agree that:
+- Your contribution is your own work or you have the right to submit it
+- Your contribution will be licensed under Apache 2.0
+- You agree to the Contributor License Agreement (CLA)
+
+The CLA is a lightweight Apache-style CLA intended to protect both
+contributors and users of the project.
+
+If you are contributing on behalf of a company, a Corporate CLA may
+be required.

disco_engine-0.0.1/.github/CLA/ICLA.md

@@ -0,0 +1,37 @@
+# Individual Contributor License Agreement (ICLA)
+
+Thank you for your interest in contributing to this project.
+
+This Contributor License Agreement ("Agreement") is entered into between
+you ("Contributor") and the project owner ("Project").
+
+## 1. Grant of Copyright License
+
+You hereby grant to the Project a perpetual, worldwide, non-exclusive,
+no-charge, royalty-free, irrevocable copyright license to reproduce,
+prepare derivative works of, publicly display, publicly perform,
+sublicense, and distribute your contributions and such derivative works.
+
+## 2. Grant of Patent License
+
+You hereby grant to the Project a perpetual, worldwide, non-exclusive,
+no-charge, royalty-free, irrevocable patent license to make, have made,
+use, offer to sell, sell, import, and otherwise transfer your
+contributions, where such license applies only to those patent claims
+necessarily infringed by your contribution.
+
+## 3. Authority
+
+You represent that you are legally entitled to grant the above licenses.
+If your employer has rights to intellectual property that you create,
+you represent that you have received permission to make contributions
+on behalf of that employer.
+
+## 4. No Warranty
+
+You provide your contributions on an "AS IS" basis, without warranties
+or conditions of any kind.
+
+---
+
+By submitting a contribution, you agree to the terms of this Agreement.

disco_engine-0.0.1/.github/workflows/build-windows.yml

@@ -0,0 +1,42 @@
+name: Build Windows
+
+on:
+  workflow_dispatch:
+
+jobs:
+  build-wheels:
+    name: Build wheels (${{ matrix.os }})
+    runs-on: ${{ matrix.os }}
+    timeout-minutes: 90
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [windows-latest]
+
+    steps:
+      - name: Check out release tag
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          ref: ${{ inputs.tag_name }}
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Set up MSVC dev tools (Windows)
+        if: runner.os == 'Windows'
+        uses: ilammy/msvc-dev-cmd@v1
+
+      - name: Build wheels
+        timeout-minutes: 75
+        run: |
+          python -m pip install -U pip cibuildwheel
+          python -m cibuildwheel --output-dir wheelhouse
+
+      - name: Upload wheels
+        uses: actions/upload-artifact@v4
+        with:
+          name: wheels-${{ matrix.os }}
+          path: wheelhouse/*.whl
+

disco_engine-0.0.1/.github/workflows/build.yml

@@ -0,0 +1,68 @@
+name: Build
+
+on:
+  pull_request:
+    branches: [ main ]
+  workflow_dispatch:
+
+jobs:
+  build-wheels:
+    name: Build wheels (${{ matrix.os }})
+    runs-on: ${{ matrix.os }}
+    timeout-minutes: 90
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-22.04, macos-14, windows-latest]
+
+    steps:
+      - name: Check out release tag
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          ref: ${{ inputs.tag_name }}
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Set up MSVC dev tools (Windows)
+        if: runner.os == 'Windows'
+        uses: ilammy/msvc-dev-cmd@v1
+
+      - name: Build wheels
+        timeout-minutes: 75
+        run: |
+          python -m pip install -U pip cibuildwheel
+          python -m cibuildwheel --output-dir wheelhouse
+
+      - name: Upload wheels
+        uses: actions/upload-artifact@v4
+        with:
+          name: wheels-${{ matrix.os }}
+          path: wheelhouse/*.whl
+
+  build-sdist:
+    name: Build sdist
+    runs-on: ubuntu-22.04
+    steps:
+      - name: Check out release tag
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          ref: ${{ inputs.tag_name }}
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Build sdist
+        run: |
+          python -m pip install -U build
+          python -m build --sdist
+
+      - name: Upload sdist
+        uses: actions/upload-artifact@v4
+        with:
+          name: sdist
+          path: dist/*.tar.gz

disco_engine-0.0.1/.github/workflows/release-publish.yml

@@ -0,0 +1,95 @@
+name: Build & Publish (on Release)
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+jobs:
+  build-wheels:
+    name: Build wheels (${{ matrix.os }})
+    runs-on: ${{ matrix.os }}
+    timeout-minutes: 90
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-22.04, macos-14, windows-latest]
+
+    steps:
+      - name: Check out release tag
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          ref: ${{ github.event.release.tag_name }}
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Set up MSVC dev tools (Windows)
+        if: runner.os == 'Windows'
+        uses: ilammy/msvc-dev-cmd@v1
+
+      - name: Build wheels
+        timeout-minutes: 75
+        run: |
+          python -m pip install -U pip cibuildwheel
+          python -m cibuildwheel --output-dir wheelhouse
+
+      - name: Upload wheels
+        uses: actions/upload-artifact@v4
+        with:
+          name: wheels-${{ matrix.os }}
+          path: wheelhouse/*.whl
+
+  build-sdist:
+    name: Build sdist
+    runs-on: ubuntu-22.04
+    steps:
+      - name: Check out release tag
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          ref: ${{ github.event.release.tag_name }}
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Build sdist
+        run: |
+          python -m pip install -U build
+          python -m build --sdist
+
+      - name: Upload sdist
+        uses: actions/upload-artifact@v4
+        with:
+          name: sdist
+          path: dist/*.tar.gz
+
+  publish:
+    name: Publish to PyPI
+    needs: [build-wheels, build-sdist]
+    runs-on: ubuntu-22.04
+    permissions:
+      id-token: write
+      contents: read
+
+    steps:
+      - name: Download wheels
+        uses: actions/download-artifact@v4
+        with:
+          pattern: wheels-*
+          merge-multiple: true
+          path: dist
+
+      - name: Download sdist
+        uses: actions/download-artifact@v4
+        with:
+          name: sdist
+          path: dist
+
+      - name: Upload to PyPI (Trusted Publisher)
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          skip-existing: true

disco_engine-0.0.1/.github/workflows/test.yml

@@ -0,0 +1,54 @@
+name: Tests
+
+on:
+  push:
+  pull_request:
+  workflow_dispatch:
+
+jobs:
+  test:
+    runs-on: ubuntu-22.04
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+
+    env:
+      # Speed up installs and ensure NumPy comes from wheels
+      PIP_ONLY_BINARY: "numpy"
+      # Faster CMake builds
+      CMAKE_GENERATOR: "Ninja"
+      CMAKE_BUILD_PARALLEL_LEVEL: "4"
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0  # setuptools-scm needs tags for dynamic version
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Cache pip
+        uses: actions/cache@v4
+        with:
+          path: ~/.cache/pip
+          key: pip-${{ runner.os }}-${{ matrix.python-version }}-${{ hashFiles('pyproject.toml') }}
+          restore-keys: |
+            pip-${{ runner.os }}-${{ matrix.python-version }}-
+            pip-${{ runner.os }}-
+
+      - name: Upgrade pip & install build tooling
+        run: |
+          python -m pip install -U pip
+          pip install -U wheel ninja
+
+      - name: Install package (editable) with dev extras
+        run: |
+          pip install -e '.[dev]'
+
+      - name: Run tests
+        run: pytest -q
+
+      - name: Type check
+        run: mypy src/disco

disco_engine-0.0.1/.gitignore

@@ -0,0 +1,228 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[codz]
+*$py.class
+
+# C extensions
+*.so
+*.pyd
+*.dll
+*.dylib
+
+# Native build artifacts
+*.o
+*.obj
+*.a
+*.lib
+*.exp
+*.pdb
+*.pch
+*.lo
+*.la
+*.mod
+*.asm
+*.s
+
+# macOS / Xcode debug symbols
+*.dSYM/
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+wheelhouse/
+
+# scikit-build / CMake (classic & core)
+_skbuild/
+CMakeCache.txt
+CMakeFiles/
+cmake-build-*/
+CMakeUserPresets.json
+CMakeScripts/
+Makefile
+cmake_install.cmake
+install_manifest.txt
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py.cover
+.hypothesis/
+.pytest_cache/
+cover/
+# C/C++ coverage
+*.gcda
+*.gcno
+*.gcov
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+# .python-version
+
+# pipenv
+#Pipfile.lock
+
+# UV
+#uv.lock
+
+# poetry
+#poetry.lock
+#poetry.toml
+
+# pdm
+#pdm.lock
+#pdm.toml
+.pdm-python
+.pdm-build/
+
+# pixi
+#pixi.lock
+.pixi
+
+# PEP 582
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.envrc
+.venv
+.venv-*
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm / JetBrains (keep project-specific files if you prefer)
+# See: https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+.idea/
+
+# Abstra
+.abstra/
+
+# Visual Studio Code
+# .vscode/
+
+# Ruff
+.ruff_cache/
+
+# PyPI configuration
+.pypirc
+
+# Cursor
+.cursorignore
+.cursorindexingignore
+
+# Marimo
+marimo/_static/
+marimo/_lsp/
+__marimo__/
+
+# OS cruft
+.DS_Store
+Thumbs.db
+Icon?
+
+# setuptools-scm generated version file
+src/disco/_version.py
+
+# tmp segments generated in tests
+tmp_segments/
+
+# local scripts not to include
+scripts/
+
+# local development environment
+/docker-compose.yaml
+/local_tests

disco_engine-0.0.1/CMakeLists.txt

@@ -0,0 +1,55 @@
+# CMakeLists.txt
+cmake_minimum_required(VERSION 3.18)
+project(disco LANGUAGES CXX C)
+set(CMAKE_CXX_STANDARD 17)
+set(CMAKE_CXX_STANDARD_REQUIRED ON)
+set(CMAKE_POSITION_INDEPENDENT_CODE ON)
+
+# ── macOS minimum deployment target ───────────────────────────────────────────
+# std::variant (used in Headers) requires macOS 10.14+; 10.15 is a safe baseline.
+if(APPLE AND NOT CMAKE_OSX_DEPLOYMENT_TARGET)
+    set(CMAKE_OSX_DEPLOYMENT_TARGET "10.15" CACHE STRING "Minimum macOS deployment version")
+endif()
+
+# ── Shared toolchain setup ────────────────────────────────────────────────────
+find_package(Python REQUIRED COMPONENTS Interpreter Development.Module)
+
+execute_process(
+    COMMAND "${Python_EXECUTABLE}" -c "import numpy; print(numpy.get_include())"
+    OUTPUT_VARIABLE NUMPY_INCLUDE_DIR
+    OUTPUT_STRIP_TRAILING_WHITESPACE
+    RESULT_VARIABLE _numpy_missing
+)
+if(_numpy_missing)
+    message(FATAL_ERROR "NumPy not found — add numpy to build-system.requires")
+endif()
+message(STATUS "NumPy include dir: ${NUMPY_INCLUDE_DIR}")
+
+find_package(pybind11 CONFIG QUIET)
+if(NOT pybind11_FOUND)
+    include(FetchContent)
+    # Use a URL tarball instead of GIT_REPOSITORY so that CMAKE_DOWNLOAD_TIMEOUT
+    # (set in pyproject.toml) applies and git is not required at build time.
+    FetchContent_Declare(pybind11
+        URL https://github.com/pybind/pybind11/archive/refs/tags/v2.12.0.tar.gz
+        URL_HASH SHA256=bf8f242abd1abcd375d516a7067490fb71abd79519a282d22b6e4d19282185a7
+        DOWNLOAD_EXTRACT_TIMESTAMP TRUE
+    )
+    FetchContent_MakeAvailable(pybind11)
+endif()
+
+find_program(CYTHON_EXECUTABLE NAMES cython cython3 REQUIRED)
+
+find_package(OpenMP COMPONENTS C)
+if(OpenMP_C_FOUND)
+    message(STATUS "OpenMP found — Cython prange targets will be parallel")
+else()
+    message(WARNING "OpenMP not found — Cython targets will be single-threaded")
+endif()
+
+# ── Shared macros ─────────────────────────────────────────────────────────────
+include(cmake/extension_helpers.cmake)
+
+# ── Subpackages ───────────────────────────────────────────────────────────────
+add_subdirectory(src/disco/event_queue)
+# add_subdirectory(src/toolbox/future_package)   ← one line to add a new one