nosible 0.2.5__tar.gz → 0.2.7__tar.gz

{nosible-0.2.5/src/nosible.egg-info → nosible-0.2.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nosible
-Version: 0.2.5
+Version: 0.2.7
 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

{nosible-0.2.5 → nosible-0.2.7}/README.md

@@ -89,11 +89,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

{nosible-0.2.5 → nosible-0.2.7}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "nosible"
-version = "0.2.5"
+version = "0.2.7"
 description = "Python client for the NOSIBLE Search API"
 readme = { file = "README.md", content-type = "text/markdown" }
 requires-python = ">=3.9"

{nosible-0.2.5 → nosible-0.2.7}/src/nosible/classes/result.py

@@ -408,6 +408,7 @@ class Result:
         iab_tier_2: str = None,
         iab_tier_3: str = None,
         iab_tier_4: str = None,
+        instruction: str = None,
         *args, **kwargs
     ) -> ResultSet:
         """
@@ -478,6 +479,8 @@ class Result:
             IAB Tier 3 category for the content.
         iab_tier_4 : str, optional
             IAB Tier 4 category for the content.
+        instruction : str, optional
+            Instruction to use with the search query.
 
         Returns
         -------
@@ -549,6 +552,7 @@ class Result:
                 iab_tier_2=iab_tier_2,
                 iab_tier_3=iab_tier_3,
                 iab_tier_4=iab_tier_4,
+                instruction=instruction,
             )
             return client.fast_search(search=s)
         except Exception as e:

{nosible-0.2.5 → nosible-0.2.7}/src/nosible/classes/search.py

@@ -89,6 +89,8 @@ class Search:
         IAB Tier 3 category for the content.
     iab_tier_4 : str, optional
         IAB Tier 4 category for the content.
+    instruction : str, optional
+        Instruction to use with the search query.
 
     Examples
     --------
@@ -176,6 +178,8 @@ class Search:
     """IAB Tier 3 category for the content."""
     iab_tier_4: str | None = None
     """IAB Tier 4 category for the content."""
+    instruction: str | None = None
+    """Instruction to use with the search query."""    
 
     _FIELDS = [
         "question",
@@ -213,6 +217,7 @@ class Search:
         "iab_tier_2",
         "iab_tier_3",
         "iab_tier_4",
+        "instruction",
     ]
 
     def __str__(self) -> str:

{nosible-0.2.5 → nosible-0.2.7}/src/nosible/nosible_client.py

@@ -108,6 +108,8 @@ class Nosible:
         IAB Tier 3 category for the content.
     iab_tier_4 : str, optional
         IAB Tier 4 category for the content.
+    instruction : str, optional
+        Instruction to use with the search query.
 
     Notes
     -----
@@ -159,6 +161,7 @@ class Nosible:
         iab_tier_2: str = None,
         iab_tier_3: str = None,
         iab_tier_4: str = None,
+        instruction: str = None,
         *args, **kwargs
     ) -> None:
 
@@ -256,6 +259,7 @@ class Nosible:
         self.iab_tier_2 = iab_tier_2
         self.iab_tier_3 = iab_tier_3
         self.iab_tier_4 = iab_tier_4
+        self.instruction = instruction
 
     def fast_search(
         self,
@@ -295,6 +299,7 @@ class Nosible:
         iab_tier_2: str = None,
         iab_tier_3: str = None,
         iab_tier_4: str = None,
+        instruction: str = None,
         *args, **kwargs
     ) -> ResultSet:
         """
@@ -377,6 +382,8 @@ class Nosible:
             IAB Tier 3 category for the content.
         iab_tier_4 : str, optional
             IAB Tier 4 category for the content.
+        instruction : str, optional
+            Instruction to use with the search query.
 
         Returns
         -------
@@ -477,6 +484,7 @@ class Nosible:
             iab_tier_2=iab_tier_2,
             iab_tier_3=iab_tier_3,
             iab_tier_4=iab_tier_4,
