libibt 0.0.1__tar.gz

libibt-0.0.1/.github/workflows/check.yml

@@ -0,0 +1,49 @@
+name: Check
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  check:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions-rust-lang/setup-rust-toolchain@v1
+        with:
+          toolchain: stable
+          components: rustfmt, clippy
+
+      - uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - name: Set up Python
+        run: uv python install 3.12
+
+      - name: Check Rust formatting
+        run: cargo fmt --check
+
+      - name: Clippy lints
+        run: cargo clippy --all-targets -- -W clippy::all
+
+      - name: Rust tests
+        run: cargo test
+
+      - name: Install Python dependencies
+        run: uv sync
+
+      - name: Check Python formatting
+        run: uv run black --check .
+
+      - name: Type check
+        run: uv run mypy src/
+
+      - name: Python tests
+        run: uv run pytest tests/ -v

libibt-0.0.1/.github/workflows/publish.yml

@@ -0,0 +1,188 @@
+name: Build and Publish
+
+on:
+  push:
+    branches: [ master, main ]
+  pull_request:
+    branches: [ master, main ]
+  release:
+    types: [published]
+  workflow_dispatch:
+    inputs:
+      publish_to_pypi:
+        description: 'Publish to PyPI'
+        required: true
+        default: 'false'
+        type: boolean
+
+jobs:
+  check:
+    name: Lint and test
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+
+    - uses: actions-rust-lang/setup-rust-toolchain@v1
+      with:
+        toolchain: stable
+        components: rustfmt, clippy
+
+    - uses: astral-sh/setup-uv@v5
+      with:
+        enable-cache: true
+
+    - name: Set up Python
+      run: uv python install 3.12
+
+    - name: Check Rust formatting
+      run: cargo fmt --check
+
+    - name: Clippy lints
+      run: cargo clippy --all-targets -- -W clippy::all
+
+    - name: Rust tests
+      run: cargo test
+
+    - name: Install Python dependencies
+      run: uv sync
+
+    - name: Check Python formatting
+      run: uv run black --check .
+
+    - name: Type check
+      run: uv run mypy src/
+
+  build-wheels:
+    name: Build wheel (${{ matrix.os }}, Python ${{ matrix.python-version }})
+    needs: check
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        # Note: windows-11-arm excluded until pyarrow publishes Windows ARM64 wheels
+        os: [ubuntu-latest, ubuntu-24.04-arm, macos-15-intel, macos-latest, windows-latest]
+        python-version: ['3.10', '3.11', '3.12', '3.13', '3.14']
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Install Rust toolchain
+      uses: dtolnay/rust-toolchain@stable
+
+    - name: Install uv
+      uses: astral-sh/setup-uv@v5
+
+    - name: Build wheel
+      run: uvx cibuildwheel==3.3.1 --output-dir wheelhouse
+      env:
+        CIBW_BUILD: "cp${{ matrix.python-version == '3.10' && '310' || matrix.python-version == '3.11' && '311' || matrix.python-version == '3.12' && '312' || matrix.python-version == '3.13' && '313' || '314' }}-*"
+        CIBW_BUILD_VERBOSITY: 1
+        CIBW_BEFORE_BUILD: "pip install numpy"
+        # Install Rust inside manylinux container (host toolchain not available)
+        CIBW_BEFORE_ALL_LINUX: "curl https://sh.rustup.rs -sSf | sh -s -- --default-toolchain stable -y"
+        CIBW_ENVIRONMENT_LINUX: 'PATH="$HOME/.cargo/bin:$PATH"'
+        # Build only native arch per runner (no cross-compilation or emulation)
+        CIBW_ARCHS_LINUX: "native"
+        CIBW_ARCHS_MACOS: "native"
+        CIBW_ARCHS_WINDOWS: "native"
+        CIBW_ENVIRONMENT_MACOS: 'MACOSX_DEPLOYMENT_TARGET=10.13'
+
+    - name: Upload wheel
+      uses: actions/upload-artifact@v4
+      with:
+        name: wheel-${{ matrix.os }}-${{ matrix.python-version }}
+        path: ./wheelhouse/*.whl
+
+  build-sdist:
+    name: Build source distribution
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Install uv
+      uses: astral-sh/setup-uv@v5
+
+    - name: Build sdist
+      run: uv build --sdist
+
+    - name: Upload sdist
+      uses: actions/upload-artifact@v4
+      with:
+        name: sdist
+        path: dist/*.tar.gz
+
+  test-wheels:
+    name: Test wheel (${{ matrix.os }}, Python ${{ matrix.python-version }})
+    runs-on: ${{ matrix.os }}
+    needs: build-wheels
+    strategy:
+      fail-fast: false
+      matrix:
+        # Note: windows-11-arm excluded until pyarrow publishes Windows ARM64 wheels
+        os: [ubuntu-latest, ubuntu-24.04-arm, macos-15-intel, macos-latest, windows-latest]
+        python-version: ['3.10', '3.11', '3.12', '3.13', '3.14']
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Install uv
+      uses: astral-sh/setup-uv@v5
+
+    - name: Download wheel artifact
+      uses: actions/download-artifact@v4
+      with:
+        name: wheel-${{ matrix.os }}-${{ matrix.python-version }}
+        path: dist/
+
+    - name: Create venv and install wheel (Unix)
+      if: runner.os != 'Windows'
+      run: |
+        uv venv .venv --python ${{ matrix.python-version }}
+        WHEEL=$(ls dist/*.whl | head -1)
+        uv pip install --python .venv "${WHEEL}[test]"
+
+    - name: Create venv and install wheel (Windows)
+      if: runner.os == 'Windows'
+      shell: pwsh
+      run: |
+        uv venv .venv --python ${{ matrix.python-version }}
+        $wheel = (Get-ChildItem dist/*.whl | Select-Object -First 1).FullName
+        uv pip install --python .venv "${wheel}[test]"
+
+    - name: Run tests
+      run: uv run --python .venv pytest tests/ -v --tb=short
+
+  publish:
+    name: Publish to PyPI
+    runs-on: ubuntu-latest
+    needs: [build-wheels, build-sdist, test-wheels]
+    if: github.event_name == 'release' || (github.event_name == 'workflow_dispatch' && inputs.publish_to_pypi == true)
+    environment:
+      name: pypi
+      url: https://pypi.org/p/libibt
+
+    permissions:
+      id-token: write
+      contents: write
+
+    steps:
+    - name: Download all artifacts
+      uses: actions/download-artifact@v4
+      with:
+        path: dist/
+        merge-multiple: true
+
+    - name: List artifacts
+      run: ls -la dist/
+
+    - name: Publish to PyPI
+      uses: pypa/gh-action-pypi-publish@release/v1
+      with:
+        packages-dir: dist/
+
+    - name: Upload assets to GitHub Release
+      if: github.event_name == 'release'
+      env:
+        GH_TOKEN: ${{ github.token }}
+      run: gh release upload "${{ github.event.release.tag_name }}" dist/* --repo "${{ github.repository }}"

libibt-0.0.1/.github/workflows/pyodide.yml

@@ -0,0 +1,85 @@
+name: Pyodide (WebAssembly) Tests
+
+on:
+  push:
+    branches: [ master, main ]
+  pull_request:
+    branches: [ master, main ]
+
+jobs:
+  pyodide-build:
+    runs-on: ubuntu-latest
+    name: Build wheel for Pyodide
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: "3.13"
+
+    - name: Install uv
+      uses: astral-sh/setup-uv@v4
+
+    - name: Install Rust nightly with wasm32-unknown-emscripten
+      uses: dtolnay/rust-toolchain@nightly
+      with:
+        targets: wasm32-unknown-emscripten
+        components: rust-src
+
+    - name: Install Emscripten SDK
+      uses: mymindstorm/setup-emsdk@v14
+      with:
+        version: "4.0.9"
+
+    - name: Install pyodide-build
+      run: |
+        uv pip install --system --prerelease=allow "wheel<0.44.0"
+        uv pip install --system --prerelease=allow pyodide-build==0.29.3
+
+    - name: Install Pyodide xbuildenv
+      run: pyodide xbuildenv install 0.29.3
+
+    - name: Build wheel for Pyodide
+      run: pyodide build --exports whole_archive
+      env:
+        RUSTUP_TOOLCHAIN: nightly
+        CARGO_BUILD_TARGET: wasm32-unknown-emscripten
+        RUSTFLAGS: "-Zemscripten-wasm-eh"
+        PYO3_CROSS_PYTHON_VERSION: "3.13"
+
+    - name: Upload wheel artifact
+      uses: actions/upload-artifact@v4
+      with:
+        name: pyodide-wheel
+        path: dist/*.whl
+        retention-days: 7
+
+  pyodide-test:
+    runs-on: ubuntu-latest
+    needs: pyodide-build
+    name: Test with Pyodide
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Install Node.js
+      uses: actions/setup-node@v4
+      with:
+        node-version: '20'
+
+    - name: Download wheel artifact
+      uses: actions/download-artifact@v4
+      with:
+        name: pyodide-wheel
+        path: dist/
+
+    - name: Install Pyodide
+      run: npm install pyodide@0.29.3
+
+    - name: Run unit tests in Pyodide
+      run: node scripts/run_pyodide_tests.mjs --dist-dir=./dist
+
+    - name: Run bytes input tests in Pyodide
+      run: node scripts/run_pyodide_tests_idbfs.mjs --dist-dir=./dist

libibt-0.0.1/.gitignore

@@ -0,0 +1,39 @@
+# Rust
+target/
+Cargo.lock
+
+# Python
+__pycache__/
+*.py[cod]
+*.so
+*.pyd
+*.egg-info/
+dist/
+build/
+.eggs/
+
+# Virtual environments
+.venv/
+venv/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Test data (IBT files are large)
+*.ibt
+!tests/test_data/*.ibt
+
+# Claude local settings
+.claude/settings.local.json
+
+# Pyodide
+.pyodide-xbuildenv-*/
+node_modules/
+package.json
+package-lock.json

