chunkr-ai 0.0.18__py3-none-any.whl → 0.0.20__py3-none-any.whl

chunkr_ai/api/decorators.py

@@ -1,7 +1,11 @@
 import functools
 import asyncio
 import httpx
-from typing import Callable, Any, TypeVar, Awaitable, ParamSpec, Union, overload
+from typing import Callable, Any, TypeVar, Awaitable, Union, overload
+try:
+    from typing import ParamSpec
+except ImportError:
+    from typing_extensions import ParamSpec
 
 T = TypeVar('T')
 P = ParamSpec('P')

{chunkr_ai-0.0.18.dist-info → chunkr_ai-0.0.20.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: chunkr-ai
-Version: 0.0.18
+Version: 0.0.20
 Summary: Python client for Chunkr: open source document intelligence
 Author-email: Ishaan Kapoor <ishaan@lumina.sh>
 Project-URL: Homepage, https://chunkr.ai
@@ -33,7 +33,7 @@ pip install chunkr-ai
 
 ## Usage
 
-We provide two clients: `Chunkr` for synchronous operations and `ChunkrAsync` for asynchronous operations.
+The `Chunkr` client works seamlessly in both synchronous and asynchronous contexts.
 
 ### Synchronous Usage
 
@@ -45,62 +45,86 @@ chunkr = Chunkr()
 
 # Upload a file and wait for processing
 task = chunkr.upload("document.pdf")
+print(task.task_id)
 
-# Print the response
-print(task)
+# Create task without waiting
+task = chunkr.create_task("document.pdf")
+result = task.poll()  # Check status when needed
 
-# Get output from task
-output = task.output
-
-# If you want to upload without waiting for processing
-task = chunkr.start_upload("document.pdf")
-# ... do other things ...
-task.poll()  # Check status when needed
+# Clean up when done
+chunkr.close()
 ```
 
 ### Asynchronous Usage
 
 ```python
-from chunkr_ai import ChunkrAsync
+from chunkr_ai import Chunkr
+import asyncio
 
 async def process_document():
     # Initialize client
-    chunkr = ChunkrAsync()
+    chunkr = Chunkr()
+
+    try:
+        # Upload a file and wait for processing
+        task = await chunkr.upload("document.pdf")
+        print(task.task_id)
+
+        # Create task without waiting
+        task = await chunkr.create_task("document.pdf")
+        result = await task.poll()  # Check status when needed
+    finally:
+        await chunkr.close()
 
-    # Upload a file and wait for processing
-    task = await chunkr.upload("document.pdf")
+# Run the async function
+asyncio.run(process_document())
+```
 
-    # Print the response
-    print(task)
+### Concurrent Processing
 
-    # Get output from task
-    output = task.output
+The client supports both async concurrency and multiprocessing:
 
-    # If you want to upload without waiting for processing
-    task = await chunkr.start_upload("document.pdf")
-    # ... do other things ...
-    await task.poll()  # Check status when needed
+```python
+# Async concurrency
+async def process_multiple():
+    chunkr = Chunkr()
+    try:
+        tasks = [
+            chunkr.upload("doc1.pdf"),
+            chunkr.upload("doc2.pdf"),
+            chunkr.upload("doc3.pdf")
+        ]
+        results = await asyncio.gather(*tasks)
+    finally:
+        await chunkr.close()
+
+# Multiprocessing
+from multiprocessing import Pool
+
+def process_file(path):
+    chunkr = Chunkr()
+    try:
+        return chunkr.upload(path)
+    finally:
+        chunkr.close()
+
+with Pool(processes=3) as pool:
+    results = pool.map(process_file, ["doc1.pdf", "doc2.pdf", "doc3.pdf"])
 ```
 
-### Additional Features
+### Input Types
 
-Both clients support various input types:
+The client supports various input types:
 
 ```python
-# Upload from file path
+# File path
 chunkr.upload("document.pdf")
 
-# Upload from opened file
+# Opened file
 with open("document.pdf", "rb") as f:
     chunkr.upload(f)
 
-# Upload from URL
-chunkr.upload("https://example.com/document.pdf")
-
-# Upload from base64 string
-chunkr.upload("data:application/pdf;base64,JVBERi0xLjcKCjEgMCBvYmo...")
-
-# Upload an image
+# PIL Image
 from PIL import Image
 img = Image.open("photo.jpg")
 chunkr.upload(img)
@@ -111,9 +135,13 @@ chunkr.upload(img)
 You can customize the processing behavior by passing a `Configuration` object:
 
 ```python
-from chunkr_ai.models import Configuration, OcrStrategy, SegmentationStrategy, GenerationStrategy
+from chunkr_ai.models import (
+    Configuration, 
+    OcrStrategy, 
+    SegmentationStrategy, 
+    GenerationStrategy
+)
 
-# Basic configuration
 config = Configuration(
     ocr_strategy=OcrStrategy.AUTO,
     segmentation_strategy=SegmentationStrategy.LAYOUT_ANALYSIS,
@@ -121,8 +149,9 @@ config = Configuration(
     expires_in=3600,  # seconds
 )
 
-# Upload with configuration
-task = chunkr.upload("document.pdf", config)
+# Works in both sync and async contexts
+task = chunkr.upload("document.pdf", config)  # sync
+task = await chunkr.upload("document.pdf", config)  # async
 ```
 
 #### Available Configuration Examples
@@ -180,7 +209,7 @@ task = chunkr.upload("document.pdf", config)
   )
   ```
 
-## Environment setup
+## Environment Setup
 
 You can provide your API key and URL in several ways:
 1. Environment variables: `CHUNKR_API_KEY` and `CHUNKR_URL`
@@ -192,3 +221,24 @@ chunkr = Chunkr(
     url="https://api.chunkr.ai"
 )
 ```