+            instruction=instruction,
         )
 
         future = self._executor.submit(self._search_single, search_obj)
@@ -528,6 +536,7 @@ class Nosible:
         iab_tier_2: str = None,
         iab_tier_3: str = None,
         iab_tier_4: str = None,
+        instruction: str = None,
         **kwargs
     ) -> Iterator[ResultSet]:
         """
@@ -608,6 +617,8 @@ class Nosible:
             IAB Tier 3 category for the content.
         iab_tier_4 : str, optional
             IAB Tier 4 category for the content.
+        instruction : str, optional
+            Instruction to use with the search query.
 
         Returns
         ------
@@ -720,6 +731,7 @@ class Nosible:
                 iab_tier_2=iab_tier_2,
                 iab_tier_3=iab_tier_3,
                 iab_tier_4=iab_tier_4,
+                instruction=instruction,
             )
 
             futures = [self._executor.submit(self._search_single, s) for s in searches_list]
@@ -811,6 +823,7 @@ class Nosible:
         iab_tier_2 = search_obj.iab_tier_2 if search_obj.iab_tier_2 is not None else self.iab_tier_2
         iab_tier_3 = search_obj.iab_tier_3 if search_obj.iab_tier_3 is not None else self.iab_tier_3
         iab_tier_4 = search_obj.iab_tier_4 if search_obj.iab_tier_4 is not None else self.iab_tier_4
+        instruction = search_obj.instruction if search_obj.instruction is not None else self.instruction
 
         must_include = must_include if must_include is not None else []
         must_exclude = must_exclude if must_exclude is not None else []
@@ -860,6 +873,7 @@ class Nosible:
             "must_exclude": must_exclude,
         }
         optional = {
+            "instruction": instruction,
             "brand_safety":brand_safety,
             "language": language,
             "continent": continent,
@@ -964,6 +978,7 @@ class Nosible:
         iab_tier_2: str = None,
         iab_tier_3: str = None,
         iab_tier_4: str = None,
+        instruction: str = None,
         verbose: bool = False,
         **kwargs,
     ) -> ResultSet:
@@ -1044,6 +1059,8 @@ class Nosible:
             IAB Tier 3 category for the content.
         iab_tier_4 : str, optional
             IAB Tier 4 category for the content.
+        instruction : str, optional
+            Instruction to use with the search query.
         verbose : bool, optional
             Show verbose output, Bulk search will print more information.
 
@@ -1173,6 +1190,7 @@ class Nosible:
             iab_tier_2 = search.iab_tier_2 if search.iab_tier_2 is not None else self.iab_tier_2
             iab_tier_3 = search.iab_tier_3 if search.iab_tier_3 is not None else self.iab_tier_3
             iab_tier_4 = search.iab_tier_4 if search.iab_tier_4 is not None else self.iab_tier_4
+            instruction = search.instruction if search.instruction is not None else self.instruction
 
         # Default expansions and filters
         if expansions is None:
@@ -1234,6 +1252,7 @@ class Nosible:
                 "must_exclude": must_exclude,
             }
             optional = {
+                "instruction": instruction,
                 "brand_safety": brand_safety,
                 "language": language,
                 "continent": continent,
@@ -1878,7 +1897,7 @@ class Nosible:
         prefix = (self.nosible_api_key or "").split("|", 1)[0]
 
         # Map prefixes -> plan names
-        plans = {"test", "basic", "pro", "pro+", "bus", "bus+", "ent", "chat"}
+        plans = {"test", "basic", "pro", "pro+", "bus", "bus+", "ent", "chat", "cons", "stup", "busn"}
 
         if prefix not in plans:
             raise ValueError(f"Your API key is not valid: {prefix} is not a valid plan prefix.")

{nosible-0.2.5 → nosible-0.2.7/src/nosible.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nosible
-Version: 0.2.5
+Version: 0.2.7
 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