blopus 0.3.2__tar.gz → 0.3.3__tar.gz

{blopus-0.3.2 → blopus-0.3.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: blopus
-Version: 0.3.2
+Version: 0.3.3
 Summary: Official Python SDK for the Blopus web search + fetch API.
 Author: Blopus
 License: MIT

{blopus-0.3.2 → blopus-0.3.3}/blopus/_async.py

@@ -93,6 +93,9 @@ class AsyncBlopus:
         include_excerpt: bool = False,
         excerpt_chars: Optional[int] = None,
         news_only: bool = False,
+        recency: Optional[str] = None,
+        include_content: bool = False,
+        content_chars: Optional[int] = None,
     ) -> SearchResponse:
         """Run a web search. Always costs 1 credit regardless of params.
 
@@ -120,6 +123,9 @@ class AsyncBlopus:
             include_excerpt=include_excerpt,
             excerpt_chars=excerpt_chars,
             news_only=news_only,
+            recency=recency,
+            include_content=include_content,
+            content_chars=content_chars,
         )
         return SearchResponse.from_dict(await self._post("/v1/search", body))
 

{blopus-0.3.2 → blopus-0.3.3}/blopus/_common.py

@@ -110,6 +110,9 @@ def build_search_body(
     include_excerpt: bool = False,
     excerpt_chars: Optional[int] = None,
     news_only: bool = False,
+    recency: Optional[str] = None,
+    include_content: bool = False,
+    content_chars: Optional[int] = None,
 ) -> Dict[str, Any]:
     """Assemble the JSON body for ``POST /v1/search`` (omitting unset optionals)."""
     body: Dict[str, Any] = {
@@ -132,6 +135,14 @@ def build_search_body(
         body["include_excerpt"] = True
     if excerpt_chars is not None:
         body["excerpt_chars"] = excerpt_chars
+    # recency changes RANKING; freshness FILTERS. Sent only when set, so the server
+    # default ("normal") stays authoritative.
+    if recency is not None:
+        body["recency"] = recency
+    if include_content:
+        body["include_content"] = True
+    if content_chars is not None:
+        body["content_chars"] = content_chars
     if news_only:
         # only send it when true — an older gateway would 422 on an unknown field
         body["news_only"] = True

{blopus-0.3.2 → blopus-0.3.3}/blopus/_version.py

@@ -5,4 +5,4 @@ header, so a correct value here is what keeps Cloudflare from 1010-blocking
 requests as an unidentified library.
 """
 
-__version__ = "0.3.2"
+__version__ = "0.3.3"

{blopus-0.3.2 → blopus-0.3.3}/blopus/cli.py

@@ -175,6 +175,12 @@ def _cmd_search(args: argparse.Namespace) -> int:
         language=args.language,
         offset=args.offset,
         include_excerpt=args.include_excerpt,
+        excerpt_chars=args.excerpt_chars,
+        start_date=args.start_date,
+        end_date=args.end_date,
+        recency=args.recency,
+        include_content=args.include_content,
+        content_chars=args.content_chars,
     )
     if args.json:
         print(json.dumps(res.raw, indent=2, ensure_ascii=False))
@@ -184,7 +190,9 @@ def _cmd_search(args: argparse.Namespace) -> int:
         for i, r in enumerate(res.results, 1):
             print(f"{i}. {r.title}")
             print(f"   {r.url}")
-            if r.snippet:
+            if r.content:
+                print(f"   {r.content}")
+            elif r.snippet:
                 print(f"   {r.snippet}")
             print()
         if res.remaining_quota is not None:
@@ -298,6 +306,20 @@ def build_parser() -> argparse.ArgumentParser:
                    help="Skip N results for pagination (0-200).")
     s.add_argument("--include-excerpt", action="store_true",
                    help="Return a longer excerpt per result (skips a separate fetch).")
+    s.add_argument("--recency", default=None, choices=["normal", "relaxed", "off"],
+                   help="Ranking preference, not a filter. 'off' for timeless questions "
+                        "where the best answer may be months old.")
+    s.add_argument("--start-date", default=None, metavar="DATE",
+                   help="Window start: YYYY-MM-DD or epoch seconds.")
+    s.add_argument("--end-date", default=None, metavar="DATE",
+                   help="Window end: YYYY-MM-DD or epoch seconds.")
+    s.add_argument("--excerpt-chars", type=int, default=None, metavar="N",
+                   help="Excerpt length when --include-excerpt is set.")
+    s.add_argument("--include-content", action="store_true",
+                   help="Return full text inline instead of a snippet. Costs the same as "
+                        "the search, so it beats fetching each result separately.")
+    s.add_argument("--content-chars", type=int, default=None, metavar="N",
+                   help="Cap inline content length per result.")
     s.add_argument("--json", action="store_true", help="Emit raw JSON instead of text.")
     s.set_defaults(func=_cmd_search)
 

