predikit 0.4.6__tar.gz → 0.5.1__tar.gz

predikit-0.5.1/.claude/settings.local.json

@@ -0,0 +1,34 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(git add *)",
+      "Bash(git commit -m ' *)",
+      "Bash(python -m pytest tests/ -v --tb=short --cov=src/predikit --cov-report=term-missing)",
+      "WebFetch(domain:github.com)",
+      "PowerShell(python -m pip install mypy -q)",
+      "PowerShell(python -m mypy src/predikit)",
+      "Bash(python -m pytest --tb=short -q)",
+      "Bash(uv run *)",
+      "PowerShell(C:\\\\AI\\\\predikit\\\\.venv\\\\Scripts\\\\python.exe -m ensurepip --upgrade)",
+      "Bash(gh issue *)",
+      "Bash(gh pr *)",
+      "PowerShell(gh issue list --state open --limit 30 2>&1)",
+      "PowerShell(gh pr list --state open --limit 30 2>&1)",
+      "Bash(sed -n '/Roadmap/,/^---/p' README.md | head -80)",
+      "Bash(python -c \"import langchain_core; print\\(langchain_core.__version__\\)\")",
+      "Bash(pip show *)",
+      "Bash(./.venv/Scripts/python.exe -c \"import langchain_core; print\\(langchain_core.__version__\\)\")",
+      "Bash(./.venv/Scripts/python.exe -m pytest --version)",
+      "Bash(./.venv/Scripts/python.exe -c ' *)",
+      "Bash(./.venv/Scripts/python.exe -m pytest --cov=src/predikit --cov-report=term-missing -q)",
+      "Bash(./.venv/Scripts/python.exe -m ruff check src/ tests/)",
+      "Bash(./.venv/Scripts/python.exe -m ruff format --check src/ tests/)",
+      "Bash(./.venv/Scripts/python.exe -m mypy src/predikit)",
+      "Bash(git stash *)",
+      "Bash(./.venv/Scripts/python.exe -m pytest -q)"
+    ],
+    "additionalDirectories": [
+      "C:\\AI\\predikit"
+    ]
+  }
+}

{predikit-0.4.6 → predikit-0.5.1}/.github/ISSUE_TEMPLATE/bug_report.md

@@ -1,38 +1,38 @@
----
-name: Bug report
-about: Create a report to help us improve
-title: ''
-labels: ''
-assignees: ''
-
----
-
-**Describe the bug**
-A clear and concise description of what the bug is.
-
-**To Reproduce**
-Steps to reproduce the behavior:
-1. Go to '...'
-2. Click on '....'
-3. Scroll down to '....'
-4. See error
-
-**Expected behavior**
-A clear and concise description of what you expected to happen.
-
-**Screenshots**
-If applicable, add screenshots to help explain your problem.
-
-**Desktop (please complete the following information):**
- - OS: [e.g. iOS]
- - Browser [e.g. chrome, safari]
- - Version [e.g. 22]
-
-**Smartphone (please complete the following information):**
- - Device: [e.g. iPhone6]
- - OS: [e.g. iOS8.1]
- - Browser [e.g. stock browser, safari]
- - Version [e.g. 22]
-
-**Additional context**
-Add any other context about the problem here.
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.
+
+**Desktop (please complete the following information):**
+ - OS: [e.g. iOS]
+ - Browser [e.g. chrome, safari]
+ - Version [e.g. 22]
+
+**Smartphone (please complete the following information):**
+ - Device: [e.g. iPhone6]
+ - OS: [e.g. iOS8.1]
+ - Browser [e.g. stock browser, safari]
+ - Version [e.g. 22]
+
+**Additional context**
+Add any other context about the problem here.

{predikit-0.4.6 → predikit-0.5.1}/.github/ISSUE_TEMPLATE/feature_request.md

@@ -1,20 +1,20 @@
----
-name: Feature request
-about: Suggest an idea for this project
-title: ''
-labels: ''
-assignees: ''
-
----
-
-**Is your feature request related to a problem? Please describe.**
-A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
-
-**Describe the solution you'd like**
-A clear and concise description of what you want to happen.
-
-**Describe alternatives you've considered**
-A clear and concise description of any alternative solutions or features you've considered.
-
-**Additional context**
-Add any other context or screenshots about the feature request here.
+---
+name: Feature request
+about: Suggest an idea for this project
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

