exa-py 1.0.15__py3-none-any.whl → 1.0.17__py3-none-any.whl

exa_py/api.py

@@ -41,9 +41,9 @@ def snake_to_camel(snake_str: str) -> str:
     components = snake_str.split("_")
     return components[0] + "".join(x.title() for x in components[1:])
 
-
 def to_camel_case(data: dict) -> dict:
-    """Convert keys in a dictionary from snake_case to camelCase.
+    """
+    Convert keys in a dictionary from snake_case to camelCase recursively.
 
     Args:
         data (dict): The dictionary with keys in snake_case format.
@@ -51,8 +51,11 @@ def to_camel_case(data: dict) -> dict:
     Returns:
         dict: The dictionary with keys converted to camelCase format.
     """
-    return {snake_to_camel(k): v for k, v in data.items() if v is not None}
-
+    return {
+        snake_to_camel(k): to_camel_case(v) if isinstance(v, dict) else v
+        for k, v in data.items()
+        if v is not None
+    }
 
 def camel_to_snake(camel_str: str) -> str:
     """Convert camelCase string to snake_case.
@@ -66,9 +69,9 @@ def camel_to_snake(camel_str: str) -> str:
     snake_str = re.sub("(.)([A-Z][a-z]+)", r"\1_\2", camel_str)
     return re.sub("([a-z0-9])([A-Z])", r"\1_\2", snake_str).lower()
 
-
 def to_snake_case(data: dict) -> dict:
-    """Convert keys in a dictionary from camelCase to snake_case.
+    """
+    Convert keys in a dictionary from camelCase to snake_case recursively.
 
     Args:
         data (dict): The dictionary with keys in camelCase format.
@@ -76,8 +79,10 @@ def to_snake_case(data: dict) -> dict:
     Returns:
         dict: The dictionary with keys converted to snake_case format.
     """
-    return {camel_to_snake(k): v for k, v in data.items()}
-
+    return {
+        camel_to_snake(k): to_snake_case(v) if isinstance(v, dict) else v
+        for k, v in data.items()
+    }
 
 SEARCH_OPTIONS_TYPES = {
     "query": [str],  # The query string.
@@ -94,6 +99,10 @@ SEARCH_OPTIONS_TYPES = {
     "end_published_date": [
         str
     ],  # Results before this publish date; excludes links with no date. ISO 8601 format.
+    "include_text": [
+        list
+    ],  # list of strings that must be present in webpage text of results. Currently, only one string is supported, up to 5 words.
+    "exclude_text": [list],  # list of strings that must not be present in webpage text of result. Currently, only one string is supported, up to 5 words.
     "use_autoprompt": [bool],  # Convert query to Exa (Higher latency, Default: false).
     "type": [
         str
@@ -112,6 +121,8 @@ FIND_SIMILAR_OPTIONS_TYPES = {
     "end_crawl_date": [str],
     "start_published_date": [str],
     "end_published_date": [str],
+    "include_text": [list],
+    "exclude_text": [list],
     "exclude_source_domain": [bool],
     "category": [str],
 }
@@ -424,7 +435,7 @@ class Exa:
         self,
         api_key: Optional[str],
         base_url: str = "https://api.exa.ai",
-        user_agent: str = "exa-py 1.0.15",
+        user_agent: str = "exa-py 1.0.17",
     ):
         """Initialize the Exa client with the provided API key and optional base URL and user agent.
 
@@ -462,6 +473,8 @@ class Exa:
         end_crawl_date: Optional[str] = None,
         start_published_date: Optional[str] = None,
         end_published_date: Optional[str] = None,
+        include_text: Optional[List[str]] = None,
+        exclude_text: Optional[List[str]] = None,
         use_autoprompt: Optional[bool] = None,
         type: Optional[str] = None,
         category: Optional[str] = None,
@@ -477,6 +490,8 @@ class Exa:
             end_crawl_date (str, optional): Results will only include links crawled before this date.
             start_published_date (str, optional): Results will only include links with a published date after this date.
             end_published_date (str, optional): Results will only include links with a published date before this date.
+            include_text (List[str], optional): List of strings that must be present in the webpage text of results. Currently, only one string is supported, up to 5 words.
+            exclude_text (List[str], optional): List of strings that must not be present in the webpage text of results. Currently, only one string is supported, up to 5 words.
             use_autoprompt (bool, optional): If true, convert query to a Exa query. Defaults to False.
             type (str, optional): The type of search, 'keyword' or 'neural'. Defaults to "neural".
             category (str, optional): A data category to focus on, with higher comprehensivity and data cleanliness. Currently, the only category is company.
@@ -504,6 +519,8 @@ class Exa:
         end_crawl_date: Optional[str] = None,
         start_published_date: Optional[str] = None,
         end_published_date: Optional[str] = None,
+        include_text: Optional[List[str]] = None,
+        exclude_text: Optional[List[str]] = None,
         use_autoprompt: Optional[bool] = None,
         type: Optional[str] = None,
         category: Optional[str] = None,
