timefence 0.9.0__tar.gz

timefence-0.9.0/.github/workflows/ci.yml

@@ -0,0 +1,29 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, macos-latest]
+        python-version: ["3.9", "3.10", "3.11", "3.12"]
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+      - name: Set up Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
+      - name: Install dependencies
+        run: uv sync --extra dev
+      - name: Lint with ruff
+        run: uv run ruff check src/ tests/
+      - name: Format check with ruff
+        run: uv run ruff format --check src/ tests/
+      - name: Run tests
+        run: uv run pytest tests/ -v --tb=short

timefence-0.9.0/.github/workflows/release.yml

@@ -0,0 +1,63 @@
+name: Release to PyPI
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+
+      - name: Set up Python
+        run: uv python install 3.12
+
+      - name: Build package
+        run: uv build
+
+      - name: Upload build artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+
+      - name: Set up Python
+        run: uv python install 3.12
+
+      - name: Install dependencies
+        run: uv sync --extra dev
+
+      - name: Run tests
+        run: uv run pytest tests/ -v --tb=short
+
+  publish:
+    needs: [build, test]
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - name: Download build artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

timefence-0.9.0/.gitignore

@@ -0,0 +1,19 @@
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+.eggs/
+*.egg
+.venv/
+venv/
+.pytest_cache/
+.ruff_cache/
+.hypothesis/
+htmlcov/
+.coverage
+*.parquet
+.timefence/
+uv.lock
+.claude

timefence-0.9.0/CHANGELOG.md

@@ -0,0 +1,47 @@
+# Changelog
+
+## 0.9.0 — 2026-02-06
+
+Initial public release.
+
+### Core
+
+- **Point-in-time correct joins** with strict `feature_time < label_time - embargo` invariant
+- **ASOF JOIN fast path** (embargo=0) and ROW_NUMBER fallback (embargo>0) strategy selection
+- Data model: `Source`, `CSVSource`, `SQLSource`, `Feature`, `FeatureSet`, `Labels`
+- Three feature modes: column selection, SQL, and Python transform
+- Configurable `max_lookback`, `max_staleness`, `embargo`, `on_missing`, and `join` mode
+- Time-based train/valid/test splits
+- Key mapping for cross-source key name mismatches
+- Duplicate row handling (`on_duplicate`: `error` or `keep_any`)
+
+### Commands
+
+- `timefence build` — Build point-in-time correct training sets
+- `timefence audit` — Detect temporal leakage in any dataset (rebuild-and-compare or lightweight temporal check)
+- `timefence explain` — Preview join logic and SQL without executing
+- `timefence diff` — Compare two training datasets with configurable numeric tolerances
+- `timefence inspect` — Suggest keys and timestamps for a data file
+- `timefence catalog` — List all features defined in a project
+- `timefence quickstart` — Generate a self-contained example project with planted leakage
+- `timefence doctor` — Diagnose project setup and common issues
+- `timefence init` — Scaffold a `timefence.yaml` config file
+
+### Store
+
+- Build tracking with content-hashed manifests
+- Feature-level and build-level caching
+- Reproducible builds via `Store` and `.timefence/` directory
+
+### Configuration
+
+- `timefence.yaml` for project-level defaults
+- Precedence: CLI flags > Python API > `timefence.yaml` > built-in defaults
+
+### Developer Experience
+
+- Rich terminal output for all commands
+- JSON export for audit reports (`--json`) and HTML reports (`--html`)
+- `--strict` flag for CI integration (exit code 1 on leakage)
+- Structured error messages with fix suggestions
+- `--dry-run` for build previews

timefence-0.9.0/LICENSE

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