nosible 0.2.4__py3-none-any.whl → 0.2.6__py3-none-any.whl

{nosible-0.2.4.dist-info → nosible-0.2.6.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nosible
-Version: 0.2.4
+Version: 0.2.6
 Summary: Python client for the NOSIBLE Search API
 Home-page: https://github.com/NosibleAI/nosible
 Author: Stuart Reid, Matthew Dicks, Richard Taylor, Gareth Warburton
@@ -132,11 +132,11 @@ os.environ["LLM_API_KEY"] = "sk-..."
 
 ### 🎯 Core Workflows
 
-| I need                          | Method        | Use case                |
-|---------------------------------|---------------|-------------------------|
-| Single query, up to 100 results | `search`      | Interactive lookups     |
-| Multiple queries in parallel    | `searches`    | Dashboards, comparisons |
-| Thousands of results (100–10k)  | `bulk_search` | Analytics, offline jobs |
+| I need                          | Method          | Use case                |
+|---------------------------------|-----------------|-------------------------|
+| Single query, up to 100 results | `fast-search`   | Interactive lookups     |
+| Multiple queries in parallel    | `fast-searches` | Dashboards, comparisons |
+| Thousands of results (100–10k)  | `bulk_search`   | Analytics, offline jobs |
 
 
 ### 🚀 Examples
@@ -172,17 +172,16 @@ with Nosible(
     llm_api_key="sk-...",
     openai_base_url="https://api.openrouter.ai/v1"
 ) as client:
-    results = client.search(
+    results = client.fast_search(
         question="What are the terms of the partnership between Microsoft and OpenAI?",
         n_results=20,
+        language="en",
         publish_start="2020-06-01",
         publish_end="2025-06-30",
-        include_netlocs=["nytimes.com", "techcrunch.com"],
-        exclude_netlocs=["example.com"],
         visited_start="2023-06-01",
         visited_end="2025-06-29",
-        include_languages=["en", "fr"],
-        exclude_languages=["de"],
+        include_netlocs=["nytimes.com", "techcrunch.com"],
+        exclude_netlocs=["example.com"],
         include_companies=["/m/04sv4"],  # Microsoft's GKID
         exclude_companies=["/m/045c7b"]  # Google GKID
     )
@@ -203,7 +202,7 @@ with Nosible(
 ```python
 # Example of using your own expansions
 with Nosible() as nos:
-    results = nos.search(
+    results = nos.fast_search(
         question="How have the Trump tariffs impacted the US economy?",
         expansions=[
             "What are the consequences of Trump's 2018 steel and aluminum tariffs on American manufacturers?",
@@ -232,7 +231,7 @@ Allows you to run multiple searches concurrently and `yields` the results as the
 from nosible import Nosible
 
 with Nosible(nosible_api_key="basic|abcd1234...", llm_api_key="sk-...") as client:
-    for batch in client.searches(
+    for batch in client.fast_searches(
         questions=[
             "What are the terms of the partnership between Microsoft and OpenAI?",
             "What exclusivity or non-compete clauses are included in their partnership?"
@@ -249,7 +248,7 @@ Bulk search enables you to retrieve a large number of results in a single reques
 
 - Use the `bulk_search` method when you need more than 1,000 results for a single query.
 - You can request between **1,000 and 10,000** results per query.
-- All parameters available in the standard `search` method—such as `expansions`, `include_companies`, `include_languages`, and more—are also supported in `bulk_search`.
+- All parameters available in the standard `search` method—such as `expansions`, `include_companies`, and more—are also supported in `bulk_search`.
 - A bulk search for 10,000 results typically completes in about 30 seconds or less.
 
 ```python
@@ -272,11 +271,11 @@ Add two ResultSets together:
 from nosible import Nosible
 
 with Nosible(nosible_api_key="basic|abcd1234...") as client:
-    r1 = client.search(
+    r1 = client.fast_search(
         question="What are the terms of the partnership between Microsoft and OpenAI?",
         n_results=5
     )
-    r2 = client.search(
+    r2 = client.fast_search(
         question="How is research governance and decision-making structured between Google and DeepMind?",
         n_results=5
     )
@@ -300,7 +299,7 @@ with Nosible(nosible_api_key="basic|abcd1234...") as client:
         include_netlocs=["arxiv.org", "bbc.com"],
         certain=True
     )
-    results = client.search(search=search)
+    results = client.fast_search(search=search)
     print([r for r in results])
 ```
 
@@ -317,7 +316,7 @@ This fetches a sentiment score for each search result.
 from nosible import Nosible
 
 with Nosible(nosible_api_key="basic|abcd1234...", llm_api_key="sk-...") as client:
-    results = client.search(
+    results = client.fast_search(
         question="What are the terms of the partnership between Microsoft and OpenAI?",
         n_results=1
     )
@@ -333,29 +332,29 @@ Supported formats for saving and loading:
 from nosible import Nosible, ResultSet
 
 with Nosible(nosible_api_key="basic|abcd1234...") as client:
-    combined = client.search(
-        question="What are the terms of the partnership between Microsoft and OpenAI?",
-        n_results=5
-    ) + client.search(
-        question="How is research governance and decision-making structured between Google and DeepMind?",
-        n_results=5
-    )
-
-    # Save
-    combined.to_csv("all_news.csv")
-    combined.to_json("all_news.json")
-    combined.to_parquet("all_news.parquet")
-    combined.to_arrow("all_news.arrow")
-    combined.to_duckdb("all_news.duckdb", table_name="news")
-    combined.to_ndjson("all_news.ndjson")
-
-    # Load
-    rs_csv    = ResultSet.from_csv("all_news.csv")
-    rs_json   = ResultSet.from_json("all_news.json")
-    rs_parq   = ResultSet.from_parquet("all_news.parquet")
-    rs_arrow  = ResultSet.from_arrow("all_news.arrow")
-    rs_duckdb = ResultSet.from_duckdb("all_news.duckdb")
-    rs_ndjson = ResultSet.from_ndjson("all_news.ndjson")
+  combined = client.fast_search(
+    question="What are the terms of the partnership between Microsoft and OpenAI?",
+    n_results=5
+  ) + client.fast_search(
+    question="How is research governance and decision-making structured between Google and DeepMind?",
+    n_results=5
+  )
+
+  # Save
+  combined.write_csv("all_news.csv")
+  combined.write_json("all_news.json")
+  combined.write_parquet("all_news.parquet")
+  combined.write_ipc("all_news.arrow")
+  combined.write_duckdb("all_news.duckdb", table_name="news")
+  combined.write_ndjson("all_news.ndjson")
+
+  # Load
+  rs_csv = ResultSet.read_csv("all_news.csv")
+  rs_json = ResultSet.read_json("all_news.json")
+  rs_parq = ResultSet.read_parquet("all_news.parquet")
+  rs_arrow = ResultSet.read_ipc("all_news.arrow")
+  rs_duckdb = ResultSet.read_duckdb("all_news.duckdb")
+  rs_ndjson = ResultSet.read_ndjson("all_news.ndjson")
 ```
 
 #### More Examples

nosible-0.2.6.dist-info/RECORD

@@ -0,0 +1,16 @@
+nosible/__init__.py,sha256=11QmG9Wjprp_zB0VnPxGjqKwHmaoB0hoT8AGO6cGVMM,1426
+nosible/nosible_client.py,sha256=OO8ibqdtnhs49985XMKzAfZHLLUJfYvyLsipw82ABqQ,94565
+nosible/classes/result.py,sha256=htOK8NcCImguiQNIFe9kr3PYCtq46RSuB82-BzAgMbY,22762
+nosible/classes/result_set.py,sha256=uQ9oeD2nqYTE1dGetkhkfqmPmuvxmRyVILfeHxSkT1E,53138
+nosible/classes/search.py,sha256=VrpuAsS4pxcirR6l6WStJN0gPIfahZ_9Cx3YdNKczSw,13860
+nosible/classes/search_set.py,sha256=VvtKXQ1_Ws_W-0p0C-wUvvdskeuXAyr65tpfvexAVw0,9895
+nosible/classes/snippet.py,sha256=m2qxgnMxIxx4ZOIMqUAViGLf7C1Y4NCGaioyEKw2-Zg,4994
+nosible/classes/snippet_set.py,sha256=0jPMDhJNCO02WhvY1QR1HedvADvBxRcN6x3FItEgSiI,5099
+nosible/classes/web_page.py,sha256=cvwQspxS0pU2nFgPLqnDtDWlLONHp1KwxerflHueLJ8,5838
+nosible/utils/json_tools.py,sha256=PcSMjcLEhbA626jAIn0SuD_1-4QDduapZUenTSt3N2E,4569
+nosible/utils/rate_limiter.py,sha256=qr0Tg-3wVcw95FyQv3gbZhbf-_QY9zKdkIE4FSLFSBo,5400
+nosible-0.2.6.dist-info/licenses/LICENSE,sha256=8ifsV4DrsiKi8KVBFy8SBb3KXPXhofE3pYq07q1TSCQ,1117
+nosible-0.2.6.dist-info/METADATA,sha256=e6mQsT0-MVRzBZ2RXnhwyRrI31EQ3zOrJBVnTiDE93I,14796
+nosible-0.2.6.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+nosible-0.2.6.dist-info/top_level.txt,sha256=mOconHuKcNJ1jTAj3DapQP_xB8YOmjTMyHg5txKH3uA,8
+nosible-0.2.6.dist-info/RECORD,,

nosible-0.2.4.dist-info/RECORD

@@ -1,16 +0,0 @@
-nosible/__init__.py,sha256=11QmG9Wjprp_zB0VnPxGjqKwHmaoB0hoT8AGO6cGVMM,1426
-nosible/nosible_client.py,sha256=KgkdUofTNeARvHmL3hquPIgPtVHnNhiplBpMkPJYrrY,82214
-nosible/classes/result.py,sha256=JQEmJqy48cvEnT2gchIf3HhyGY1ICDfb4xplWfDoVrY,17652
-nosible/classes/result_set.py,sha256=badc0q8rlvgUQ36ZrNgSY5O40lIvyZsCChtpnoCM5jk,52813
-nosible/classes/search.py,sha256=_RDH8ih75RufztOG7NUJuZ1ncNV3jNThq8ST41VP0fU,11269
-nosible/classes/search_set.py,sha256=4L2qO_IKqlUebvxNJERxjXNiUKtolw7JhgFtt1QqEHk,9790
-nosible/classes/snippet.py,sha256=5Av0cXjOL-8X6H8oFunC36DUyWiFLLsl7FfPJ7cYwVU,4988
-nosible/classes/snippet_set.py,sha256=1SZUEq6zRcBT3N8BKbFPml5pt_WSCybIjMpTw8PTz4E,5093
-nosible/classes/web_page.py,sha256=fe-cfDL-AmQRMdBO37jWh1K6BsH_K_VWBBfBzFRV3KM,7149
-nosible/utils/json_tools.py,sha256=PcSMjcLEhbA626jAIn0SuD_1-4QDduapZUenTSt3N2E,4569
-nosible/utils/rate_limiter.py,sha256=qr0Tg-3wVcw95FyQv3gbZhbf-_QY9zKdkIE4FSLFSBo,5400
-nosible-0.2.4.dist-info/licenses/LICENSE,sha256=8ifsV4DrsiKi8KVBFy8SBb3KXPXhofE3pYq07q1TSCQ,1117
-nosible-0.2.4.dist-info/METADATA,sha256=zQh03i9LjKKddVkV5z-yuJdcq1MB-4AAVpywgMmv00M,14857
-nosible-0.2.4.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-nosible-0.2.4.dist-info/top_level.txt,sha256=mOconHuKcNJ1jTAj3DapQP_xB8YOmjTMyHg5txKH3uA,8
-nosible-0.2.4.dist-info/RECORD,,