ragfallback 2.2.1__tar.gz → 2.2.3__tar.gz

{ragfallback-2.2.1 → ragfallback-2.2.3}/MANIFEST.in

@@ -7,12 +7,3 @@ include pytest.ini
 recursive-include ragfallback *.py py.typed
 recursive-include examples *.py
 recursive-include tests *.py
-
-
-
-
-
-
-
-
-

{ragfallback-2.2.1/ragfallback.egg-info → ragfallback-2.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ragfallback
-Version: 2.2.1
+Version: 2.2.3
 Summary: Prevents silent RAG failures — chunk quality, retrieval fallback, adaptive querying, and answer evaluation in one library.
 Home-page: https://github.com/irfanalidv/ragfallback
 Author: Irfan Ali
@@ -116,6 +116,7 @@ Drop into any LangChain-compatible stack. Catches bad chunks before they're embe
 [![PyPI](https://img.shields.io/pypi/v/ragfallback?color=3fb950&label=PyPI)](https://pypi.org/project/ragfallback/)
 [![Downloads](https://static.pepy.tech/badge/ragfallback)](https://pepy.tech/project/ragfallback)
 [![Tests](https://github.com/irfanalidv/ragfallback/actions/workflows/test.yml/badge.svg)](https://github.com/irfanalidv/ragfallback/actions/workflows/test.yml)
+[![Lint](https://github.com/irfanalidv/ragfallback/actions/workflows/lint.yml/badge.svg)](https://github.com/irfanalidv/ragfallback/actions/workflows/lint.yml)
 [![Python](https://img.shields.io/badge/python-3.8%E2%80%933.11-blue.svg)](https://pypi.org/project/ragfallback/)
 [![License: MIT](https://img.shields.io/github/license/irfanalidv/ragfallback)](https://github.com/irfanalidv/ragfallback/blob/main/LICENSE)
 [![GitHub stars](https://img.shields.io/github/stars/irfanalidv/ragfallback?style=social)](https://github.com/irfanalidv/ragfallback/stargazers)
@@ -595,7 +596,8 @@ RAGEvaluator (10 real Q&A pairs, heuristic, no LLM judge):
   Avg overall      : 62.9%
 ```
 
-Install: `pip install ragfallback[chroma,huggingface,real-data]`  
+Install: `pip install ragfallback[chroma,huggingface,real-data]`
+
 Dataset: [rajpurkar/squad](https://huggingface.co/datasets/rajpurkar/squad) — CC BY-SA 4.0
 
 ---
@@ -769,6 +771,7 @@ See [CONTRIBUTING.md](CONTRIBUTING.md). The quick version: run `pytest tests/uni
 ## License · Changelog
 
 MIT License — see [LICENSE](LICENSE).
+
 Full version history in [CHANGELOG.md](CHANGELOG.md).
 
 ---

{ragfallback-2.2.1 → ragfallback-2.2.3}/README.md

@@ -9,6 +9,7 @@ Drop into any LangChain-compatible stack. Catches bad chunks before they're embe
 [![PyPI](https://img.shields.io/pypi/v/ragfallback?color=3fb950&label=PyPI)](https://pypi.org/project/ragfallback/)
 [![Downloads](https://static.pepy.tech/badge/ragfallback)](https://pepy.tech/project/ragfallback)
 [![Tests](https://github.com/irfanalidv/ragfallback/actions/workflows/test.yml/badge.svg)](https://github.com/irfanalidv/ragfallback/actions/workflows/test.yml)
+[![Lint](https://github.com/irfanalidv/ragfallback/actions/workflows/lint.yml/badge.svg)](https://github.com/irfanalidv/ragfallback/actions/workflows/lint.yml)
 [![Python](https://img.shields.io/badge/python-3.8%E2%80%933.11-blue.svg)](https://pypi.org/project/ragfallback/)
 [![License: MIT](https://img.shields.io/github/license/irfanalidv/ragfallback)](https://github.com/irfanalidv/ragfallback/blob/main/LICENSE)
 [![GitHub stars](https://img.shields.io/github/stars/irfanalidv/ragfallback?style=social)](https://github.com/irfanalidv/ragfallback/stargazers)
@@ -488,7 +489,8 @@ RAGEvaluator (10 real Q&A pairs, heuristic, no LLM judge):
   Avg overall      : 62.9%
 ```
 
-Install: `pip install ragfallback[chroma,huggingface,real-data]`  
+Install: `pip install ragfallback[chroma,huggingface,real-data]`
+
 Dataset: [rajpurkar/squad](https://huggingface.co/datasets/rajpurkar/squad) — CC BY-SA 4.0
 
 ---
@@ -662,6 +664,7 @@ See [CONTRIBUTING.md](CONTRIBUTING.md). The quick version: run `pytest tests/uni
 ## License · Changelog
 
 MIT License — see [LICENSE](LICENSE).
+
 Full version history in [CHANGELOG.md](CHANGELOG.md).
 
 ---

{ragfallback-2.2.1 → ragfallback-2.2.3}/examples/build_golden_dataset.py

@@ -32,7 +32,9 @@ def _doc_id(text: str, prefix: str = "doc") -> str:
     return f"{prefix}_{h}"
 
 
-def build_squad_samples(n: int = 75) -> Tuple[List[Dict[str, Any]], List[Dict[str, Any]]]:
+def build_squad_samples(
+    n: int = 75,
+) -> Tuple[List[Dict[str, Any]], List[Dict[str, Any]]]:
     """
     Load SQuAD validation split.
 
@@ -104,7 +106,9 @@ def build_squad_samples(n: int = 75) -> Tuple[List[Dict[str, Any]], List[Dict[st
     return samples, docs_meta
 
 
-def build_sciq_samples(n: int = 25) -> Tuple[List[Dict[str, Any]], List[Dict[str, Any]]]:
+def build_sciq_samples(
+    n: int = 25,
+) -> Tuple[List[Dict[str, Any]], List[Dict[str, Any]]]:
     """
     Load SciQ test split — science domain, harder than SQuAD.
 

{ragfallback-2.2.1 → ragfallback-2.2.3}/examples/chroma_real_kb_demo.py

@@ -33,6 +33,7 @@ warnings.filterwarnings(
 )
 
 import _kb_common
+
 from ragfallback import AdaptiveRAGRetriever, CostTracker, MetricsCollector
 from ragfallback.utils.llm_factory import create_open_source_llm
 
@@ -66,7 +67,9 @@ def _run_demo() -> int:
             collection_name="ragfallback_kb_demo",
         )
     except ImportError as e:
-        print(f"{e}\nInstall: pip install chromadb sentence-transformers", file=sys.stderr)
+        print(
+            f"{e}\nInstall: pip install chromadb sentence-transformers", file=sys.stderr
+        )
         return 1
 
     print("Chroma collection ready (embeddings computed from real file contents).\n")
@@ -118,7 +121,11 @@ def _run_demo() -> int:
         )
     except Exception as e:
         err = str(e).lower()
-        if "connection refused" in err or "11434" in err or "failed to establish" in err:
+        if (
+            "connection refused" in err
+            or "11434" in err
+            or "failed to establish" in err
+        ):
             print(
                 "\n(Ollama not reachable — retrieval-only preview, no paid API keys.)\n"
                 "For full adaptive RAG: install https://ollama.ai and run: ollama pull llama3\n"
@@ -127,7 +134,9 @@ def _run_demo() -> int:
             for i, doc in enumerate(hits, 1):
                 src = (doc.metadata or {}).get("source", "?")
                 body = (doc.page_content or "")[:400].replace("\n", " ")
-                print(f"  [{i}] source={src}\n      {body}{'…' if len(doc.page_content or '') > 400 else ''}\n")
+                print(
+                    f"  [{i}] source={src}\n      {body}{'…' if len(doc.page_content or '') > 400 else ''}\n"
+                )
             return 0
         print(
             "Adaptive RAG failed. Is Ollama running?\n"
@@ -138,7 +147,9 @@ def _run_demo() -> int:
         return 1
 
     print(f"\nAnswer:\n  {result.answer}\n")
-    print(f"Confidence: {result.confidence:.2%} | attempts: {result.attempts} | cost: ${result.cost:.4f}")
+    print(
+        f"Confidence: {result.confidence:.2%} | attempts: {result.attempts} | cost: ${result.cost:.4f}"
+    )
 
     if result.intermediate_steps:
         print("\nIntermediate steps (queries tried):")
@@ -153,7 +164,9 @@ def _run_demo() -> int:
 def main() -> int:
     import logging
 
-    logging.getLogger("ragfallback.strategies.query_variations").setLevel(logging.CRITICAL)
+    logging.getLogger("ragfallback.strategies.query_variations").setLevel(
+        logging.CRITICAL
+    )
     with warnings.catch_warnings():
         warnings.simplefilter("ignore")
         return _run_demo()

{ragfallback-2.2.1 → ragfallback-2.2.3}/examples/ci_regression_gate.py

@@ -158,14 +158,16 @@ async def run_gate() -> int:
     print(
         f"  Comparing against baseline (recorded: {baseline.get('recorded_at', 'unknown')})"
     )
-    print("  Threshold: 5% quality metrics; latency not gated (CI runners too noisy) → FAIL")
+    print(
+        "  Threshold: 5% quality metrics; latency not gated (CI runners too noisy) → FAIL"
+    )
 
     try:
         registry.compare_or_fail(
             report,
             dataset=dataset_name,
             threshold=0.05,
-            latency_threshold=5.0,   # 500% — P95 latency varies wildly on GH Actions shared runners
+            latency_threshold=5.0,  # 500% — P95 latency varies wildly on GH Actions shared runners
         )
         registry.update(report, dataset=dataset_name)
         print("\n  RESULT: PASS ✓ — No regression detected")

{ragfallback-2.2.1 → ragfallback-2.2.3}/examples/financial_risk_analysis.py

@@ -13,11 +13,14 @@ Env vars     : NONE required for retrieval demo; HF_TOKEN optional for LLM
 
 from __future__ import annotations
 
-import sys
 import os
+import sys
 
 _repo_root = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
-if os.path.isdir(os.path.join(_repo_root, "ragfallback")) and _repo_root not in sys.path:
+if (
+    os.path.isdir(os.path.join(_repo_root, "ragfallback"))
+    and _repo_root not in sys.path
+):
     sys.path.insert(0, _repo_root)
 
 _examples_dir = os.path.dirname(os.path.abspath(__file__))
@@ -66,7 +69,9 @@ def main() -> None:
 
     checker = ChunkQualityChecker(min_chars=40)
     report = checker.check(documents)
-    print(f"\nChunkQualityChecker: {report.n_chunks} sentences  Violations: {len(report.violations)}")
+    print(
+        f"\nChunkQualityChecker: {report.n_chunks} sentences  Violations: {len(report.violations)}"
+    )
 
     import _kb_common
 
@@ -96,7 +101,9 @@ def main() -> None:
         print(f"     → {best}...")
 
     print("\n✅ Financial RAG demo complete (no paid API keys used).")
-    print("   To add LLM generation: set HF_TOKEN env var and pass an LLM to AdaptiveRAGRetriever.")
+    print(
+        "   To add LLM generation: set HF_TOKEN env var and pass an LLM to AdaptiveRAGRetriever."
+    )
 
 
 if __name__ == "__main__":

{ragfallback-2.2.1 → ragfallback-2.2.3}/examples/legal_document_analysis.py

@@ -13,11 +13,14 @@ Env vars     : NONE required
 
 from __future__ import annotations
 
-import sys
 import os
+import sys
 
 _repo_root = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
-if os.path.isdir(os.path.join(_repo_root, "ragfallback")) and _repo_root not in sys.path:
+if (
+    os.path.isdir(os.path.join(_repo_root, "ragfallback"))
+    and _repo_root not in sys.path
+):
     sys.path.insert(0, _repo_root)
 
 _examples_dir = os.path.dirname(os.path.abspath(__file__))
@@ -53,12 +56,20 @@ def main() -> None:
     for row in ds:
         ctx = (row.get("context") or "").strip()
         if ctx and ctx not in seen and len(ctx) > 100:
-            documents.append(Document(
-                page_content=ctx[:600],
-                metadata={"source": "cuad_contract", "title": str(row.get("title", ""))},
-            ))
+            documents.append(
+                Document(
+                    page_content=ctx[:600],
+                    metadata={
+                        "source": "cuad_contract",
+                        "title": str(row.get("title", "")),
+                    },
+                )
+            )
             seen.add(ctx)
-        if row.get("question") and test_question == "What are the termination conditions?":
+        if (
+            row.get("question")
+            and test_question == "What are the termination conditions?"
+        ):
             test_question = row["question"]
         if len(documents) >= 60:
             break
@@ -75,7 +86,9 @@ def main() -> None:
 
     checker = ChunkQualityChecker(min_chars=80)
     report = checker.check(documents)
-    print(f"\nChunkQualityChecker: {report.n_chunks} clauses  Violations: {len(report.violations)}")
+    print(
+        f"\nChunkQualityChecker: {report.n_chunks} clauses  Violations: {len(report.violations)}"
+    )
 
     import _kb_common
 

{ragfallback-2.2.1 → ragfallback-2.2.3}/examples/medical_research_synthesis.py

@@ -13,11 +13,14 @@ Env vars     : NONE required
 
 from __future__ import annotations
 
-import sys
 import os
+import sys
 
 _repo_root = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
-if os.path.isdir(os.path.join(_repo_root, "ragfallback")) and _repo_root not in sys.path:
+if (
+    os.path.isdir(os.path.join(_repo_root, "ragfallback"))
+    and _repo_root not in sys.path
+):
     sys.path.insert(0, _repo_root)
 
 _examples_dir = os.path.dirname(os.path.abspath(__file__))
@@ -53,10 +56,12 @@ def main() -> None:
         ctx_list = (row.get("context") or {}).get("contexts") or []
         for ctx in ctx_list:
             if ctx and len(ctx) > 100:
-                documents.append(Document(
-                    page_content=ctx[:600],
-                    metadata={"source": "pubmed"},
-                ))
+                documents.append(
+                    Document(
+                        page_content=ctx[:600],
+                        metadata={"source": "pubmed"},
+                    )
+                )
         if row.get("question"):
             test_questions.append(row["question"])
         if len(documents) >= 60:
@@ -66,7 +71,9 @@ def main() -> None:
         print("SKIP: No usable abstract segments loaded from dataset")
         sys.exit(0)
 
-    test_question = test_questions[0] if test_questions else "What are the treatment outcomes?"
+    test_question = (
+        test_questions[0] if test_questions else "What are the treatment outcomes?"
+    )
 
     print(f"  Loaded {len(documents)} real PubMed abstract segments")
     print(f"  Example: {documents[0].page_content[:100]}...")
@@ -76,7 +83,9 @@ def main() -> None:
 
     checker = ChunkQualityChecker(min_chars=80)
     report = checker.check(documents)
-    print(f"\nChunkQualityChecker: {report.n_chunks} segments  Violations: {len(report.violations)}")
+    print(
+        f"\nChunkQualityChecker: {report.n_chunks} segments  Violations: {len(report.violations)}"
+    )
 
     import _kb_common
 
@@ -93,7 +102,11 @@ def main() -> None:
     print(f"  Indexed {len(documents)} real abstract segments")
 
     print("\nRetrieval demo (no LLM required)...")
-    questions = [test_question, "What are the side effects?", "What does the study conclude?"]
+    questions = [
+        test_question,
+        "What are the side effects?",
+        "What does the study conclude?",
+    ]
     retriever = vs.as_retriever(search_kwargs={"k": 3})
     for q in questions[:2]:
         hits = retriever.invoke(q)

{ragfallback-2.2.1 → ragfallback-2.2.3}/examples/real_data_demo.py

@@ -16,8 +16,8 @@ Env vars     : NONE required
 
 from __future__ import annotations
 
-import sys
 import os
+import sys
 from pathlib import Path
 
 # Allow running directly from a repository clone without pip install -e .
@@ -86,10 +86,7 @@ def main() -> None:
     from ragfallback.diagnostics import RetrievalHealthCheck
 
     # SQuAD answers are spans within context, so substring match is the correct check
-    probe_dict = {
-        p["question"]: p["ground_truth"][:60]
-        for p in probes[:20]
-    }
+    probe_dict = {p["question"]: p["ground_truth"][:60] for p in probes[:20]}
     health_checker = RetrievalHealthCheck(k=4)
     health_report = health_checker.run_substring_probes(
         store,

{ragfallback-2.2.1 → ragfallback-2.2.3}/examples/uc10_metadata_sanitizer.py

@@ -26,8 +26,9 @@ _examples_dir = Path(__file__).resolve().parent
 if str(_examples_dir) not in sys.path:
     sys.path.insert(0, str(_examples_dir))
 
-from langchain_core.documents import Document  # noqa: E402
 import _kb_common  # noqa: E402
+from langchain_core.documents import Document  # noqa: E402
+
 from ragfallback.diagnostics import sanitize_documents  # noqa: E402
 
 
@@ -47,7 +48,11 @@ def main() -> None:
         Document(
             page_content="Python lists are mutable ordered sequences of elements.",
             metadata={
-                "tags": ["python", "data-structures", "lists"],  # list — rejected by Chroma
+                "tags": [
+                    "python",
+                    "data-structures",
+                    "lists",
+                ],  # list — rejected by Chroma
                 "score": 0.95,
                 "source": "python_guide.txt",
             },
@@ -55,15 +60,18 @@ def main() -> None:
         Document(
             page_content="Dictionaries map hashable keys to arbitrary values.",
             metadata={
-                "nested": {"author": "Jane Doe", "year": 2023},  # nested dict — rejected
-                "raw_bytes": b"binary content here",              # bytes — rejected
+                "nested": {
+                    "author": "Jane Doe",
+                    "year": 2023,
+                },  # nested dict — rejected
+                "raw_bytes": b"binary content here",  # bytes — rejected
                 "source": "python_guide.txt",
             },
         ),
         Document(
             page_content="Functions are defined with the def keyword and return values.",
             metadata={
-                "page": None,        # None — handled inconsistently across stores
+                "page": None,  # None — handled inconsistently across stores
                 "reviewed": True,
                 "source": "python_guide.txt",
             },
@@ -98,10 +106,12 @@ def main() -> None:
     )
     results = vs_clean.similarity_search("What are Python lists?", k=2)
     print(f"  Inserted {len(clean_docs)} docs. Retrieved {len(results)} result(s). ✓")
-    print(f"\n  Metadata sanitized: {len(clean_docs)} document(s) ready for any vector store.")
+    print(
+        f"\n  Metadata sanitized: {len(clean_docs)} document(s) ready for any vector store."
+    )
 
     print("\nKey transformations applied by sanitize_documents():")
-    print("  list / tuple  → JSON string  (e.g. '[\"python\", \"lists\"]')")
+    print('  list / tuple  → JSON string  (e.g. \'["python", "lists"]\')')
     print("  dict          → flattened keys with dot notation  (nested.key → value)")
     print("  bytes         → UTF-8 decoded string")
     print("  None          → preserved as None (most stores handle scalar None)")

{ragfallback-2.2.1 → ragfallback-2.2.3}/examples/uc1_retrieval_health.py

@@ -15,13 +15,16 @@ import tempfile
 from pathlib import Path
 
 import _kb_common
+
 from ragfallback.diagnostics import RetrievalHealthCheck
 
 
 def main() -> None:
     docs = _kb_common.load_sample_kb()
     persist = Path(tempfile.mkdtemp(prefix="ragfallback_uc1_")) / "chroma"
-    vs = _kb_common.build_chroma_store(docs, persist_directory=persist, collection_name="uc1")
+    vs = _kb_common.build_chroma_store(
+        docs, persist_directory=persist, collection_name="uc1"
+    )
     health = RetrievalHealthCheck(k=4)
     report = health.quick_check(vs, docs, sample_size=min(10, len(docs)), seed=42)
     print(report.summary())

{ragfallback-2.2.1 → ragfallback-2.2.3}/examples/uc2_embedding_guard.py

@@ -12,6 +12,7 @@ Env vars     : NONE required
 from __future__ import annotations
 
 import _kb_common
+
 from ragfallback.diagnostics import EmbeddingGuard
 
 

{ragfallback-2.2.1 → ragfallback-2.2.3}/examples/uc3_chunk_quality.py

@@ -30,6 +30,7 @@ if str(_examples_dir) not in sys.path:
     sys.path.insert(0, str(_examples_dir))
 
 import _kb_common  # noqa: E402
+
 from ragfallback.diagnostics import ChunkQualityChecker  # noqa: E402
 
 
@@ -67,9 +68,9 @@ def main() -> None:
 
     print("\nRunning ChunkQualityChecker with production thresholds...")
     checker = ChunkQualityChecker(
-        min_chars=80,          # flag anything shorter than a sentence
-        max_chars=4000,        # flag unusually long passages
-        min_words=8,           # flag stubs
+        min_chars=80,  # flag anything shorter than a sentence
+        max_chars=4000,  # flag unusually long passages
+        min_words=8,  # flag stubs
     )
     report = checker.check(texts)
     print(report.summary())
@@ -96,9 +97,9 @@ def main() -> None:
         # Inject a synthetic bad chunk to demonstrate the detection path
         print("\n  Injecting 3 synthetic bad chunks to demonstrate detection...")
         synthetic_bad = texts + [
-            "Too short.",                           # 10 chars
-            "incomplete sentence that just cuts",   # 34 chars, no period
-            texts[0][:50] + " " + texts[0][:50],   # near-duplicate
+            "Too short.",  # 10 chars
+            "incomplete sentence that just cuts",  # 34 chars, no period
+            texts[0][:50] + " " + texts[0][:50],  # near-duplicate
         ]
         bad_report = checker.check(synthetic_bad)
         print(f"  After injection: {bad_report.summary()}")
@@ -128,7 +129,9 @@ def main() -> None:
         print("  Re-check: 0 violations after auto_fix ✓")
     else:
         remaining = len(fixed_report.violations)
-        print(f"  Re-check: {remaining} violation(s) remain (auto_fix is conservative by design)")
+        print(
+            f"  Re-check: {remaining} violation(s) remain (auto_fix is conservative by design)"
+        )
 
     print("\n✅  UC-3 demo complete.")
     print("    Dataset: SQuAD (Wikipedia) — CC BY-SA 4.0")

{ragfallback-2.2.1 → ragfallback-2.2.3}/examples/uc4_context_window.py

@@ -15,13 +15,16 @@ import tempfile
 from pathlib import Path
 
 import _kb_common
+
 from ragfallback.diagnostics import ContextWindowGuard
 
 
 def main() -> None:
     docs = _kb_common.load_sample_kb()
     persist = Path(tempfile.mkdtemp(prefix="ragfallback_uc4_")) / "chroma"
-    vs = _kb_common.build_chroma_store(docs, persist_directory=persist, collection_name="uc4")
+    vs = _kb_common.build_chroma_store(
+        docs, persist_directory=persist, collection_name="uc4"
+    )
     emb = _kb_common.get_embeddings()
     q = "refund policy authentication"
     retrieved = vs.similarity_search(q, k=12)

{ragfallback-2.2.1 → ragfallback-2.2.3}/examples/uc5_hybrid_failover.py

@@ -25,7 +25,11 @@ if (_repo_root / "ragfallback").is_dir() and str(_repo_root) not in sys.path:
     sys.path.insert(0, str(_repo_root))
 
 import _kb_common  # noqa: E402
-from ragfallback.retrieval import FailoverRetriever, SmartThresholdHybridRetriever  # noqa: E402
+
+from ragfallback.retrieval import (  # noqa: E402
+    FailoverRetriever,
+    SmartThresholdHybridRetriever,
+)
 
 
 def demo_hybrid_bm25_fallback(docs, vs) -> None:
@@ -56,7 +60,9 @@ def demo_hybrid_bm25_fallback(docs, vs) -> None:
 
     # _dense_scores_are_weak is part of the public API — demonstrate it
     print(f"\n  _dense_scores_are_weak([])  → {hybrid._dense_scores_are_weak([])}")
-    print(f"  _dense_scores_are_weak([doc]) → {hybrid._dense_scores_are_weak(docs_out[:1])}")
+    print(
+        f"  _dense_scores_are_weak([doc]) → {hybrid._dense_scores_are_weak(docs_out[:1])}"
+    )
 
 
 def demo_failover_on_empty(vs) -> None:
@@ -65,6 +71,7 @@ def demo_failover_on_empty(vs) -> None:
 
     class EmptyRetriever:
         """Simulates a retriever that always returns nothing (e.g. index gap)."""
+
         def invoke(self, query: str):
             return []
 
@@ -76,8 +83,10 @@ def demo_failover_on_empty(vs) -> None:
     docs_out = fb.invoke(query)
     print(f"Results: {len(docs_out)} doc(s) from fallback")
     for d in docs_out:
-        print(f"  source={d.metadata.get('ragfallback_retrieval_source')!r}  "
-              f"text='{d.page_content[:60].replace(chr(10), ' ')}…'")
+        print(
+            f"  source={d.metadata.get('ragfallback_retrieval_source')!r}  "
+            f"text='{d.page_content[:60].replace(chr(10), ' ')}…'"
+        )
 
 
 def demo_failover_on_exception(vs) -> None:
@@ -86,6 +95,7 @@ def demo_failover_on_exception(vs) -> None:
 
     class BrokenRetriever:
         """Simulates a downed remote vector store."""
+
         def invoke(self, query: str):
             raise ConnectionError("Pinecone endpoint unreachable")
 
@@ -97,8 +107,10 @@ def demo_failover_on_exception(vs) -> None:
     docs_out = fb.invoke(query)
     print(f"Results: {len(docs_out)} doc(s) from fallback")
     for d in docs_out:
-        print(f"  source={d.metadata.get('ragfallback_retrieval_source')!r}  "
-              f"text='{d.page_content[:60].replace(chr(10), ' ')}…'")
+        print(
+            f"  source={d.metadata.get('ragfallback_retrieval_source')!r}  "
+            f"text='{d.page_content[:60].replace(chr(10), ' ')}…'"
+        )
 
 
 def demo_failover_min_results(vs) -> None:
@@ -116,8 +128,10 @@ def demo_failover_min_results(vs) -> None:
     docs_out = fb.invoke(query)
     print(f"Results: {len(docs_out)} doc(s)  (fallback returned more)")
     for d in docs_out:
-        print(f"  source={d.metadata.get('ragfallback_retrieval_source')!r}  "
-              f"text='{d.page_content[:60].replace(chr(10), ' ')}…'")
+        print(
+            f"  source={d.metadata.get('ragfallback_retrieval_source')!r}  "
+            f"text='{d.page_content[:60].replace(chr(10), ' ')}…'"
+        )
 
 
 def main() -> None:

{ragfallback-2.2.1 → ragfallback-2.2.3}/examples/uc6_adaptive_rag.py

@@ -31,11 +31,11 @@ if str(_examples_dir) not in sys.path:
     sys.path.insert(0, str(_examples_dir))
 
 import _kb_common  # noqa: E402
+
 from ragfallback import AdaptiveRAGRetriever  # noqa: E402
 from ragfallback.strategies import QueryVariationsStrategy  # noqa: E402
 from ragfallback.tracking import CostTracker, MetricsCollector  # noqa: E402
 
-
 # Pre-scripted variations for three demo queries. The mock cycles through
 # them deterministically so the retry chain is always visible even offline.
 _MOCK_VARIATIONS: dict[int, list[str]] = {
@@ -167,7 +167,9 @@ def main() -> None:
                 print(f"  → attempt {attempt}: '{query}...'  confidence={conf:.0%}")
 
         print(f"  Final answer : {(result.answer or 'Not found')[:120]}")
-        print(f"  Succeeded at : attempt {result.attempts}  confidence={result.confidence:.0%}")
+        print(
+            f"  Succeeded at : attempt {result.attempts}  confidence={result.confidence:.0%}"
+        )
         if result.cost == 0.0:
             print(f"  Cost         : $0.0000 (mock LLM — no real inference)")
         else:
@@ -175,9 +177,11 @@ def main() -> None:
 
     stats = adaptive.metrics_collector.get_stats()
     print("\n" + "─" * 66)
-    print(f"Session stats: {stats['total_queries']} queries  "
-          f"success_rate={stats['success_rate']:.0%}  "
-          f"avg_confidence={stats['avg_confidence']:.0%}")
+    print(
+        f"Session stats: {stats['total_queries']} queries  "
+        f"success_rate={stats['success_rate']:.0%}  "
+        f"avg_confidence={stats['avg_confidence']:.0%}"
+    )
 
     if llm.__class__.__name__ == "MagicMock":
         print(