exa-py 1.14.4__tar.gz → 1.14.6__tar.gz

{exa_py-1.14.4 → exa_py-1.14.6}/PKG-INFO

@@ -1,21 +1,24 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.3
 Name: exa-py
-Version: 1.14.4
+Version: 1.14.6
 Summary: Python SDK for Exa API.
-Home-page: https://github.com/exa-labs/exa-py
-Author: Exa
-Author-email: Exa AI <hello@exa.ai>
 License: MIT
+Author: Exa AI
+Author-email: hello@exa.ai
 Requires-Python: >=3.9
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+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: httpx (>=0.28.1)
+Requires-Dist: openai (>=1.48)
+Requires-Dist: pydantic (>=2.10.6)
+Requires-Dist: requests (>=2.32.3)
+Requires-Dist: typing-extensions (>=4.12.2)
 Description-Content-Type: text/markdown
-Requires-Dist: requests>=2.32.3
-Requires-Dist: typing-extensions>=4.12.2
-Requires-Dist: openai>=1.48
-Requires-Dist: pydantic>=2.10.6
-Requires-Dist: pytest-mock>=3.14.0
-Requires-Dist: httpx>=0.28.1
-Dynamic: author
-Dynamic: home-page
 
 # Exa
 
@@ -127,3 +130,4 @@ exa = Exa(api_key="your-api-key")
       output_schema=OUTPUT_SCHEMA,
   )
 ```
+

{exa_py-1.14.4 → exa_py-1.14.6}/exa_py/api.py

@@ -166,6 +166,7 @@ CONTENTS_OPTIONS_TYPES = {
     "text": [dict, bool],
     "highlights": [dict, bool],
     "summary": [dict, bool],
+    "context": [dict, bool],
     "metadata": [dict, bool],
     "livecrawl_timeout": [int],
     "livecrawl": [LIVECRAWL_OPTIONS],
@@ -292,6 +293,16 @@ class SummaryContentsOptions(TypedDict, total=False):
     schema: JSONSchema
 
 
+class ContextContentsOptions(TypedDict, total=False):
+    """Options for retrieving aggregated context from a set of search results.
+
+    Attributes:
+        max_characters (int): The maximum number of characters to include in the context string.
+    """
+
+    max_characters: int
+
+
 class ExtrasOptions(TypedDict, total=False):
     """A class representing additional extraction fields (e.g. links, images)"""
 
@@ -807,17 +818,23 @@ class SearchResponse(Generic[T]):
         autoprompt_string (str, optional): The Exa query created by autoprompt.
         resolved_search_type (str, optional): 'neural' or 'keyword' if auto.
         auto_date (str, optional): A date for filtering if autoprompt found one.
+        context (str, optional): Combined context string when requested via contents.context.
+        statuses (List[ContentStatus], optional): Status list from get_contents.
+        cost_dollars (CostDollars, optional): Cost breakdown.
     """
 
     results: List[T]
     autoprompt_string: Optional[str]
     resolved_search_type: Optional[str]
     auto_date: Optional[str]
+    context: Optional[str] = None
     statuses: Optional[List[ContentStatus]] = None
     cost_dollars: Optional[CostDollars] = None
 
     def __str__(self):
         output = "\n\n".join(str(result) for result in self.results)
+        if self.context:
+            output += f"\nContext: {self.context}"
         if self.autoprompt_string:
             output += f"\n\nAutoprompt String: {self.autoprompt_string}"
         if self.resolved_search_type:
@@ -1254,6 +1271,7 @@ class Exa:
                 "text",
                 "highlights",
                 "summary",
+                "context",
                 "subpages",
                 "subpage_target",
                 "livecrawl",
@@ -1270,6 +1288,7 @@ class Exa:
             data["autopromptString"] if "autopromptString" in data else None,
             data["resolvedSearchType"] if "resolvedSearchType" in data else None,
             data["autoDate"] if "autoDate" in data else None,
+            context=data.get("context"),
             cost_dollars=cost_dollars,
         )
 
@@ -1414,7 +1433,6 @@ class Exa:
             options,
             {**CONTENTS_OPTIONS_TYPES, **CONTENTS_ENDPOINT_OPTIONS_TYPES},
         )
-        
         options = to_camel_case(options)
         data = self.request("/contents", options)
         cost_dollars = parse_cost_dollars(data.get("costDollars"))
@@ -1424,6 +1442,7 @@ class Exa:
             data.get("autopromptString"),
             data.get("resolvedSearchType"),
             data.get("autoDate"),
+            context=data.get("context"),
             cost_dollars=cost_dollars,
             statuses=statuses,
         )
@@ -1715,6 +1734,7 @@ class Exa:
                 "text",
                 "highlights",
                 "summary",
+                "context",
                 "subpages",
                 "subpage_target",
                 "livecrawl",
@@ -1731,6 +1751,7 @@ class Exa:
             data.get("autopromptString"),
             data.get("resolvedSearchType"),
             data.get("autoDate"),
+            context=data.get("context"),
             cost_dollars=cost_dollars,
         )
 
@@ -2067,6 +2088,7 @@ class AsyncExa(Exa):
                 "text",
                 "highlights",
                 "summary",
+                "context",
                 "subpages",
                 "subpage_target",
                 "livecrawl",
@@ -2083,6 +2105,7 @@ class AsyncExa(Exa):
             data["autopromptString"] if "autopromptString" in data else None,
             data["resolvedSearchType"] if "resolvedSearchType" in data else None,
             data["autoDate"] if "autoDate" in data else None,
+            context=data.get("context"),
             cost_dollars=cost_dollars,
         )
 
@@ -2113,6 +2136,7 @@ class AsyncExa(Exa):
             data.get("autopromptString"),
             data.get("resolvedSearchType"),
             data.get("autoDate"),
+            context=data.get("context"),
             cost_dollars=cost_dollars,
             statuses=statuses,
         )
@@ -2192,6 +2216,7 @@ class AsyncExa(Exa):
                 "text",
                 "highlights",
                 "summary",
+                "context",
                 "subpages",
                 "subpage_target",
                 "livecrawl",
@@ -2208,6 +2233,7 @@ class AsyncExa(Exa):
             data.get("autopromptString"),
             data.get("resolvedSearchType"),
             data.get("autoDate"),
+            context=data.get("context"),
             cost_dollars=cost_dollars,
         )
 

exa_py-1.14.6/exa_py/websets/_generator/pydantic/BaseModel.jinja2

@@ -0,0 +1,42 @@
+{% for decorator in decorators -%}
+{{ decorator }}
+{% endfor -%}
+class {{ class_name }}({{ base_class }}):{% if comment is defined %}  # {{ comment }}{% endif %}
+{%- if description %}
+    """
+    {{ description | indent(4) }}
+    """
+{%- endif %}
+{%- if not fields and not description %}
+    pass
+{%- endif %}
+{%- if config %}
+{%- filter indent(4) %}
+{%- endfilter %}
+{%- endif %}
+{%- for field in fields -%}
+    {%- if field.name == "type" and field.field %}
+    type: Literal['{{ field.default }}']
+    {%- elif field.name == "object" and field.field %}
+    object: Literal['{{ field.default }}']
+    {%- elif not field.annotated and field.field %}
+    {{ field.name }}: {{ field.type_hint }} = {{ field.field }}
+    {%- else %}
+    {%- if field.annotated %}
+    {{ field.name }}: {{ field.annotated }}
+    {%- else %}
+    {{ field.name }}: {{ field.type_hint }}
+    {%- endif %}
+    {%- if not (field.required or (field.represented_default == 'None' and field.strip_default_none)) or field.data_type.is_optional
+            %} = {{ field.represented_default }}
+    {%- endif -%}
+    {%- endif %}
+    {%- if field.docstring %}
+    """
+    {{ field.docstring | indent(4) }}
+    """
+    {%- endif %}
+{%- for method in methods -%}
+    {{ method }}
+{%- endfor -%}
+{%- endfor -%}

{exa_py-1.14.4 → exa_py-1.14.6}/pyproject.toml

@@ -1,17 +1,9 @@
-[tool.poetry]
-name = "exa-py"
-version = "1.14.2"
-description = "Python SDK for Exa API."
-authors = ["Exa AI <hello@exa.ai>"]
-readme = "README.md"
-
 [tool.poetry.dependencies]
 python = "^3.9"
 requests = "^2.32.3"
 typing-extensions = "^4.12.2"
 openai = "^1.48"
 pydantic = "^2.10.6"
-pytest-mock = "^3.14.0"
 httpx = "^0.28.1"
 
 [tool.poetry.group.dev.dependencies]
@@ -22,6 +14,7 @@ twine = "^5.1.1"
 datamodel-code-generator = "^0.28.4"
 pytest = "^8.3.5"
 pytest-cov = "^6.0.0"
+pytest-mock = "^3.14.0"
 
 [build-system]
 requires = ["poetry-core"]
@@ -32,7 +25,7 @@ in-project = true
 
 [project]
 name = "exa-py"
-version = "1.14.4"
+version = "1.14.6"
 description = "Python SDK for Exa API."
 readme = "README.md"
 requires-python = ">=3.9"
@@ -43,6 +36,5 @@ dependencies = [
     "typing-extensions>=4.12.2",
     "openai>=1.48",
     "pydantic>=2.10.6",
-    "pytest-mock>=3.14.0",
     "httpx>=0.28.1",
 ]

exa_py-1.14.4/exa_py.egg-info/PKG-INFO

@@ -1,129 +0,0 @@
-Metadata-Version: 2.4
-Name: exa-py
-Version: 1.14.4
-Summary: Python SDK for Exa API.
-Home-page: https://github.com/exa-labs/exa-py
-Author: Exa
-Author-email: Exa AI <hello@exa.ai>
-License: MIT
-Requires-Python: >=3.9
-Description-Content-Type: text/markdown
-Requires-Dist: requests>=2.32.3
-Requires-Dist: typing-extensions>=4.12.2
-Requires-Dist: openai>=1.48
-Requires-Dist: pydantic>=2.10.6
-Requires-Dist: pytest-mock>=3.14.0
-Requires-Dist: httpx>=0.28.1
-Dynamic: author
-Dynamic: home-page
-
-# Exa
-
-Exa (formerly Metaphor) API in Python
-
-Note: This API is basically the same as `metaphor-python` but reflects new
-features associated with Metaphor's rename to Exa. New site is https://exa.ai
-
-## Installation
-
-```bash
-pip install exa_py
-```
-
-## Usage
-
-Import the package and initialize the Exa client with your API key:
-
-```python
-from exa_py import Exa
-
-exa = Exa(api_key="your-api-key")
-```
-
-## Common requests
-
-```python
-
-  # basic search
-  results = exa.search("This is a Exa query:")
-
-  # keyword search (non-neural)
-  results = exa.search("Google-style query", type="keyword")
-
-  # search with date filters
-  results = exa.search("This is a Exa query:", start_published_date="2019-01-01", end_published_date="2019-01-31")
-
-  # search with domain filters
-  results = exa.search("This is a Exa query:", include_domains=["www.cnn.com", "www.nytimes.com"])
-
-  # search and get text contents
-  results = exa.search_and_contents("This is a Exa query:")
-
-  # search and get contents with contents options
-  results = exa.search_and_contents("This is a Exa query:",
-                                    text={"include_html_tags": True, "max_characters": 1000})
-
-  # find similar documents
-  results = exa.find_similar("https://example.com")
-
-  # find similar excluding source domain
-  results = exa.find_similar("https://example.com", exclude_source_domain=True)
-
-  # find similar with contents
-  results = exa.find_similar_and_contents("https://example.com", text=True)
-
-  # get text contents
-  results = exa.get_contents(["tesla.com"])
-
-  # get contents with contents options
-  results = exa.get_contents(["urls"],
-                             text={"include_html_tags": True, "max_characters": 1000})
-
-  # basic answer
-  response = exa.answer("This is a query to answer a question")
-
-  # answer with full text, using the exa-pro model (sends 2 expanded quries to exa search)
-  response = exa.answer("This is a query to answer a question", text=True, model="exa-pro")
-
-  # answer with streaming
-  response = exa.stream_answer("This is a query to answer:")
-
-  # Print each chunk as it arrives when using the stream_answer method
-  for chunk in response:
-    print(chunk, end='', flush=True)
-
-  # research task example – answer a question with citations
-  # Example prompt & schema inspired by the TypeScript example.
-  QUESTION = (
-      "Summarize the history of San Francisco highlighting one or two major events "
-      "for each decade from 1850 to 1950"
-  )
-  OUTPUT_SCHEMA: Dict[str, Any] = {
-      "type": "object",
-      "required": ["timeline"],
-      "properties": {
-          "timeline": {
-              "type": "array",
-              "items": {
-                  "type": "object",
-                  "required": ["decade", "notableEvents"],
-                  "properties": {
-                      "decade": {
-                          "type": "string",
-                          "description": 'Decade label e.g. "1850s"',
-                      },
-                      "notableEvents": {
-                          "type": "string",
-                          "description": "A summary of notable events.",
-                      },
-                  },
-              },
-          },
-      },
-  }
-  resp = exa.research.create_task(
-      instructions=QUESTION,
-      model="exa-research",
-      output_schema=OUTPUT_SCHEMA,
-  )
-```

exa_py-1.14.4/exa_py.egg-info/SOURCES.txt

@@ -1,35 +0,0 @@
-README.md
-pyproject.toml
-setup.py
-exa_py/__init__.py
-exa_py/api.py
-exa_py/py.typed
-exa_py/utils.py
-exa_py.egg-info/PKG-INFO
-exa_py.egg-info/SOURCES.txt
-exa_py.egg-info/dependency_links.txt
-exa_py.egg-info/requires.txt
-exa_py.egg-info/top_level.txt
-exa_py/research/__init__.py
-exa_py/research/client.py
-exa_py/research/models.py
-exa_py/websets/__init__.py
-exa_py/websets/client.py
-exa_py/websets/types.py
-exa_py/websets/core/__init__.py
-exa_py/websets/core/base.py
-exa_py/websets/enrichments/__init__.py
-exa_py/websets/enrichments/client.py
-exa_py/websets/items/__init__.py
-exa_py/websets/items/client.py
-exa_py/websets/monitors/__init__.py
-exa_py/websets/monitors/client.py
-exa_py/websets/monitors/runs/__init__.py
-exa_py/websets/monitors/runs/client.py
-exa_py/websets/searches/__init__.py
-exa_py/websets/searches/client.py
-exa_py/websets/webhooks/__init__.py
-exa_py/websets/webhooks/client.py
-tests/test_monitors.py
-tests/test_search_api.py
-tests/test_websets.py

exa_py-1.14.4/exa_py.egg-info/dependency_links.txt

@@ -1 +0,0 @@
-

exa_py-1.14.4/exa_py.egg-info/requires.txt

@@ -1,6 +0,0 @@
-requests>=2.32.3
-typing-extensions>=4.12.2
-openai>=1.48
-pydantic>=2.10.6
-pytest-mock>=3.14.0
-httpx>=0.28.1

exa_py-1.14.4/exa_py.egg-info/top_level.txt

@@ -1 +0,0 @@
-exa_py

exa_py-1.14.4/setup.cfg

@@ -1,4 +0,0 @@
-[egg_info]
-tag_build = 
-tag_date = 0
-

exa_py-1.14.4/setup.py

@@ -1,26 +0,0 @@
-from setuptools import find_packages, setup
-
-setup(
-    name="exa_py",
-    version="1.14.4",
-    description="Python SDK for Exa API.",
-    long_description_content_type="text/markdown",
-    long_description=open("README.md").read(),
-    author="Exa",
-    author_email="hello@exa.ai",
-    package_data={"exa_py": ["py.typed"]},
-    url="https://github.com/exa-labs/exa-py",
-    packages=find_packages(),
-    install_requires=["requests", "typing-extensions", "openai>=1.10.0"],
-    classifiers=[
-        "Development Status :: 5 - Production/Stable",
-        "Intended Audience :: Developers",
-        "License :: OSI Approved :: MIT License",
-        "Typing :: Typed",
-        "Programming Language :: Python :: 3.8",
-        "Programming Language :: Python :: 3.9",
-        "Programming Language :: Python :: 3.10",
-        "Programming Language :: Python :: 3.11",
-        "Programming Language :: Python :: 3.12",
-    ],
-)