fleche 0.22.0__tar.gz → 0.22.2__tar.gz

fleche-0.22.0/.github/workflows/claude_ci_details.yaml → fleche-0.22.2/.github/workflows/ci-failure-summary.yml

@@ -25,7 +25,7 @@ jobs:
         with:
           claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
           claude_args: |
-            --model claude-haiku-4-5
+            --model haiku
             --allowedTools "Bash(gh run view:*),Bash(gh run download:*),Bash(gh api:*),Bash(gh pr comment:*),Bash(gh pr list:*),Bash(gh issue create:*),Bash(cat:*),Bash(head:*),Bash(tail:*),Bash(grep:*),Bash(wc:*),Bash(ls:*)"
           prompt: |
             A CI run just failed. Investigate and post a concise summary.
@@ -53,6 +53,6 @@ jobs:
                - If still no PR, open an issue titled "CI failure on ${{ github.event.workflow_run.head_branch }} @ <short-sha>" with the summary as the body
             5. Prepend this header to whatever you post:
                `🤖 **CI failure summary** for [\`<short-sha>\`](${{ github.event.workflow_run.html_url }}) on \`${{ github.event.workflow_run.head_branch }}\``
-               and append: `\n\n---\n_Generated by Claude Haiku 4.5._`
+               and append: `\n\n---\n_Generated by Claude Haiku._`
 
             Write the body to a temp file first (e.g. `/tmp/summary.md`) and use `--body-file` so markdown formatting survives intact.

{fleche-0.22.0 → fleche-0.22.2}/.github/workflows/claude.yaml

@@ -34,9 +34,9 @@ jobs:
           # followed by whitespace, punctuation, or end-of-line, so a model is
           # selected with a space -- '@claude [haiku|sonnet|opus]'. This step only
           # maps that alias onto a --model arg; bare or unrecognised mentions fall
-          # back to sonnet. (A glued '@claude[model]' would not trigger the action.)
+          # back to opus. (A glued '@claude[model]' would not trigger the action.)
           body="${COMMENT_BODY}${REVIEW_BODY}"
-          model=sonnet
+          model=opus
           if [[ "$body" =~ @claude[[:space:]]*\[([a-zA-Z]+)\] ]]; then
             choice="${BASH_REMATCH[1],,}"
             case "$choice" in
@@ -53,6 +53,6 @@ jobs:
       - uses: anthropics/claude-code-action@v1
         with:
           claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
-          claude_args: '--model ${{ steps.model.outputs.model }} --effort high --allowedTools WebFetch Bash(pip:*) Bash(python:*) Bash(pytest:*) Bash(git:*) Bash(gh pr:*)'
+          claude_args: '--model ${{ steps.model.outputs.model }} --effort high --allowedTools WebFetch Bash(pip:*) Bash(python:*) Bash(pytest:*) Bash(ty:*) Bash(uv:*) Bash(jupyter:*) Bash(git:*) Bash(gh pr:*) Bash(gh run:*)'
           additional_permissions: |
             actions: read

{fleche-0.22.0 → fleche-0.22.2}/.github/workflows/perf-triage.yml

@@ -41,7 +41,7 @@ jobs:
         with:
           claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
           claude_args: |
-            --model claude-haiku-4-5
+            --model haiku
             --allowedTools "Bash(gh pr view:*),Bash(gh pr diff:*),Bash(gh pr edit:*),Bash(gh label list:*),Bash(gh label create:*)"
           prompt: |
             You are triaging a pull request to decide whether it is

fleche-0.22.2/.github/workflows/reflow-agent-docs.yml

@@ -0,0 +1,57 @@
+name: reflow agent docs
+
+# Keeps AGENTS.md and agents/*.md at one sentence per line (see the
+# Conventions section of agents/DEVELOPING.md). On a same-repo PR the reflowed
+# files are committed back to the branch; a fork PR cannot be pushed to, so
+# there the job fails and asks the author to run the script.
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened]
+    paths:
+      - 'AGENTS.md'
+      - 'agents/*.md'
+      - '.github/workflows/reflow_agent_docs.py'
+      - '.github/workflows/reflow-agent-docs.yml'
+
+concurrency:
+  group: reflow-agent-docs-${{ github.head_ref }}
+  cancel-in-progress: true
+
+jobs:
+  reflow:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    env:
+      SAME_REPO: ${{ github.event.pull_request.head.repo.full_name == github.repository }}
+      HEAD_REF: ${{ github.event.pull_request.head.ref }}
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          ref: ${{ github.event.pull_request.head.ref }}
+          repository: ${{ github.event.pull_request.head.repo.full_name }}
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.12"
+      - name: Reflow (fork PR, check only)
+        if: env.SAME_REPO != 'true'
+        run: |
+          python .github/workflows/reflow_agent_docs.py --check || {
+            echo "::error::Agent docs need reflowing; run 'python .github/workflows/reflow_agent_docs.py' and push."
+            exit 1
+          }
+      - name: Reflow
+        if: env.SAME_REPO == 'true'
+        run: python .github/workflows/reflow_agent_docs.py
+      - name: Commit and push
+        if: env.SAME_REPO == 'true'
+        run: |
+          if git diff --quiet; then
+            echo "Agent docs already one sentence per line."
+            exit 0
+          fi
+          git -c user.name="github-actions[bot]" \
+              -c user.email="41898282+github-actions[bot]@users.noreply.github.com" \
+              commit -am "docs(agents): reflow to one sentence per line"
+          git push origin "HEAD:refs/heads/$HEAD_REF"