@@ -523,6 +540,8 @@ class Exa:
         end_crawl_date: Optional[str] = None,
         start_published_date: Optional[str] = None,
         end_published_date: Optional[str] = None,
+        include_text: Optional[List[str]] = None,
+        exclude_text: Optional[List[str]] = None,
         use_autoprompt: Optional[bool] = None,
         type: Optional[str] = None,
         category: Optional[str] = None,
@@ -542,6 +561,8 @@ class Exa:
         end_crawl_date: Optional[str] = None,
         start_published_date: Optional[str] = None,
         end_published_date: Optional[str] = None,
+        include_text: Optional[List[str]] = None,
+        exclude_text: Optional[List[str]] = None,
         use_autoprompt: Optional[bool] = None,
         type: Optional[str] = None,
         category: Optional[str] = None,
@@ -562,6 +583,8 @@ class Exa:
         end_crawl_date: Optional[str] = None,
         start_published_date: Optional[str] = None,
         end_published_date: Optional[str] = None,
+        include_text: Optional[List[str]] = None,
+        exclude_text: Optional[List[str]] = None,
         use_autoprompt: Optional[bool] = None,
         type: Optional[str] = None,
         category: Optional[str] = None,
@@ -581,6 +604,8 @@ class Exa:
         end_crawl_date: Optional[str] = None,
         start_published_date: Optional[str] = None,
         end_published_date: Optional[str] = None,
+        include_text: Optional[List[str]] = None,
+        exclude_text: Optional[List[str]] = None,
         use_autoprompt: Optional[bool] = None,
         type: Optional[str] = None,
         category: Optional[str] = None,
@@ -601,6 +626,8 @@ class Exa:
         end_crawl_date: Optional[str] = None,
         start_published_date: Optional[str] = None,
         end_published_date: Optional[str] = None,
+        include_text: Optional[List[str]] = None,
+        exclude_text: Optional[List[str]] = None,
         use_autoprompt: Optional[bool] = None,
         type: Optional[str] = None,
         category: Optional[str] = None,
@@ -621,6 +648,8 @@ class Exa:
         end_crawl_date: Optional[str] = None,
         start_published_date: Optional[str] = None,
         end_published_date: Optional[str] = None,
+        include_text: Optional[List[str]] = None,
+        exclude_text: Optional[List[str]] = None,
         use_autoprompt: Optional[bool] = None,
         type: Optional[str] = None,
         category: Optional[str] = None,
@@ -642,6 +671,8 @@ class Exa:
         end_crawl_date: Optional[str] = None,
         start_published_date: Optional[str] = None,
         end_published_date: Optional[str] = None,
+        include_text: Optional[List[str]] = None,
+        exclude_text: Optional[List[str]] = None,
         use_autoprompt: Optional[bool] = None,
         type: Optional[str] = None,
         category: Optional[str] = None,
@@ -769,6 +800,8 @@ class Exa:
         end_crawl_date: Optional[str] = None,
         start_published_date: Optional[str] = None,
         end_published_date: Optional[str] = None,
+        include_text: Optional[List[str]] = None,
+        exclude_text: Optional[List[str]] = None,
         exclude_source_domain: Optional[bool] = None,
         category: Optional[str] = None,
     ) -> SearchResponse[_Result]:
@@ -793,6 +826,8 @@ class Exa:
         end_crawl_date: Optional[str] = None,
         start_published_date: Optional[str] = None,
         end_published_date: Optional[str] = None,
+        include_text: Optional[List[str]] = None,
+        exclude_text: Optional[List[str]] = None,
         exclude_source_domain: Optional[bool] = None,
         category: Optional[str] = None,
     ) -> SearchResponse[ResultWithText]:
@@ -811,6 +846,8 @@ class Exa:
         end_crawl_date: Optional[str] = None,
         start_published_date: Optional[str] = None,
         end_published_date: Optional[str] = None,
+        include_text: Optional[List[str]] = None,
+        exclude_text: Optional[List[str]] = None,
         exclude_source_domain: Optional[bool] = None,
         category: Optional[str] = None,
     ) -> SearchResponse[ResultWithText]:
@@ -829,6 +866,8 @@ class Exa:
         end_crawl_date: Optional[str] = None,
         start_published_date: Optional[str] = None,
         end_published_date: Optional[str] = None,
+        include_text: Optional[List[str]] = None,
+        exclude_text: Optional[List[str]] = None,
         exclude_source_domain: Optional[bool] = None,
         category: Optional[str] = None,
     ) -> SearchResponse[ResultWithHighlights]:
@@ -848,6 +887,8 @@ class Exa:
         end_crawl_date: Optional[str] = None,
         start_published_date: Optional[str] = None,
         end_published_date: Optional[str] = None,
+        include_text: Optional[List[str]] = None,
+        exclude_text: Optional[List[str]] = None,
         exclude_source_domain: Optional[bool] = None,
         category: Optional[str] = None,
     ) -> SearchResponse[ResultWithTextAndHighlights]:
