landingai-ade 0.11.0__tar.gz → 0.12.0__tar.gz

landingai_ade-0.12.0/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.12.0"
+}

{landingai_ade-0.11.0 → landingai_ade-0.12.0}/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 0.12.0 (2025-09-25)
+
+Full Changelog: [v0.11.1...v0.12.0](https://github.com/landing-ai/ade-python/compare/v0.11.1...v0.12.0)
+
+### Features
+
+* document_url support local path ([#22](https://github.com/landing-ai/ade-python/issues/22)) ([5da57a5](https://github.com/landing-ai/ade-python/commit/5da57a55c0f674888a48af8d3d80b6fb5b55160c))
+
+## 0.11.1 (2025-09-25)
+
+Full Changelog: [v0.11.0...v0.11.1](https://github.com/landing-ai/ade-python/compare/v0.11.0...v0.11.1)
+
 ## 0.11.0 (2025-09-25)
 
 Full Changelog: [v0.10.0...v0.11.0](https://github.com/landing-ai/ade-python/compare/v0.10.0...v0.11.0)

{landingai_ade-0.11.0 → landingai_ade-0.12.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: landingai-ade
-Version: 0.11.0
+Version: 0.12.0
 Summary: The official Python library for the landingai-ade API
 Project-URL: Homepage, https://github.com/landing-ai/ade-python
 Project-URL: Repository, https://github.com/landing-ai/ade-python
@@ -101,9 +101,8 @@ class Person(BaseModel):
 
 # Convert to JSON schema
 schema = pydantic_to_json_schema(Person)
-
 # Use with the SDK
-client = LandingAIADE(apikey="VISION_AGENT_API_KEY")
+client = LandingAIADE(apikey=os.environ.get("VISION_AGENT_API_KEY"))
 response = client.extract(
     schema=schema,
     # support markdown or markdown_url

{landingai_ade-0.11.0 → landingai_ade-0.12.0}/README.md

@@ -66,9 +66,8 @@ class Person(BaseModel):
 
 # Convert to JSON schema
 schema = pydantic_to_json_schema(Person)
-
 # Use with the SDK
-client = LandingAIADE(apikey="VISION_AGENT_API_KEY")
+client = LandingAIADE(apikey=os.environ.get("VISION_AGENT_API_KEY"))
 response = client.extract(
     schema=schema,
     # support markdown or markdown_url

{landingai_ade-0.11.0 → landingai_ade-0.12.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "landingai-ade"
-version = "0.11.0"
+version = "0.12.0"
 description = "The official Python library for the landingai-ade API"
 dynamic = ["readme"]
 license = "Apache-2.0"

{landingai_ade-0.11.0 → landingai_ade-0.12.0}/src/landingai_ade/_client.py

@@ -49,6 +49,7 @@ from ._base_client import (
     AsyncAPIClient,
     make_request_options,
 )
+from .lib.url_utils import convert_url_to_file_if_local
 from .types.parse_response import ParseResponse
 from .types.extract_response import ExtractResponse
 
@@ -273,6 +274,9 @@ class LandingAIADE(SyncAPIClient):
 
           timeout: Override the client-level default timeout for this request, in seconds
         """
+        # Convert local file paths to file parameters
+        markdown, markdown_url = convert_url_to_file_if_local(markdown, markdown_url)
+
         body = deepcopy_minimal(
             {
                 "schema": schema,
@@ -351,6 +355,9 @@ class LandingAIADE(SyncAPIClient):
 
           timeout: Override the client-level default timeout for this request, in seconds
         """
+        # Convert local file paths to file parameters
+        document, document_url = convert_url_to_file_if_local(document, document_url)
+
         body = deepcopy_minimal(
             {
                 "document": document,
@@ -616,6 +623,9 @@ class AsyncLandingAIADE(AsyncAPIClient):
 
           timeout: Override the client-level default timeout for this request, in seconds
         """
+        # Convert local file paths to file parameters
+        markdown, markdown_url = convert_url_to_file_if_local(markdown, markdown_url)
+
         body = deepcopy_minimal(
             {
                 "schema": schema,
@@ -694,6 +704,9 @@ class AsyncLandingAIADE(AsyncAPIClient):
 
           timeout: Override the client-level default timeout for this request, in seconds
         """
+        # Convert local file paths to file parameters
+        document, document_url = convert_url_to_file_if_local(document, document_url)
+
         body = deepcopy_minimal(
             {
                 "document": document,

{landingai_ade-0.11.0 → landingai_ade-0.12.0}/src/landingai_ade/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "landingai_ade"
-__version__ = "0.11.0"  # x-release-please-version
+__version__ = "0.12.0"  # x-release-please-version

landingai_ade-0.12.0/src/landingai_ade/lib/url_utils.py

@@ -0,0 +1,51 @@
+"""Utility functions for handling URL and file path conversions."""
+
+from typing import Tuple, Union, Optional, cast
+from pathlib import Path
+from urllib.parse import urlparse
+
+from .._types import Omit, FileTypes, omit
+
+
+def convert_url_to_file_if_local(
+    file: Union[Optional[FileTypes], Omit],
+    file_url: Union[Optional[str], Omit],
+) -> Tuple[Union[Optional[FileTypes], Omit], Union[Optional[str], Omit]]:
+    """
+    Convert a URL parameter to a file parameter if it's a local file path.
+
+    If the file_url is a local file path that exists, it will be converted to a Path object
+    and returned as the file parameter, with the file_url parameter set to omit.
+
+    If the file_url is a remote URL (http/https) or doesn't exist as a local file,
+    it will be returned unchanged.
+
+    Args:
+        file: The existing file parameter
+        file_url: The URL parameter that might be a local file path
+
+    Returns:
+        A tuple of (file, file_url) where one will be set and the other omit
+    """
+    # If file_url is omit or None, return unchanged
+    if file_url is omit or file_url is None:
+        return file, file_url
+
+    # At this point, file_url is guaranteed to be a string, use cast for type narrowing
+    url_str = cast(str, file_url)
+
+    # Check if it's a remote URL (http/https)
+    parsed = urlparse(url_str)
+    if parsed.scheme in ("http", "https", "ftp", "ftps"):
+        # It's a remote URL, keep it as is
+        return file, file_url
+
+    # Check if it's a local file path
+    path = Path(url_str)
+    if path.exists() and path.is_file():
+        # It's a local file, convert to file parameter
+        return path, omit
+
+    # Path doesn't exist or is not a file, treat as URL
+    # (could be a URL with a different scheme or a typo)
+    return file, file_url

landingai_ade-0.11.0/.release-please-manifest.json

@@ -1,3 +0,0 @@
-{
-  ".": "0.11.0"
-}