fleche-0.22.2/.github/workflows/reflow_agent_docs.py

@@ -0,0 +1,160 @@
+"""Reflow the agent guides to one sentence per line (semantic line breaks).
+
+Usage (from anywhere in the repo):
+
+    python .github/workflows/reflow_agent_docs.py          # rewrite AGENTS.md and agents/*.md in place
+    python .github/workflows/reflow_agent_docs.py --check  # list files that need reflowing; exit 1 if any
+    python .github/workflows/reflow_agent_docs.py FILE...  # only these files
+
+CI runs it on every PR touching those files (reflow-agent-docs.yml) and
+commits the result back to the PR branch.
+
+Every sentence and every ``;``-separated clause starts its own line, and long
+```a`, `b`, `c``` enumerations break before each item.
+Code fences, tables, headings and HTML are left alone.
+The rewrite is whitespace-only: it refuses to write a file whose word sequence
+would change, and running it twice is a no-op.
+"""
+
+import argparse
+import re
+import sys
+from pathlib import Path
+
+ROOT = Path(__file__).resolve().parents[2]
+ABBREVIATIONS = ("e.g.", "i.e.", "vs.", "etc.", "cf.", "approx.", "resp.")
+LIST_ITEM = re.compile(r"^(\s*)([-*+]|\d+\.)\s+")
+ENUM_LIMIT = 200  # only split ``, `item`` enumerations on lines longer than this
+UNTOUCHED = ("#", "|", "<", "---")
+
+
+def _skip_code_span(text: str, i: int) -> int:
+    """Return the index just past the code span opening at ``text[i]``."""
+    j = i
+    while j < len(text) and text[j] == "`":
+        j += 1
+    close = text.find(text[i:j], j)
+    return close + (j - i) if close != -1 else j
+
+
+def split_sentences(text: str) -> list[str]:
+    """Split after ``.``/``;``/``?``/``!`` followed by a space, outside code spans."""
+    parts, start, i = [], 0, 0
+    while i < len(text):
+        c = text[i]
+        if c == "`":
+            i = _skip_code_span(text, i)
+            continue
+        if c in ".;?!" and text[i + 1 : i + 2] == " " and text[i + 1 :].strip():
+            head = text[start : i + 1]
+            word = head.split()[-1] if head.strip() else ""
+            abbreviation = word.lower().endswith(ABBREVIATIONS)
+            # "1. " or a lone initial like "A. "
+            ordinal = c == "." and len(word) <= 2
+            if not (abbreviation or ordinal):
+                parts.append(head.strip())
+                start = i + 1
+        i += 1
+    if text[start:].strip():
+        parts.append(text[start:].strip())
+    return parts
+
+
+def split_enumeration(text: str) -> list[str]:
+    """Break a long line before each top-level ``, `item`` entry."""
+    if len(text) <= ENUM_LIMIT:
+        return [text]
+    parts, start, depth, i = [], 0, 0, 0
+    while i < len(text):
+        c = text[i]
+        if c == "`":
+            i = _skip_code_span(text, i)
+            continue
+        if c in "([{":
+            depth += 1
+        elif c in ")]}":
+            depth = max(0, depth - 1)
+        elif c == "," and depth == 0 and text.startswith(" `", i + 1):
+            parts.append(text[start : i + 1].strip())
+            start = i + 1
+        i += 1
+    parts.append(text[start:].strip())
+    return parts
+
+
+def _emit(prefix: str, indent: str, text: str) -> list[str]:
+    parts = [e for s in split_sentences(text) for e in split_enumeration(s)]
+    return [prefix + parts[0]] + [indent + p for p in parts[1:]]
+
+
+def _is_continuation(line: str, also_stop: tuple[str, ...] = ()) -> bool:
+    s = line.lstrip()
+    return bool(s) and not LIST_ITEM.match(line) and not s.startswith(("```", "|", "#") + also_stop)
+
+
+def reflow(src: str) -> str:
+    lines = src.split("\n")
+    out: list[str] = []
+    i, in_fence = 0, False
+    while i < len(lines):
+        line = lines[i]
+        s = line.lstrip()
+        if s.startswith("```"):
+            in_fence = not in_fence
+        if in_fence or s.startswith("```") or not s or s.startswith(UNTOUCHED):
+            out.append(line)
+            i += 1
+        elif s.startswith(">"):
+            buf = []
+            while i < len(lines) and lines[i].lstrip().startswith(">"):
+                buf.append(lines[i].lstrip()[1:].strip())
+                i += 1
+            out += _emit("> ", "> ", " ".join(buf))
+        elif m := LIST_ITEM.match(line):
+            prefix = m.group(0)
+            buf = [line[len(prefix) :].strip()]
+            i += 1
+            while i < len(lines) and _is_continuation(lines[i]):
+                buf.append(lines[i].strip())
+                i += 1
+            out += _emit(prefix, " " * len(prefix), " ".join(buf))
+        else:
+            lead = line[: len(line) - len(s)]
+            buf = []
+            while i < len(lines) and _is_continuation(lines[i], also_stop=(">",)):
+                buf.append(lines[i].strip())
+                i += 1
+            out += _emit(lead, lead, " ".join(buf))
+    return "\n".join(out)
+
+
+def _words(text: str) -> list[str]:
+    return [w for w in text.split() if w != ">"]
+
+
+def main(argv: list[str] | None = None) -> int:
+    parser = argparse.ArgumentParser(description=__doc__.splitlines()[0])
+    parser.add_argument("files", nargs="*", type=Path, help="default: AGENTS.md and agents/*.md")
+    parser.add_argument("--check", action="store_true", help="report files that need reflowing; don't write")
+    args = parser.parse_args(argv)
+
+    files = args.files or [ROOT / "AGENTS.md", *sorted((ROOT / "agents").glob("*.md"))]
+    dirty = []
+    for path in files:
+        old = path.read_text()
+        new = reflow(old)
+        if _words(old) != _words(new):
+            print(f"{path}: reflow would change words, not just line breaks — skipped", file=sys.stderr)
+            return 2
+        if new != old:
+            dirty.append(path)
+            if not args.check:
+                path.write_text(new)
+    for path in dirty:
+        shown = path.relative_to(ROOT) if path.is_relative_to(ROOT) else path
+        print(f"{'needs reflow' if args.check else 'reflowed'}: {shown}")
+    return 1 if args.check and dirty else 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