libibt-0.0.1/.python-version

@@ -0,0 +1 @@
+3.12

libibt-0.0.1/CLAUDE.md

@@ -0,0 +1,61 @@
+# libibt — Agent Instructions
+
+## Project overview
+
+Python library for reading iRacing IBT telemetry files. Rust core parses the binary format, PyO3 bridges to Python, and a Python `LogFile` dataclass provides the user-facing API. Data is returned as PyArrow tables.
+
+## Source control
+
+**Use `sl` (Sapling) only. Never use `git`.**
+
+## Architecture
+
+```
+rust/src/
+  lib.rs          — PyO3 module + ibt() entry point
+  reader.rs       — IbtFile: mmap, header parsing, channel extraction
+  header.rs       — Binary header structs
+  var_header.rs   — Variable header parsing (name, type, offset)
+  channel.rs      — Arrow RecordBatch construction per channel
+  session_info.rs — Session YAML extraction
+  error.rs        — Error types
+
+src/libibt/
+  __init__.py     — Public API: ibt(), LogFile
+  base.py         — LogFile dataclass (channels, laps, metadata, filtering, resampling)
+  _libibt_rs.pyi  — Type stubs for the Rust extension
+
+tests/
+  test_parse.py     — Basic parsing tests
+  test_reference.py — Cross-validation against reference parser
+  test_channels.py  — Channel data tests
+  test_logfile.py   — LogFile method tests
+```
+
+## Build and test
+
+```bash
+uv sync                  # Install dependencies
+just build               # Build Rust extension (release)
+just build-debug         # Build Rust extension (debug, faster)
+just test                # uv run pytest tests/ -v
+just check               # All checks: lint, clippy, typecheck, test-rust, test
+just format              # Black + cargo fmt
+just typecheck           # mypy src/
+just clippy              # Rust lints
+```
+
+Always use `uv run` for Python commands, never bare `python` or `pytest`.
+
+## Key details
+
+- **Python >=3.10**, Rust 2021 edition
+- **Dependencies**: pyarrow, numpy (version-constrained by Python version)
+- **Build system**: maturin (configured in pyproject.toml)
+- **Formatter**: Black (line-length 100)
+- **Type checker**: mypy (strict optional, check untyped defs)
+- **Timecodes**: int64 milliseconds throughout
+- **Channels**: each is a 2-column PyArrow table (`timecodes` + value), with field metadata (units, desc, interpolate)
+- **Laps**: PyArrow table with columns `num`, `start_time`, `end_time` (all ms)
+- **Array variables** (count > 1) are not yet supported — only scalar variables become channels
+- **LogFile methods are immutable** — filtering/resampling returns new instances