Add PyPI packaging: scikit-build-core, cibuildwheel CI, MIT license

- pyproject.toml: scikit-build-core backend, teide v0.1.0 metadata
- CMakeLists.txt: TEIDE_PORTABLE option (-mtune=generic), install() target
- __init__.py: __version__, wheel-first lib discovery, re-export high-level API
- wheels.yml: cibuildwheel for manylinux + macOS, PyPI publish on v* tags
- LICENSE, README.md, MANIFEST.in

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: singaraiona

.github/workflows/wheels.yml

@@ -0,0 +1,72 @@
+name: Build wheels
+
+on:
+  push:
+    tags:
+      - "v*"
+  workflow_dispatch:
+
+jobs:
+  build_wheels:
+    name: Build ${{ matrix.os }} ${{ matrix.arch }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: ubuntu-latest
+            arch: x86_64
+          - os: ubuntu-latest
+            arch: aarch64
+          - os: macos-13
+            arch: x86_64
+          - os: macos-14
+            arch: arm64
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up QEMU (aarch64)
+        if: matrix.arch == 'aarch64'
+        uses: docker/setup-qemu-action@v3
+        with:
+          platforms: arm64
+
+      - name: Build wheels
+        uses: pypa/cibuildwheel@v2.21
+        env:
+          CIBW_ARCHS: ${{ matrix.arch }}
+          CIBW_SKIP: "pp* *-musllinux_*"
+          CIBW_TEST_COMMAND: >
+            python -c "from teide import Context; print('OK')"
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: wheels-${{ matrix.os }}-${{ matrix.arch }}
+          path: wheelhouse/*.whl
+
+  build_sdist:
+    name: Build sdist
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Build sdist
+        run: pipx run build --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-latest
+    if: startsWith(github.ref, 'refs/tags/v')
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          path: dist
+          merge-multiple: true
+      - uses: pypa/gh-action-pypi-publish@release/v1

CMakeLists.txt

@@ -5,6 +5,8 @@ set(CMAKE_C_STANDARD 17)
 set(CMAKE_C_STANDARD_REQUIRED ON)
 set(CMAKE_C_EXTENSIONS OFF)
 
+option(TEIDE_PORTABLE "Build portable binary (no -march=native)" OFF)
+
 # Collect all source files under src/
 file(GLOB_RECURSE TEIDE_SOURCES "src/**/*.c")
 
@@ -25,7 +27,11 @@ if(MSVC)
 else()
     set(TEIDE_WARNINGS -Wall -Wextra -Wpedantic -Werror)
     set(TEIDE_DEBUG_FLAGS -O0 -g -fsanitize=address,undefined)
-    set(TEIDE_RELEASE_FLAGS -O3 -march=native -DNDEBUG)
+    if(TEIDE_PORTABLE)
+        set(TEIDE_RELEASE_FLAGS -O3 -mtune=generic -DNDEBUG)
+    else()
+        set(TEIDE_RELEASE_FLAGS -O3 -march=native -DNDEBUG)
+    endif()
 endif()
 
 # Apply flags to both library targets
@@ -71,3 +77,6 @@ if(TEST_SOURCES)
     endif()
     add_test(NAME test_teide COMMAND test_teide)
 endif()
+
+# Install target for scikit-build wheel packaging
+install(TARGETS teide LIBRARY DESTINATION teide)

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Teide Contributors
+
+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.

MANIFEST.in

@@ -0,0 +1,10 @@
+include CMakeLists.txt
+include LICENSE
+include README.md
+recursive-include src *.c *.h
+recursive-include include *.h
+recursive-include bindings/python/teide *.py
+prune build
+prune build_release
+prune build_debug_noasan
+prune build_tsan

README.md

@@ -0,0 +1,43 @@
+# Teide
+
+Fast columnar dataframe library for Python, powered by a zero-dependency C17 engine with lazy fusion execution.
+
+## Install
+
+```bash
+pip install teide
+```
+
+> **Note:** v0.1.0 supports Linux and macOS only. Windows support is planned.
+
+## Quick Start
+
+```python
+from teide import Context, col
+
+with Context() as ctx:
+    df = ctx.read_csv("data.csv")
+
+    result = (
+        df.filter(col("price") > 0)
+          .group_by("category")
+          .agg(col("price").sum(), col("price").mean())
+          .sort("price_sum", descending=True)
+          .collect()
+    )
+
+    print(result)
+```
+
+## Features
+
+- **Lazy evaluation** with automatic query optimization (predicate pushdown, CSE, operator fusion)
+- **Morsel-driven parallel execution** across all cores
+- **Zero-copy** NumPy interop for numeric columns
+- **Fast CSV reader** — parallel parsing, mmap I/O
+- **Columnar storage** — splayed tables, date-partitioned datasets
+- **Pure C17 engine** — no external dependencies, minimal memory overhead
+
+## License
+
+MIT

bindings/python/teide/__init__.py

@@ -1,15 +1,17 @@
 """
-Teide — Low-level ctypes wrapper for libteide.
+Teide — Fast columnar dataframe library for Python.
 
 Usage:
-    from teide import TeideLib
-    lib = TeideLib()  # loads libteide.so
-    lib.sym_init()
-    # ... use the C API ...
-    lib.sym_destroy()
-    lib.arena_destroy_all()
+    from teide import Context, col, lit
+
+    with Context() as ctx:
+        df = ctx.read_csv("data.csv")
+        result = df.group_by("id1").agg(col("v1").sum()).collect()
+        print(result)
 """
 
+__version__ = "0.1.0"
+
 import ctypes
 import os
 import sys
@@ -21,24 +23,42 @@
 
 
 def _find_lib():
-    """Find libteide.so, checking TEIDE_LIB env var first."""
+    """Find libteide shared library.
+
+    Search order:
+    1. Same directory as this __init__.py (wheel-bundled layout)
+    2. TEIDE_LIB environment variable
+    3. Common build directories relative to source tree
+    """
+    _pkg_dir = os.path.dirname(__file__)
+    _lib_names = ["libteide.so", "libteide.dylib"]
+
+    # 1. Wheel-bundled: libteide.so sits next to __init__.py
+    for name in _lib_names:
+        path = os.path.join(_pkg_dir, name)
+        if os.path.exists(path):
+            return os.path.abspath(path)
+
+    # 2. Explicit env var
     env_path = os.environ.get("TEIDE_LIB")
     if env_path and os.path.exists(env_path):
         return env_path
 
-    # Search common locations
+    # 3. Source-tree build directories
     search_dirs = [
-        os.path.join(os.path.dirname(__file__), "..", "..", "..", "build_release"),
-        os.path.join(os.path.dirname(__file__), "..", "..", "..", "build"),
+        os.path.join(_pkg_dir, "..", "..", "..", "build_release"),
+        os.path.join(_pkg_dir, "..", "..", "..", "build"),
         ".",
     ]
     for d in search_dirs:
-        for name in ["libteide.so", "libteide.dylib"]:
+        for name in _lib_names:
             path = os.path.join(d, name)
             if os.path.exists(path):
                 return os.path.abspath(path)
 
-    raise OSError("Cannot find libteide.so. Set TEIDE_LIB environment variable.")
+    raise OSError(
+        "Cannot find libteide.so. Install via 'pip install teide' or set TEIDE_LIB."
+    )
 
 
 class TeideLib:
@@ -422,3 +442,6 @@ def part_load(self, db_root, table_name):
 OP_AVG = 55
 OP_FIRST = 56
 OP_LAST = 57
+
+# Re-export high-level API so users can do: from teide import Context, col, lit
+from teide.api import Context, col, lit, Expr, Table, Series, Query  # noqa: E402,F401

pyproject.toml

@@ -0,0 +1,38 @@
+[build-system]
+requires = ["scikit-build-core>=0.5"]
+build-backend = "scikit_build_core.build"
+
+[project]
+name = "teide"
+version = "0.1.0"
+description = "Fast columnar dataframe library for Python, powered by a zero-dependency C17 engine"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.8"
+authors = [{ name = "Teide Contributors" }]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Intended Audience :: Science/Research",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: POSIX :: Linux",
+    "Operating System :: MacOS",
+    "Programming Language :: C",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Scientific/Engineering",
+]
+
+[project.urls]
+Homepage = "https://github.com/teide-project/teide"
+Issues = "https://github.com/teide-project/teide/issues"
+
+[tool.scikit-build]
+wheel.packages = ["bindings/python/teide"]
+cmake.build-type = "Release"
+cmake.args = ["-DTEIDE_PORTABLE=ON"]