fleche-0.22.2/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.22.2"
+}

fleche-0.22.2/AGENTS.md

@@ -0,0 +1,33 @@
+# AGENTS.md
+
+Cross-tool entry point for AI coding agents (Codex, Cursor, Aider, Claude, ...).
+
+**Fleche** is a persistent function cache for Python (`@fleche()`) — like `lru_cache` but it survives restarts, with SHA256 content-based keys and pluggable storage backends (memory, pickle-family, HDF5, SQL, SSH).
+
+This file is deliberately short.
+Pick the guide that matches what you're doing:
+
+| Task | Guide |
+|---|---|
+| Writing code that *calls* fleche — decorating functions, configuring a cache via `fleche.toml`, choosing a storage backend, querying stored calls | **[agents/USAGE.md](agents/USAGE.md)** |
+| Changing fleche's *own* source — commands, tests, module map, architecture internals, open design themes on the issue tracker, commit conventions | **[agents/DEVELOPING.md](agents/DEVELOPING.md)** |
+
+When editing this file or `agents/*.md`, write **one sentence per line** (and one `;`-clause per line);
+never hard-wrap or join lines.
+`python .github/workflows/reflow_agent_docs.py` applies this for you.
+Many PRs edit these guides at once, and line-per-sentence keeps their diffs small and mergeable.
+See [agents/DEVELOPING.md](agents/DEVELOPING.md#conventions).
+
+Full human-facing docs (Sphinx) live in `docs/`;
+runnable examples live in `notebooks/`.
+
+## In a hurry
+
+```bash
+pip install -e ".[tests]"     # install with test deps
+pytest tests/                 # run tests
+ty check src/                 # type check
+```
+
+Python `>=3.11,<3.15`.
+Conventional Commits are required on every commit message (`feat:`/`fix:`/`docs:`/`test:`/`chore:`/`refactor:`) — see [agents/DEVELOPING.md](agents/DEVELOPING.md#commit-messages) for why and how.

{fleche-0.22.0 → fleche-0.22.2}/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## [0.22.2](https://github.com/pmrv/fleche/compare/0.22.1...0.22.2) (2026-10-23)
+
+
+### Bug Fixes
+
+* **digest:** digest object and structured numpy arrays by value ([#1010](https://github.com/pmrv/fleche/issues/1010)) ([35fae96](https://github.com/pmrv/fleche/commit/35fae964b3b1c7bc7ff2301fd830baad6c360538))
+* **digest:** hash pandas object columns pandas cannot hash faithfully ([#1006](https://github.com/pmrv/fleche/issues/1006)) ([c0eed1b](https://github.com/pmrv/fleche/commit/c0eed1bd75c1f5ff0c19d8ddb13baa1158653a13))
+
+## [0.22.1](https://github.com/pmrv/fleche/compare/0.22.0...0.22.1) (2026-09-03)
+
+
+### Bug Fixes
+
+* **digest:** fold captured variables and argument defaults into function digests ([#909](https://github.com/pmrv/fleche/issues/909)) ([cb9ed6c](https://github.com/pmrv/fleche/commit/cb9ed6c3e7c0f1a246b007cd023a28b8b72a52a9))
+
 ## [0.22.0](https://github.com/pmrv/fleche/compare/0.21.2...0.22.0) (2026-08-28)
 
 

{fleche-0.22.0/src/fleche.egg-info → fleche-0.22.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fleche
-Version: 0.22.0
+Version: 0.22.2
 Summary: Hierachical, persistant caches in python
 Author-email: Marvin Poul <pmrv@posteo.de>
 License-Expression: BSD-3-Clause
@@ -26,7 +26,7 @@ Requires-Dist: dill>=0.3; extra == "dill"
 Provides-Extra: sqlalchemy
 Requires-Dist: sqlalchemy>=2; extra == "sqlalchemy"
 Provides-Extra: bagofholding
-Requires-Dist: bagofholding==0.1.12; extra == "bagofholding"
+Requires-Dist: bagofholding<0.1.17,>=0.1.12; extra == "bagofholding"
 Provides-Extra: ssh
 Requires-Dist: cloudpickle>=2; extra == "ssh"
 Provides-Extra: tests
@@ -35,7 +35,7 @@ Requires-Dist: hypothesis>=6.100; extra == "tests"
 Requires-Dist: cloudpickle>=2; extra == "tests"
 Requires-Dist: dill>=0.3; extra == "tests"
 Requires-Dist: sqlalchemy>=2; extra == "tests"
-Requires-Dist: bagofholding==0.1.12; extra == "tests"
+Requires-Dist: bagofholding<0.1.17,>=0.1.12; extra == "tests"
 Requires-Dist: nbconvert>=6.5; extra == "tests"
 Requires-Dist: ipykernel>=6.26; extra == "tests"
 Requires-Dist: tabulate>=0.8; extra == "tests"
@@ -43,16 +43,14 @@ Requires-Dist: attrs>=21.3; extra == "tests"
 Provides-Extra: executorlib
 Requires-Dist: executorlib; extra == "executorlib"
 Provides-Extra: ty
-Requires-Dist: ty==0.0.74; extra == "ty"
+Requires-Dist: ty==0.0.89; extra == "ty"
 Dynamic: license-file
 
 # fleche
 
 [![docs](https://app.readthedocs.org/projects/fleche/badge/?version=latest)](https://fleche.readthedocs.io/en/latest/?badge=latest)
 
-
-
-
+Requires Python 3.11–3.14.
 
 A persistent caching solution for arbitrary Python functions - like `lru_cache` on steroids.
 
@@ -162,7 +160,7 @@ if compute.contains(5):
 else:
     result = compute(5)
 
-# Get Call object with metadata
+# Get the Call object used for lookup (no result/metadata yet — see .query() for stored metadata)
 call = compute.call(5)
 ```
 
@@ -281,6 +279,6 @@ BSD-3-Clause License - see LICENSE file for details.
 
 ## Resources
 
-- **Documentation**: See `docs/` directory
+- **Documentation**: https://fleche.readthedocs.io
 - **Tests**: See `tests/` for usage examples
 - **Benchmarks**: See `benchmarks/` for performance metrics

{fleche-0.22.0 → fleche-0.22.2}/README.md

@@ -2,9 +2,7 @@
 
 [![docs](https://app.readthedocs.org/projects/fleche/badge/?version=latest)](https://fleche.readthedocs.io/en/latest/?badge=latest)
 
-
-
-
+Requires Python 3.11–3.14.
 
 A persistent caching solution for arbitrary Python functions - like `lru_cache` on steroids.
 
@@ -114,7 +112,7 @@ if compute.contains(5):
 else:
     result = compute(5)
 
-# Get Call object with metadata
+# Get the Call object used for lookup (no result/metadata yet — see .query() for stored metadata)
 call = compute.call(5)
 ```
 
@@ -233,6 +231,6 @@ BSD-3-Clause License - see LICENSE file for details.
 
 ## Resources
 
-- **Documentation**: See `docs/` directory
+- **Documentation**: https://fleche.readthedocs.io
 - **Tests**: See `tests/` for usage examples
 - **Benchmarks**: See `benchmarks/` for performance metrics