{predikit-0.4.6 → predikit-0.5.1}/.github/workflows/publish.yml

@@ -1,31 +1,31 @@
-name: Publish to PyPI
-
-on:
-  release:
-    types: [published]
-
-permissions:
-  contents: read
-
-jobs:
-  publish:
-    runs-on: ubuntu-latest
-    environment: pypi
-    permissions:
-      contents: read
-      id-token: write
-
-    steps:
-      - uses: actions/checkout@v4
-
-      - uses: actions/setup-python@v5
-        with:
-          python-version: "3.12"
-
-      - name: Build
-        run: |
-          pip install hatchling
-          python -m hatchling build
-
-      - name: Publish to PyPI
-        uses: pypa/gh-action-pypi-publish@release/v1
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      contents: read
+      id-token: write
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Build
+        run: |
+          pip install hatchling
+          python -m hatchling build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

{predikit-0.4.6 → predikit-0.5.1}/.github/workflows/test.yml

@@ -1,51 +1,51 @@
-name: Test
-
-on:
-  push:
-    branches: [main]
-  pull_request:
-    branches: [main]
-
-permissions:
-  contents: read
-
-jobs:
-  lint:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-
-      - uses: actions/setup-python@v5
-        with:
-          python-version: "3.12"
-
-      - name: Install dev dependencies
-        run: pip install -e ".[dev]"
-
-      - name: Ruff lint
-        run: ruff check src/ tests/
-
-      - name: Ruff format check
-        run: ruff format --check src/ tests/
-
-      - name: Mypy
-        run: mypy src/predikit
-
-  test:
-    runs-on: ubuntu-latest
-    strategy:
-      matrix:
-        python-version: ["3.10", "3.11", "3.12"]
-
-    steps:
-      - uses: actions/checkout@v4
-
-      - uses: actions/setup-python@v5
-        with:
-          python-version: ${{ matrix.python-version }}
-
-      - name: Install dependencies
-        run: pip install -e ".[dev]"
-
-      - name: Run tests
-        run: pytest --cov=src/predikit --cov-report=term-missing
+name: Test
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+permissions:
+  contents: read
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install dev dependencies
+        run: pip install -e ".[dev]"
+
+      - name: Ruff lint
+        run: ruff check src/ tests/
+
+      - name: Ruff format check
+        run: ruff format --check src/ tests/
+
+      - name: Mypy
+        run: mypy src/predikit
+
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: pip install -e ".[dev]"
+
+      - name: Run tests
+        run: pytest --cov=src/predikit --cov-report=term-missing

{predikit-0.4.6 → predikit-0.5.1}/.gitignore

@@ -1,14 +1,14 @@
-__pycache__/
-*.py[cod]
-*.egg-info/
+__pycache__/
+*.py[cod]
+*.egg-info/
 dist/
 build/
 mlruns/
 .coverage
 coverage.xml
-htmlcov/
-.pytest_cache/
-.venv/
-venv/
-*.egg
+htmlcov/
+.pytest_cache/
+.venv/
+venv/
+*.egg
 file.py

{predikit-0.4.6 → predikit-0.5.1}/.pre-commit-config.yaml

@@ -1,15 +1,15 @@
-repos:
-  - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.5.0
-    hooks:
-      - id: ruff
-        args: [--fix]
-      - id: ruff-format
-
-  - repo: https://github.com/pre-commit/mirrors-mypy
-    rev: v1.10.0
-    hooks:
-      - id: mypy
-        additional_dependencies:
-          - pydantic>=2.0
-          - numpy>=1.24
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.5.0
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format
+
+  - repo: https://github.com/pre-commit/mirrors-mypy
+    rev: v1.10.0
+    hooks:
+      - id: mypy
+        additional_dependencies:
+          - pydantic>=2.0
+          - numpy>=1.24

{predikit-0.4.6 → predikit-0.5.1}/CHANGELOG.md

@@ -1,12 +1,22 @@
-# Changelog
-
-All notable changes to this project will be documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
 ## [Unreleased]
 