{blopus-0.3.2 → blopus-0.3.3}/blopus/client.py

@@ -105,6 +105,9 @@ class Blopus:
         include_excerpt: bool = False,
         excerpt_chars: Optional[int] = None,
         news_only: bool = False,
+        recency: Optional[str] = None,
+        include_content: bool = False,
+        content_chars: Optional[int] = None,
     ) -> SearchResponse:
         """Run a web search. Always costs 1 credit regardless of params.
 
@@ -132,6 +135,9 @@ class Blopus:
             include_excerpt=include_excerpt,
             excerpt_chars=excerpt_chars,
             news_only=news_only,
+            recency=recency,
+            include_content=include_content,
+            content_chars=content_chars,
         )
         return SearchResponse.from_dict(self._post("/v1/search", body))
 

{blopus-0.3.2 → blopus-0.3.3}/blopus/crewai.py

@@ -34,8 +34,16 @@ def BlopusSearchTool(
     client: Optional[Blopus] = None,
     count: int = 10,
     freshness: str = "all",
+    news_only: bool = False,
+    **search_kwargs,
 ):
-    """Return a CrewAI ``BaseTool`` backed by ``Blopus.search``."""
+    """Return a CrewAI ``BaseTool`` backed by ``Blopus.search``.
+
+    ``news_only`` and any other :meth:`Blopus.search` keyword are accepted so this
+    adapter is not the odd one out — the LangChain and LlamaIndex wrappers already
+    take them, and a parameter missing from one framework's wrapper is a parameter
+    that framework's users cannot reach.
+    """
     BaseTool, BaseModel, Field = _requirements()
     _client = client or Blopus(api_key=api_key)
 
@@ -51,7 +59,8 @@ def BlopusSearchTool(
         args_schema: type = _Schema
 
         def _run(self, query: str) -> str:
-            res = _client.search(query, count=count, freshness=freshness)
+            res = _client.search(query, count=count, freshness=freshness,
+                                 news_only=news_only, **search_kwargs)
             if not res.results:
                 return "No results."
             return "\n".join(

{blopus-0.3.2 → blopus-0.3.3}/blopus/llamaindex.py

@@ -39,6 +39,7 @@ def BlopusToolSpec(
     count: int = 10,
     freshness: str = "all",
     news_only: bool = False,
+    **search_kwargs,
 ):
     """Return a LlamaIndex tool spec exposing Blopus ``search`` and ``fetch``.
 
@@ -55,7 +56,7 @@ def BlopusToolSpec(
         def blopus_search(self, query: str) -> List[dict]:
             """Search the web. Returns a list of {title, url, snippet, score} results."""
             res = _client.search(query, count=count, freshness=freshness,
-                                 news_only=news_only)
+                                 news_only=news_only, **search_kwargs)
             return [
                 {"title": r.title, "url": r.url, "snippet": r.snippet, "score": r.score}
                 for r in res.results

{blopus-0.3.2 → blopus-0.3.3}/blopus/models.py

@@ -41,6 +41,12 @@ class SearchResult:
     age_seconds: Optional[int] = None
     language: Optional[str] = None
     score: Optional[float] = None
+    #: Crawl time. ``published_at`` falls back to this when the article date is unknown.
+    fetched_at: Optional[int] = None
+    #: How many near-identical pages were collapsed into this hit.
+    duplicate_count: int = 0
+    #: Full text. Present only when the request set ``include_content``.
+    content: Optional[str] = None
     raw: Dict[str, Any] = field(default_factory=dict, repr=False)
 
     @classmethod
@@ -56,6 +62,10 @@ class SearchResult:
             age_seconds=_as_int(d.get("age_seconds")),
             language=d.get("language"),
             score=_as_float(d.get("score")),
+            fetched_at=_as_int(d.get("fetched_at")),
+            duplicate_count=_as_int(d.get("duplicate_count")) or 0,
+            # only present when include_content was requested
+            content=d.get("content"),
             raw=d,
         )
 

{blopus-0.3.2 → blopus-0.3.3}/blopus.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: blopus
-Version: 0.3.2
+Version: 0.3.3
 Summary: Official Python SDK for the Blopus web search + fetch API.
 Author: Blopus
 License: MIT

{blopus-0.3.2 → blopus-0.3.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "blopus"
-version = "0.3.2"
+version = "0.3.3"
 description = "Official Python SDK for the Blopus web search + fetch API."
 readme = "README.md"
 requires-python = ">=3.8"