exa-py 1.15.6__tar.gz → 1.16.0__tar.gz

{exa_py-1.15.6 → exa_py-1.16.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: exa-py
-Version: 1.15.6
+Version: 1.16.0
 Summary: Python SDK for Exa API.
 License: MIT
 Author: Exa AI
@@ -13,9 +13,11 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Requires-Dist: httpcore (>=1.0.9)
 Requires-Dist: httpx (>=0.28.1)
 Requires-Dist: openai (>=1.48)
 Requires-Dist: pydantic (>=2.10.6)
+Requires-Dist: python-dotenv (>=1.0.1)
 Requires-Dist: requests (>=2.32.3)
 Requires-Dist: typing-extensions (>=4.12.2)
 Description-Content-Type: text/markdown

{exa_py-1.15.6 → exa_py-1.16.0}/exa_py/api.py

@@ -142,7 +142,9 @@ SEARCH_OPTIONS_TYPES = {
         list
     ],  # Must not be present in webpage text. (One string, up to 5 words)
     "use_autoprompt": [bool],  # Convert query to Exa. (Default: false)
-    "type": [str],  # 'keyword', 'neural', 'hybrid', 'fast', or 'auto' (Default: auto)
+    "type": [
+        str
+    ],  # 'keyword', 'neural', 'hybrid', 'fast', 'deep', or 'auto' (Default: auto)
     "category": [
         str
     ],  # A data category to focus on: 'company', 'research paper', 'news', 'pdf', 'github', 'tweet', 'personal site', 'linkedin profile', 'financial report'
@@ -260,6 +262,10 @@ class HighlightsContentsOptions(TypedDict, total=False):
         query (str): The query string for the highlights.
         num_sentences (int): Size of highlights to return, in sentences. Default: 5
         highlights_per_url (int): Number of highlights to return per URL. Default: 1
+
+    NOTE: When using the "deep" search type, only the default highlights=True is supported.
+          These options will NOT be respected. Highlights will always be based on the user's query,
+          and the number and length may vary.
     """
 
     query: str
@@ -1275,7 +1281,7 @@ class Exa:
             include_text (List[str], optional): Strings that must appear in the page text.
             exclude_text (List[str], optional): Strings that must not appear in the page text.
             use_autoprompt (bool, optional): Convert query to Exa (default False).
-            type (str, optional): 'keyword', 'neural', 'hybrid', 'fast', or 'auto' (default 'auto').
+            type (str, optional): 'keyword', 'neural', 'hybrid', 'fast', 'deep', or 'auto' (default 'auto').
             category (str, optional): e.g. 'company'
             flags (List[str], optional): Experimental flags for Exa usage.
             moderation (bool, optional): If True, the search results will be moderated for safety.
@@ -2438,8 +2444,12 @@ class AsyncExa(Exa):
         return self._client
 
     async def async_request(
-        self, endpoint: str, data=None, method: str = "POST", params=None,
-        headers: Optional[Dict[str, str]] = None
+        self,
+        endpoint: str,
+        data=None,
+        method: str = "POST",
+        params=None,
+        headers: Optional[Dict[str, str]] = None,
     ):
         """Send a request to the Exa API, optionally streaming if data['stream'] is True.
 
@@ -2470,7 +2480,10 @@ class AsyncExa(Exa):
         if method.upper() == "GET":
             if needs_streaming:
                 request = httpx.Request(
-                    "GET", self.base_url + endpoint, params=params, headers=request_headers
+                    "GET",
+                    self.base_url + endpoint,
+                    params=params,
+                    headers=request_headers,
                 )
                 res = await self.client.send(request, stream=True)
                 return res
@@ -2529,7 +2542,7 @@ class AsyncExa(Exa):
             include_text (List[str], optional): Strings that must appear in the page text.
             exclude_text (List[str], optional): Strings that must not appear in the page text.
             use_autoprompt (bool, optional): Convert query to Exa (default False).
-            type (str, optional): 'keyword', 'neural', 'hybrid', 'fast', or 'auto' (default 'auto').
+            type (str, optional): 'keyword', 'neural', 'hybrid', 'fast', 'deep', or 'auto' (default 'auto').
             category (str, optional): e.g. 'company'
             flags (List[str], optional): Experimental flags for Exa usage.
             moderation (bool, optional): If True, the search results will be moderated for safety.

{exa_py-1.15.6 → exa_py-1.16.0}/pyproject.toml

@@ -5,17 +5,18 @@ typing-extensions = "^4.12.2"
 openai = "^1.48"
 pydantic = "^2.10.6"
 httpx = "^0.28.1"
+httpcore = "^1.0.9"
+python-dotenv = "^1.0.1"
 
 [tool.poetry.group.dev.dependencies]
-python-dotenv = "^1.0.1"
-setuptools = "^74.0.0"
+setuptools = "^78.1.1"
 docutils = "^0.21.2"
 twine = "^5.1.1"
 datamodel-code-generator = "^0.28.4"
-pytest = "^8.3.5"
-pytest-cov = "^6.0.0"
-pytest-mock = "^3.14.0"
-pytest-asyncio = "^0.24.0"
+pytest = "^8.4.1"
+pytest-cov = "^6.2.1"
+pytest-mock = "^3.14.1"
+pytest-asyncio = "^1.0.0"
 
 [build-system]
 requires = ["poetry-core"]
@@ -23,7 +24,7 @@ build-backend = "poetry.core.masonry.api"
 
 [project]
 name = "exa-py"
-version = "1.15.6"
+version = "1.16.0"
 description = "Python SDK for Exa API."
 readme = "README.md"
 requires-python = ">=3.9"
@@ -35,6 +36,8 @@ dependencies = [
     "openai>=1.48",
     "pydantic>=2.10.6",
     "httpx>=0.28.1",
+    "httpcore>=1.0.9",
+    "python-dotenv>=1.0.1",
 ]
 
 [dependency-groups]