blopus 0.3.0__tar.gz → 0.3.2__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: blopus
-Version: 0.3.0
+Version: 0.3.2
 Summary: Official Python SDK for the Blopus web search + fetch API.
 Author: Blopus
 License: MIT
@@ -60,9 +60,9 @@ pip install "blopus[crewai]"        # blopus.crewai.BlopusSearchTool
 
 Set `news_only=True` when the question is about **events** — what happened, who
 announced what, market reaction, election results, earnings news. It searches only
-sources with a real newsroom, from a dedicated index, so it is **faster** than an
-unscoped search and it drops vendor blogs, marketing pages and documentation that
-otherwise crowd news results.
+sources with a real newsroom, over a **dedicated news channel** that is **faster**
+than an unscoped search, and it drops the vendor blogs, marketing pages and
+documentation that otherwise crowd news results.
 
 ```python
 # events → scope it, and pair with a freshness window
@@ -124,7 +124,7 @@ client.search(
     query,
     count=10,                 # 1..50
     freshness="all",          # pd | pw | pm | p3m | p1y | all
-    news_only=False,          # True = newsroom sources only. FASTER (dedicated index) and
+    news_only=False,          # True = newsroom sources only. Faster dedicated news channel;
                               # drops vendor blogs/docs. Use it for events; leave it off for
                               # documentation, tutorials, forums — or when you want both.
     include_domains=None,     # ["techcrunch.com", ...]

{blopus-0.3.0 → blopus-0.3.2}/README.md

@@ -25,9 +25,9 @@ pip install "blopus[crewai]"        # blopus.crewai.BlopusSearchTool
 
 Set `news_only=True` when the question is about **events** — what happened, who
 announced what, market reaction, election results, earnings news. It searches only
-sources with a real newsroom, from a dedicated index, so it is **faster** than an
-unscoped search and it drops vendor blogs, marketing pages and documentation that
-otherwise crowd news results.
+sources with a real newsroom, over a **dedicated news channel** that is **faster**
+than an unscoped search, and it drops the vendor blogs, marketing pages and
+documentation that otherwise crowd news results.
 
 ```python
 # events → scope it, and pair with a freshness window
@@ -89,7 +89,7 @@ client.search(
     query,
     count=10,                 # 1..50
     freshness="all",          # pd | pw | pm | p3m | p1y | all
-    news_only=False,          # True = newsroom sources only. FASTER (dedicated index) and
+    news_only=False,          # True = newsroom sources only. Faster dedicated news channel;
                               # drops vendor blogs/docs. Use it for events; leave it off for
                               # documentation, tutorials, forums — or when you want both.
     include_domains=None,     # ["techcrunch.com", ...]

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

@@ -98,9 +98,9 @@ class AsyncBlopus:
 
         Set ``news_only=True`` when the question is about events — what happened,
         who announced what, market reaction, election results, earnings news. It
-        searches only sources with a newsroom, from a dedicated index, so it is
-        *faster* than an unscoped search and drops vendor blogs, marketing pages
-        and documentation that crowd news results.
+        searches only sources with a newsroom over a dedicated news channel, so it
+        is *faster* than an unscoped search, and drops vendor blogs, marketing
+        pages and documentation that crowd news results.
 
         Leave it off for documentation, tutorials, forums or reference material,
         and whenever a question wants both — "what's new in Python 3.14" needs the

{blopus-0.3.0 → blopus-0.3.2}/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.0"
+__version__ = "0.3.2"

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

@@ -54,6 +54,7 @@ Common commands:
   blopus login                                      save your API key (recommended)
   blopus whoami                                     show which key is active
   blopus search "who won the game" --freshness pd   search the live web
+  blopus search "what did the Fed announce" --news-only    events only (see search --help)
   blopus search "openai" --include-domains reuters.com,ft.com
   blopus search "langchain" --json                  raw JSON for scripts
   blopus fetch https://example.com/article          read one indexed page
@@ -168,6 +169,7 @@ def _cmd_search(args: argparse.Namespace) -> int:
         args.query,
         count=args.count,
         freshness=args.freshness,
+        news_only=args.news_only,
         include_domains=_csv(args.include_domains),
         exclude_domains=_csv(args.exclude_domains),
         language=args.language,
@@ -265,7 +267,12 @@ def build_parser() -> argparse.ArgumentParser:
         description="Search the live web and print ranked results (or JSON).",
         epilog=(
             'Examples:\n'
-            '  blopus search "spacex" --freshness pd --count 5\n'
+            '  # an event -- scope to newsrooms, add a freshness window if breaking\n'
+            '  blopus search "what did the Fed announce" --news-only --freshness pd\n'
+            '  # documentation -- leave --news-only off\n'
+            '  blopus search "kubernetes ingress example"\n'
+            '  # wants the announcement AND the changelog -- leave it off\n'
+            '  blopus search "what\'s new in Python 3.14"\n'
             '  blopus search "openai funding" --include-domains reuters.com,ft.com\n'
             '  blopus search "rust async" --json\n'))
     s.add_argument("query", help="What to search for.")
