Add DocSplitterClient and GenericUnstractClient support

[jaseemjaskp]

Summary

This PR adds support for two new API patterns to the apihub-python-client:

1. Doc-splitter APIs - Job ID-based workflow for document splitting
2. Generic Unstract APIs - Execution ID-based workflow for dynamic endpoints

New Features

🔧 DocSplitterClient

• File upload with multipart form-data support
• Job status polling with configurable intervals
• Binary file download (zip files)
• Methods: upload(), get_job_status(), download_result(), wait_for_completion()
• Uses job_id for tracking operations

🚀 GenericUnstractClient

• Dynamic endpoint support (invoice, contract, receipt, etc.)
• Execution ID-based tracking
• Multipart form-data uploads with 'files' field
• Methods: process(), get_result(), wait_for_completion(), check_status()
• Uses execution_id for tracking operations

Implementation Details

• Consistent API Design: Both clients follow existing patterns for consistency
• Comprehensive Testing: 55 new tests added (94 total tests passing)
• Type Safety: Full type hints with proper error handling
• Documentation: Updated README with usage examples and complete API reference
• Error Handling: All clients share the same ApiHubClientException

API Examples

DocSplitterClient Usage

from apihub_client import DocSplitterClient

doc_client = DocSplitterClient(
    api_key="your-api-key",
    base_url="http://localhost:8005"
)

result = doc_client.upload(
    file_path="document.pdf",
    wait_for_completion=True
)

doc_client.download_result(
    job_id=result["job_id"],
    output_path="result.zip"
)

GenericUnstractClient Usage

from apihub_client import GenericUnstractClient

client = GenericUnstractClient(
    api_key="your-api-key",
    base_url="http://localhost:8005"
)

result = client.process(
    endpoint="invoice",
    file_path="invoice.pdf",
    wait_for_completion=True
)

Files Changed

• New Files:

  • src/apihub_client/doc_splitter.py - DocSplitterClient implementation
  • src/apihub_client/generic_client.py - GenericUnstractClient implementation
  • test/test_doc_splitter.py - DocSplitterClient tests (21 tests)
  • test/test_generic_client.py - GenericUnstractClient tests (34 tests)

• Modified Files:

  • src/apihub_client/__init__.py - Export new clients
  • README.md - Add usage examples and API documentation

Testing

• ✅ All 94 tests passing
• ✅ Comprehensive coverage of success/failure paths
• ✅ Performance benchmarks included
• ✅ Real-world usage scenarios tested
• ✅ Code formatting and linting checks pass
• ✅ Type checking passes

Backwards Compatibility

This PR is fully backwards compatible. Existing ApiHubClient functionality remains unchanged, and new clients are additive.

Summary

The client now supports all three API patterns:

• ApiHubClient: Original extract APIs with file_hash tracking
• DocSplitterClient: Doc-splitter APIs with job_id tracking
• GenericUnstractClient: Generic Unstract APIs with execution_id tracking

All functionality is production-ready with comprehensive testing and documentation.

[github-actions]

🧪 Test Report

Test Results

Test Environment

• Python Version: 3.12
• OS: Ubuntu Latest
• Tox Environment: py312

Status

✅ All tests passed successfully!