landingai-ade 0.11.1__tar.gz → 0.13.0__tar.gz

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

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

{landingai_ade-0.11.1 → landingai_ade-0.13.0}/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 0.13.0 (2025-09-25)
+
+Full Changelog: [v0.12.0...v0.13.0](https://github.com/landing-ai/ade-python/compare/v0.12.0...v0.13.0)
+
+### Features
+
+* **api:** update README examples to support doccument_url as local path ([f31d6ca](https://github.com/landing-ai/ade-python/commit/f31d6cabfea19aa8f152e8030a0d7d256733f7a2))
+
+## 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)

{landingai_ade-0.11.1 → landingai_ade-0.13.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: landingai-ade
-Version: 0.11.1
+Version: 0.13.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
@@ -75,7 +75,7 @@ client = LandingAIADE(
 
 response = client.parse(
     # support document or document_url
-    document_url="https://va.landing.ai/pdfs/LabReport.pdf",
+    document_url="path/to/file",
     model="dpt-2-latest",
 )
 print(response.chunks)
@@ -128,7 +128,7 @@ client = AsyncLandingAIADE(
 
 async def main() -> None:
     response = await client.parse(
-        document_url="https://va.landing.ai/pdfs/LabReport.pdf",
+        document_url="path/to/file",
         model="dpt-2-latest",
     )
     print(response.chunks)
@@ -164,7 +164,7 @@ async def main() -> None:
         http_client=DefaultAioHttpClient(),
     ) as client:
         response = await client.parse(
-            document_url="https://va.landing.ai/pdfs/LabReport.pdf",
+            document_url="path/to/file",
             model="dpt-2-latest",
         )
         print(response.chunks)

{landingai_ade-0.11.1 → landingai_ade-0.13.0}/README.md

@@ -40,7 +40,7 @@ client = LandingAIADE(
 
 response = client.parse(
     # support document or document_url
-    document_url="https://va.landing.ai/pdfs/LabReport.pdf",
+    document_url="path/to/file",
     model="dpt-2-latest",
 )
 print(response.chunks)
@@ -93,7 +93,7 @@ client = AsyncLandingAIADE(
 
 async def main() -> None:
     response = await client.parse(
-        document_url="https://va.landing.ai/pdfs/LabReport.pdf",
+        document_url="path/to/file",
         model="dpt-2-latest",
     )
     print(response.chunks)
@@ -129,7 +129,7 @@ async def main() -> None:
         http_client=DefaultAioHttpClient(),
     ) as client:
         response = await client.parse(
-            document_url="https://va.landing.ai/pdfs/LabReport.pdf",
+            document_url="path/to/file",
             model="dpt-2-latest",
         )
         print(response.chunks)

{landingai_ade-0.11.1 → landingai_ade-0.13.0}/pyproject.toml

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

{landingai_ade-0.11.1 → landingai_ade-0.13.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.1 → landingai_ade-0.13.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.1"  # x-release-please-version
+__version__ = "0.13.0"  # x-release-please-version

landingai_ade-0.13.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.1/.release-please-manifest.json

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