exa-py 1.8.9__tar.gz → 1.9.0__tar.gz

{exa_py-1.8.9 → exa_py-1.9.0}/PKG-INFO

@@ -1,23 +1,20 @@
-Metadata-Version: 2.1
-Name: exa_py
-Version: 1.8.9
+Metadata-Version: 2.3
+Name: exa-py
+Version: 1.9.0
 Summary: Python SDK for Exa API.
-Home-page: https://github.com/exa-labs/exa-py
-Author: Exa
+Author: Exa AI
 Author-email: hello@exa.ai
-Classifier: Development Status :: 5 - Production/Stable
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Typing :: Typed
-Classifier: Programming Language :: Python :: 3.8
+Requires-Python: >=3.9,<4.0
+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: openai (>=1.48,<2.0)
+Requires-Dist: requests (>=2.32.3,<3.0.0)
+Requires-Dist: typing-extensions (>=4.12.2,<5.0.0)
 Description-Content-Type: text/markdown
-Requires-Dist: requests
-Requires-Dist: typing-extensions
-Requires-Dist: openai>=1.10.0
 
 # Exa
 
@@ -106,3 +103,4 @@ exa = Exa(api_key="your-api-key")
 
 ```
 
+

{exa_py-1.8.9 → exa_py-1.9.0}/exa_py/api.py

@@ -47,6 +47,12 @@ def snake_to_camel(snake_str: str) -> str:
     Returns:
         str: The string converted to camelCase format.
     """
+    # Handle special cases where the field should start with non-alphanumeric characters
+    if snake_str == "schema_":
+        return "$schema"
+    if snake_str == "not_":
+        return "not"
+        
     components = snake_str.split("_")
     return components[0] + "".join(x.title() for x in components[1:])
 
@@ -247,15 +253,38 @@ class HighlightsContentsOptions(TypedDict, total=False):
     highlights_per_url: int
 
 
+class JSONSchema(TypedDict, total=False):
+    """Represents a JSON Schema definition used for structured summary output.
+    To learn more visit https://json-schema.org/overview/what-is-jsonschema.
+    """
+    schema_: str  # This will be converted to "$schema" in JSON
+    title: str
+    description: str
+    type: Literal["object", "array", "string", "number", "boolean", "null", "integer"]
+    properties: Dict[str, JSONSchema]
+    items: Union[JSONSchema, List[JSONSchema]]
+    required: List[str]
+    enum: List
+    additionalProperties: Union[bool, JSONSchema]
+    definitions: Dict[str, JSONSchema]
+    patternProperties: Dict[str, JSONSchema]
+    allOf: List[JSONSchema]
+    anyOf: List[JSONSchema]
+    oneOf: List[JSONSchema]
+    not_: JSONSchema  # This will be converted to "not" in JSON
+
+
 class SummaryContentsOptions(TypedDict, total=False):
     """A class representing the options that you can specify when requesting summary
 
     Attributes:
         query (str): The query string for the summary. Summary will bias towards answering the query.
+        schema (JSONSchema): JSON schema for structured output from summary.
     """
 
     query: str
-
+    schema: JSONSchema
+    
 
 class ExtrasOptions(TypedDict, total=False):
     """A class representing additional extraction fields (e.g. links, images)"""
@@ -759,7 +788,7 @@ class Exa:
         self,
         api_key: Optional[str],
         base_url: str = "https://api.exa.ai",
-        user_agent: str = "exa-py 1.8.9",
+        user_agent: str = "exa-py 1.9.0",
     ):
         """Initialize the Exa client with the provided API key and optional base URL and user agent.
 

{exa_py-1.8.9 → exa_py-1.9.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "exa-py"
-version = "1.8.8"
+version = "1.9.0"
 description = "Python SDK for Exa API."
 authors = ["Exa AI <hello@exa.ai>"]
 readme = "README.md"

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

@@ -1,108 +0,0 @@
-Metadata-Version: 2.1
-Name: exa_py
-Version: 1.8.9
-Summary: Python SDK for Exa API.
-Home-page: https://github.com/exa-labs/exa-py
-Author: Exa
-Author-email: hello@exa.ai
-Classifier: Development Status :: 5 - Production/Stable
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Typing :: Typed
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Description-Content-Type: text/markdown
-Requires-Dist: requests
-Requires-Dist: typing-extensions
-Requires-Dist: openai>=1.10.0
-
-# 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:")
-
-  # autoprompted search
-  results = exa.search("autopromptable query", use_autoprompt=True)
-
-  # 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 highlights
-  results = exa.search_and_contents("This is a Exa query:", highlights=True)
-
-  # 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}, 
-                                    highlights={"highlights_per_url": 2, "num_sentences": 1, "query": "This is the highlight query:"})
-                                    
-  # 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, highlights=True)
-
-  # get text contents
-  results = exa.get_contents(["urls"])
-
-  # get highlights
-  results = exa.get_contents(["urls"], highlights=True)
-
-  # get contents with contents options
-  results = exa.get_contents(["urls"], 
-                             text={"include_html_tags": True, "max_characters": 1000}, 
-                             highlights={"highlights_per_url": 2, "num_sentences": 1, "query": "This is the highlight query:"})
-
-  # 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)
-
-```
-

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

@@ -1,12 +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-1.8.9/exa_py.egg-info/dependency_links.txt

@@ -1 +0,0 @@
-

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

@@ -1,3 +0,0 @@
-requests
-typing-extensions
-openai>=1.10.0

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

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

exa_py-1.8.9/setup.cfg

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

exa_py-1.8.9/setup.py

@@ -1,26 +0,0 @@
-from setuptools import find_packages, setup
-
-setup(
-    name="exa_py",
-    version="1.8.9",
-    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",
-    ],
-)