+
+## Resource Management
+
+It's recommended to properly close the client when you're done:
+
+```python
+# Sync context
+chunkr = Chunkr()
+try:
+    result = chunkr.upload("document.pdf")
+finally:
+    chunkr.close()
+
+# Async context
+async def process():
+    chunkr = Chunkr()
+    try:
+        result = await chunkr.upload("document.pdf")
+    finally:
+        await chunkr.close()
+```

{chunkr_ai-0.0.18.dist-info → chunkr_ai-0.0.20.dist-info}/RECORD

@@ -6,12 +6,12 @@ chunkr_ai/api/auth.py,sha256=hlv0GiUmlsbFO1wLL9sslqOnsBSoBqkL_6Mk2SDvxgE,413
 chunkr_ai/api/chunkr.py,sha256=V56SP8qs7J2QKRCRM9NGlyA1TtDTdFmGYZWbwbFTK_I,2674
 chunkr_ai/api/chunkr_base.py,sha256=TDqEwCCfgshggi_Mzv76FhPj5z21QP8EVj7siczvfao,9826
 chunkr_ai/api/config.py,sha256=NmPTsDvcjkvNx0gNzDTz-oFG5rQC7jm-H70O_crJCw8,4478
-chunkr_ai/api/decorators.py,sha256=PzaTaPBXUMHoSLz6P0sL5JXANFSJff2vjvESKNiOGQY,2566
+chunkr_ai/api/decorators.py,sha256=UD3Nb0b5EKcwGH2kXb9FPn4GtnJovheoHeF_Gi7WFGk,2657
 chunkr_ai/api/misc.py,sha256=wUG4SpfEEo7NcVK47gmw42dRy9zT5F9S2DtVC4T4ERs,4877
 chunkr_ai/api/protocol.py,sha256=Nt8aWr4ouVwCvoLqVI5vnXJhT2cvxt0sQC-svUk2G5w,458
 chunkr_ai/api/task_response.py,sha256=I0_XJ6WYYu_TwbaSF95wqRPaOm2PhgMKnarxjAx-BZI,3857
-chunkr_ai-0.0.18.dist-info/LICENSE,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-chunkr_ai-0.0.18.dist-info/METADATA,sha256=U9774MiX43ALUNaQRS6y05Kcg4q8REMVu5lyds1DJUo,4807
-chunkr_ai-0.0.18.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
-chunkr_ai-0.0.18.dist-info/top_level.txt,sha256=0IZY7PZIiS8bw5r4NUQRUQ-ATi-L_3vLQVq3ZLouOW8,10
-chunkr_ai-0.0.18.dist-info/RECORD,,
+chunkr_ai-0.0.20.dist-info/LICENSE,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+chunkr_ai-0.0.20.dist-info/METADATA,sha256=owGbM-pt3qbWboqgyMgRimUtOdQrsDHx8RHebIKhFZM,5696
+chunkr_ai-0.0.20.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
+chunkr_ai-0.0.20.dist-info/top_level.txt,sha256=0IZY7PZIiS8bw5r4NUQRUQ-ATi-L_3vLQVq3ZLouOW8,10
+chunkr_ai-0.0.20.dist-info/RECORD,,