-## [0.4.6] - 2026-07-01
+## [0.5.1] - 2026-07-21
+
+### Added
+- Test coverage for the LangChain exporter (`test_exporters_langchain.py`) — previously untested
+- Warning when `confidence_threshold` is set on a classifier whose model has no `predict_proba` method, mirroring the existing regressor warning
+- Test coverage for both `confidence_threshold` construction-time warnings (regressor, and classifier without `predict_proba`)
+
+### Fixed
+- `to_langchain()` now wires up `ainvoke()` as the LangChain tool's `coroutine`, so async LangChain agents actually get async execution instead of silently falling back to sync
+
+## [0.5.0] - 2026-07-01
 
 ### Fixed
 - Improved `ModelTool` input coercion for optional scalar annotations like `float | None`, `bool | None`, `int | None`, and `str | None`
@@ -31,55 +41,55 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 ## [0.4.4] - 2026-06-24
 
 ### Changed
-- README overhauled: added "Why predikit?" comparison table, "Works with" ecosystem section, GitHub star/fork badges, and a shipped-vs-planned roadmap
-- Quick start section replaces "30-second example" heading; `---` dividers added between major sections for better scanability
-- PyPI package description updated to a more descriptive one-liner
-- Keywords expanded: added `scikit-learn`, `tool-use`, `openai`, `langchain`, `mlops`, `ai-agents`, `pydantic`, `model-serving`
-- Added `Documentation` URL to `[project.urls]` in `pyproject.toml`
-- Added `Topic :: Software Development :: Libraries :: Python Modules` and `Typing :: Typed` classifiers
-
-## [0.4.2] - 2026-06-13
-
-### Changed
-- Redesigned PyPI/README hero: logo, centered tagline, and badges in a unified `<p align="center">` block
-- Tagline moved from a `##` heading to a proper descriptive paragraph
-- Badges converted to centered HTML `<img>` links for consistent rendering on PyPI
-- Quick code teaser repositioned directly below badges (before Table of Contents)
-- "Field naming rule" added to Table of Contents
-- `ainvoke()` added to `ModelTool` Core API reference table
-- `ModelEnsemble` Core API subsection added with constructor signature and full strategy table
-- Project Traffic / download badge moved to bottom of README
-- Development Status classifier bumped from `3 - Alpha` to `4 - Beta` in `pyproject.toml`
-- Removed CI test status badge from README
-
-## [0.4.1] - 2026-06-02
-
-### Added
-- `ruff` (lint + format) and `mypy` (type checking) configured in `pyproject.toml`
-- `.pre-commit-config.yaml` — ruff and mypy hooks run automatically before every commit
-- Lint CI job in GitHub Actions — runs `ruff check`, `ruff format --check`, and `mypy` on every push and PR
-- `CONTRIBUTING.md` — development setup, code style, and PR guidelines
-- `CHANGELOG.md`
-- `CLAUDE.md` — project context for Claude Code
-
-### Changed
-- Bumped version to `0.4.1`
-- Added `ruff>=0.4.0`, `mypy>=1.10`, and `pre-commit>=3.0` to `[dev]` extras
-
-## [0.4.0] - 2026-05-01
-
-### Added
-- `ModelEnsemble` with `weighted_mean` and `weighted_vote` strategies
-- `ainvoke()` async wrapper on `ModelTool` (runs blocking predict in a thread pool)
-- Verbose logging via `verbose=True` on `ModelTool`
-- Snowflake Model Registry loader (`from_snowflake`)
-- MLflow Model Registry loader (`from_mlflow`)
-- `predikit inspect` CLI command
-
-### Changed
-- Moved to `src/` layout with hatchling build backend
-- Upgraded Pydantic dependency to v2
-
-## [0.3.x] and earlier
-
-See [GitHub Releases](https://github.com/Tejas-TA/predikit/releases) for earlier history.
+- README overhauled: added "Why predikit?" comparison table, "Works with" ecosystem section, GitHub star/fork badges, and a shipped-vs-planned roadmap
+- Quick start section replaces "30-second example" heading; `---` dividers added between major sections for better scanability
+- PyPI package description updated to a more descriptive one-liner
+- Keywords expanded: added `scikit-learn`, `tool-use`, `openai`, `langchain`, `mlops`, `ai-agents`, `pydantic`, `model-serving`
+- Added `Documentation` URL to `[project.urls]` in `pyproject.toml`
+- Added `Topic :: Software Development :: Libraries :: Python Modules` and `Typing :: Typed` classifiers
+
+## [0.4.2] - 2026-06-13
+
+### Changed
+- Redesigned PyPI/README hero: logo, centered tagline, and badges in a unified `<p align="center">` block
+- Tagline moved from a `##` heading to a proper descriptive paragraph
+- Badges converted to centered HTML `<img>` links for consistent rendering on PyPI
+- Quick code teaser repositioned directly below badges (before Table of Contents)
+- "Field naming rule" added to Table of Contents
+- `ainvoke()` added to `ModelTool` Core API reference table
+- `ModelEnsemble` Core API subsection added with constructor signature and full strategy table
+- Project Traffic / download badge moved to bottom of README
+- Development Status classifier bumped from `3 - Alpha` to `4 - Beta` in `pyproject.toml`
+- Removed CI test status badge from README
+
+## [0.4.1] - 2026-06-02
+
+### Added
+- `ruff` (lint + format) and `mypy` (type checking) configured in `pyproject.toml`
+- `.pre-commit-config.yaml` — ruff and mypy hooks run automatically before every commit
+- Lint CI job in GitHub Actions — runs `ruff check`, `ruff format --check`, and `mypy` on every push and PR
+- `CONTRIBUTING.md` — development setup, code style, and PR guidelines
+- `CHANGELOG.md`
+- `CLAUDE.md` — project context for Claude Code
+
+### Changed
+- Bumped version to `0.4.1`
+- Added `ruff>=0.4.0`, `mypy>=1.10`, and `pre-commit>=3.0` to `[dev]` extras
+
+## [0.4.0] - 2026-05-01
+
+### Added
+- `ModelEnsemble` with `weighted_mean` and `weighted_vote` strategies
+- `ainvoke()` async wrapper on `ModelTool` (runs blocking predict in a thread pool)
+- Verbose logging via `verbose=True` on `ModelTool`
+- Snowflake Model Registry loader (`from_snowflake`)
+- MLflow Model Registry loader (`from_mlflow`)
+- `predikit inspect` CLI command
+
+### Changed
+- Moved to `src/` layout with hatchling build backend
+- Upgraded Pydantic dependency to v2
+
+## [0.3.x] and earlier
+
+See [GitHub Releases](https://github.com/Tejas-TA/predikit/releases) for earlier history.

{predikit-0.4.6 → predikit-0.5.1}/CLAUDE.md

@@ -1,71 +1,71 @@
-# predikit — Claude Code context
-
-## What this is
-
-predikit wraps fitted scikit-learn / XGBoost models as LLM-callable tools with auto-generated JSON schemas, typed I/O via Pydantic, and first-class support for OpenAI function calling and LangChain.
-
-## Project layout
-
-```
-src/predikit/          Core package (installed as `predikit`)
-  tool.py              ModelTool — main public class
-  registry.py          ToolRegistry — groups multiple tools for bulk export
-  ensemble.py          ModelEnsemble — multi-model reconciliation strategies
-  exceptions.py        LowConfidenceError
-  coerce.py            LLM-string → Python type coercion (bool, int, float, str)
-  introspect.py        Extract sklearn model metadata (feature names, task type)
-  cli.py               `predikit inspect` CLI (click + joblib)
-  exporters/
-    openai.py          .to_openai() — OpenAI function-calling schema
-    langchain.py       .to_langchain() — LangChain StructuredTool
-  loaders/
-    mlflow.py          from_mlflow() — load from MLflow Model Registry
-    snowflake.py       from_snowflake() — load from Snowflake Model Registry
-tests/                 pytest suite (mirrors src/ layout)
-examples/              Standalone usage scripts (01–07)
-```
-
-## Commands
-
-```bash
-# Install for development
-pip install -e ".[dev]"
-
-# Run tests
-pytest --cov=src/predikit --cov-report=term-missing
-
-# Lint (check only)
-ruff check src/ tests/
-
-# Format (check only)
-ruff format --check src/ tests/
-
-# Lint + format (auto-fix)
-ruff check --fix src/ tests/
-ruff format src/ tests/
-
-# Type check
-mypy src/predikit
-
-# All checks via pre-commit
-pre-commit run --all-files
-
-# Install pre-commit hooks
-pre-commit install
-```
-
-## Key conventions
-
-- **Public API** — `ModelTool`, `ToolRegistry`, `ModelEnsemble`, `LowConfidenceError` are all re-exported from `predikit/__init__.py`. Everything else is internal.
-- **Optional imports** — heavy optional deps (`langchain`, `xgboost`, `mlflow`, `snowflake`) are imported inside functions/methods, never at module level, so missing extras don't break core imports.
-- **Feature name matching** — inputs map to model features by column name (using `feature_names_in_` from sklearn), not by position. Mismatches raise a `ValueError` with a clear diff.
-- **Bool coercion** — `coerce_value()` converts LLM strings (`"yes"`, `"true"`, `"1"`, `"on"`) to Python bools before Pydantic validation.
-- **Async** — `ainvoke()` is a thin wrapper over `invoke()` via `loop.run_in_executor`. No async-native I/O involved.
-- **Ensemble strategies** — `"collect"`, `"mean"`, `"vote"`, `"weighted_mean"`, `"weighted_vote"`. Weighted strategies take a `weights` list parallel to `tools`.
-
-## Release process
-
-1. Bump `version` in `pyproject.toml` and `__version__` in `src/predikit/__init__.py`.
-2. Add a section to `CHANGELOG.md`.
-3. Commit, push to `main`, create a GitHub Release with the version tag (e.g. `v0.4.1`).
-4. `publish.yml` auto-triggers a PyPI upload via OIDC trusted publishing.
+# predikit — Claude Code context
+
+## What this is
+
+predikit wraps fitted scikit-learn / XGBoost models as LLM-callable tools with auto-generated JSON schemas, typed I/O via Pydantic, and first-class support for OpenAI function calling and LangChain.
+
+## Project layout
+
+```
+src/predikit/          Core package (installed as `predikit`)
+  tool.py              ModelTool — main public class
+  registry.py          ToolRegistry — groups multiple tools for bulk export
+  ensemble.py          ModelEnsemble — multi-model reconciliation strategies
+  exceptions.py        LowConfidenceError
+  coerce.py            LLM-string → Python type coercion (bool, int, float, str)
+  introspect.py        Extract sklearn model metadata (feature names, task type)
+  cli.py               `predikit inspect` CLI (click + joblib)
+  exporters/
+    openai.py          .to_openai() — OpenAI function-calling schema
+    langchain.py       .to_langchain() — LangChain StructuredTool
+  loaders/
+    mlflow.py          from_mlflow() — load from MLflow Model Registry
+    snowflake.py       from_snowflake() — load from Snowflake Model Registry
+tests/                 pytest suite (mirrors src/ layout)
+examples/              Standalone usage scripts (01–07)
+```
+
+## Commands
+
+```bash
+# Install for development
+pip install -e ".[dev]"
+
+# Run tests
+pytest --cov=src/predikit --cov-report=term-missing
+
+# Lint (check only)
+ruff check src/ tests/
+
+# Format (check only)
+ruff format --check src/ tests/
+
+# Lint + format (auto-fix)
+ruff check --fix src/ tests/
+ruff format src/ tests/
+
+# Type check
+mypy src/predikit
+
+# All checks via pre-commit
+pre-commit run --all-files
+
+# Install pre-commit hooks
+pre-commit install
+```
+
+## Key conventions
+
+- **Public API** — `ModelTool`, `ToolRegistry`, `ModelEnsemble`, `LowConfidenceError` are all re-exported from `predikit/__init__.py`. Everything else is internal.
+- **Optional imports** — heavy optional deps (`langchain`, `xgboost`, `mlflow`, `snowflake`) are imported inside functions/methods, never at module level, so missing extras don't break core imports.
+- **Feature name matching** — inputs map to model features by column name (using `feature_names_in_` from sklearn), not by position. Mismatches raise a `ValueError` with a clear diff.
+- **Bool coercion** — `coerce_value()` converts LLM strings (`"yes"`, `"true"`, `"1"`, `"on"`) to Python bools before Pydantic validation.
+- **Async** — `ainvoke()` is a thin wrapper over `invoke()` via `loop.run_in_executor`. No async-native I/O involved.
+- **Ensemble strategies** — `"collect"`, `"mean"`, `"vote"`, `"weighted_mean"`, `"weighted_vote"`. Weighted strategies take a `weights` list parallel to `tools`.
+
+## Release process
+
+1. Bump `version` in `pyproject.toml` and `__version__` in `src/predikit/__init__.py`.
+2. Add a section to `CHANGELOG.md`.
+3. Commit, push to `main`, create a GitHub Release with the version tag (e.g. `v0.4.1`).
+4. `publish.yml` auto-triggers a PyPI upload via OIDC trusted publishing.