@@ -866,6 +907,8 @@ class Exa:
         end_crawl_date: Optional[str] = None,
         start_published_date: Optional[str] = None,
         end_published_date: Optional[str] = None,
+        include_text: Optional[List[str]] = None,
+        exclude_text: Optional[List[str]] = None,
         exclude_source_domain: Optional[bool] = None,
         category: Optional[str] = None,
     ) -> SearchResponse[ResultWithSummary]:
@@ -885,6 +928,8 @@ class Exa:
         end_crawl_date: Optional[str] = None,
         start_published_date: Optional[str] = None,
         end_published_date: Optional[str] = None,
+        include_text: Optional[List[str]] = None,
+        exclude_text: Optional[List[str]] = None,
         exclude_source_domain: Optional[bool] = None,
         category: Optional[str] = None,
     ) -> SearchResponse[ResultWithTextAndSummary]:
@@ -904,6 +949,8 @@ class Exa:
         end_crawl_date: Optional[str] = None,
         start_published_date: Optional[str] = None,
         end_published_date: Optional[str] = None,
+        include_text: Optional[List[str]] = None,
+        exclude_text: Optional[List[str]] = None,
         exclude_source_domain: Optional[bool] = None,
         category: Optional[str] = None,
     ) -> SearchResponse[ResultWithHighlightsAndSummary]:
@@ -924,6 +971,8 @@ class Exa:
         end_crawl_date: Optional[str] = None,
         start_published_date: Optional[str] = None,
         end_published_date: Optional[str] = None,
+        include_text: Optional[List[str]] = None,
+        exclude_text: Optional[List[str]] = None,
         exclude_source_domain: Optional[bool] = None,
         category: Optional[str] = None,
     ) -> SearchResponse[ResultWithTextAndHighlightsAndSummary]:
@@ -979,6 +1028,8 @@ class Exa:
             end_crawl_date: Optional[str] = None,
             start_published_date: Optional[str] = None,
             end_published_date: Optional[str] = None,
+            include_text: Optional[List[str]] = None,
+            exclude_text: Optional[List[str]] = None,
             use_autoprompt: Optional[bool] = True,
             type: Optional[str] = None,
             category: Optional[str] = None,
@@ -995,6 +1046,8 @@ class Exa:
                 "end_crawl_date": end_crawl_date,
                 "start_published_date": start_published_date,
                 "end_published_date": end_published_date,
+                "include_text": include_text,
+                "exclude_text": exclude_text,
                 "use_autoprompt": use_autoprompt,
                 "type": type,
                 "category": category,

{exa_py-1.0.15.dist-info → exa_py-1.0.17.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: exa-py
-Version: 1.0.15
+Version: 1.0.17
 Summary: Python SDK for Exa API.
 Home-page: https://github.com/exa-labs/exa-py
 Author: Exa

exa_py-1.0.17.dist-info/RECORD

@@ -0,0 +1,8 @@
+exa_py/__init__.py,sha256=aVF1zB_UV3dagJ5Vn2WrdcInzibdIW61M89sjwRCU_g,29
+exa_py/api.py,sha256=6xiQ1yNRqM4z6Qh-PyQWx_HBBKAx3Iq1h9q7Lh31DG0,41075
+exa_py/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+exa_py/utils.py,sha256=Rc1FJjoR9LQ7L_OJM91Sd1GNkbHjcLyEvJENhRix6gc,2405
+exa_py-1.0.17.dist-info/METADATA,sha256=Ow1jUrcf5JE6jueKxDMdD4DTjrCBgbuurn3gTCcioZc,3083
+exa_py-1.0.17.dist-info/WHEEL,sha256=pkctZYzUS4AYVn6dJ-7367OJZivF2e8RA9b_ZBjif18,92
+exa_py-1.0.17.dist-info/top_level.txt,sha256=Mfkmscdw9HWR1PtVhU1gAiVo6DHu_tyiVdb89gfZBVI,7
+exa_py-1.0.17.dist-info/RECORD,,

exa_py-1.0.15.dist-info/RECORD

@@ -1,8 +0,0 @@
-exa_py/__init__.py,sha256=aVF1zB_UV3dagJ5Vn2WrdcInzibdIW61M89sjwRCU_g,29
-exa_py/api.py,sha256=QT0gp-cow6aDDmHJARIgKfi-TFUngxmpr4PWKVyYZRc,38176
-exa_py/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-exa_py/utils.py,sha256=Rc1FJjoR9LQ7L_OJM91Sd1GNkbHjcLyEvJENhRix6gc,2405
-exa_py-1.0.15.dist-info/METADATA,sha256=agZ-1DeqIjSwZlWzrs2YOGN5DD_-QHGPMKHvgoEiFkY,3083
-exa_py-1.0.15.dist-info/WHEEL,sha256=pkctZYzUS4AYVn6dJ-7367OJZivF2e8RA9b_ZBjif18,92
-exa_py-1.0.15.dist-info/top_level.txt,sha256=Mfkmscdw9HWR1PtVhU1gAiVo6DHu_tyiVdb89gfZBVI,7
-exa_py-1.0.15.dist-info/RECORD,,