@@ -274,6 +281,13 @@ def build_parser() -> argparse.ArgumentParser:
     s.add_argument("--freshness", default="all",
                    choices=["pd", "pw", "pm", "p3m", "p1y", "all"],
                    help="Recency: pd=day, pw=week, pm=month, p3m=3mo, p1y=year, all (default).")
+    s.add_argument("--news-only", action="store_true",
+                   help="Search ONLY sources with a newsroom (newspapers, wires, "
+                        "broadcasters, magazines). Use it for events: what happened, who "
+                        "announced what, market reaction, election results, earnings news. "
+                        "Leave it off for documentation, tutorials, forums or reference "
+                        "material, and when a question wants both -- an unscoped search "
+                        "returns everything, so omitting it is never wrong.")
     s.add_argument("--include-domains", default=None, metavar="LIST",
                    help="Comma-separated hostnames to allow, e.g. reuters.com,ft.com.")
     s.add_argument("--exclude-domains", default=None, metavar="LIST",

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

@@ -110,9 +110,9 @@ class Blopus:
 
         Set ``news_only=True`` when the question is about events — what happened,
         who announced what, market reaction, election results, earnings news. It
-        searches only sources with a newsroom, from a dedicated index, so it is
-        *faster* than an unscoped search and drops vendor blogs, marketing pages
-        and documentation that crowd news results.
+        searches only sources with a newsroom over a dedicated news channel, so it
+        is *faster* than an unscoped search, and drops vendor blogs, marketing
+        pages and documentation that crowd news results.
 
         Leave it off for documentation, tutorials, forums or reference material,
         and whenever a question wants both — "what's new in Python 3.14" needs the

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: blopus
-Version: 0.3.0
+Version: 0.3.2
 Summary: Official Python SDK for the Blopus web search + fetch API.
 Author: Blopus
 License: MIT
@@ -60,9 +60,9 @@ pip install "blopus[crewai]"        # blopus.crewai.BlopusSearchTool
 
 Set `news_only=True` when the question is about **events** — what happened, who
 announced what, market reaction, election results, earnings news. It searches only
-sources with a real newsroom, from a dedicated index, so it is **faster** than an
-unscoped search and it drops vendor blogs, marketing pages and documentation that
-otherwise crowd news results.
+sources with a real newsroom, over a **dedicated news channel** that is **faster**
+than an unscoped search, and it drops the vendor blogs, marketing pages and
+documentation that otherwise crowd news results.
 
 ```python
 # events → scope it, and pair with a freshness window
@@ -124,7 +124,7 @@ client.search(
     query,
     count=10,                 # 1..50
     freshness="all",          # pd | pw | pm | p3m | p1y | all
-    news_only=False,          # True = newsroom sources only. FASTER (dedicated index) and
+    news_only=False,          # True = newsroom sources only. Faster dedicated news channel;
                               # drops vendor blogs/docs. Use it for events; leave it off for
                               # documentation, tutorials, forums — or when you want both.
     include_domains=None,     # ["techcrunch.com", ...]

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

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