Skip to main content

Python Client SDK Generated by Speakeasy

Project description

Python SDK for the Unstructured API

This is a Python client for the Unstructured API.

SDK Installation

pip install unstructured-client

Usage

Only the files parameter is required. See the general partition page for all available parameters. 

from unstructured_client import UnstructuredClient
from unstructured_client.models import shared

# Note - in an upcoming release, the Security object is removed
# You'll pass the api key directly
s = UnstructuredClient(
    security=shared.Security(
        api_key_auth="YOUR_API_KEY",
    ),
)

filename = "/path/to/document"

with open(filename, "rb") as f:
    req = shared.PartitionParameters(
        files=shared.PartitionParametersFiles(
            content=f.read(),
            files=filename,
        )
    )
    
    res = s.general.partition(req)

    if res.partition_200_application_json_any is not None:
      # handle response

Change the base URL

If you are self hosting the API, or developing locally, you can change the server URL when setting up the client.

s = UnstructuredClient()

# Using a local server
s.config_server_url("http://localhost:8000")

# Using your own server
s.config_server_url("https://my-hosted-api")

SDK Example Usage

import unstructured_client
from unstructured_client.models import shared

s = unstructured_client.UnstructuredClient(
    security=shared.Security(
        api_key_auth="YOUR_API_KEY",
    ),
)

req = shared.PartitionParameters(
    coordinates=False,
    encoding='utf-8',
    files=shared.PartitionParametersFiles(
        content='distinctio'.encode(),
        files='quibusdam',
    ),
    gz_uncompressed_content_type='application/pdf',
    hi_res_model_name='yolox',
    include_page_breaks=False,
    ocr_languages=[
        'eng',
    ],
    output_format='application/json',
    pdf_infer_table_structure=False,
    skip_infer_table_types=[
        'pdf',
    ],
    strategy='hi_res',
    xml_keep_tags=False,
)

res = s.general.partition(req)

if res.elements is not None:
    # handle response

Available Resources and Operations

General

Pagination

Some of the endpoints in this SDK support pagination. To use pagination, you make your SDK calls as usual, but the returned response object will have a Next method that can be called to pull down the next group of results. If the return value of Next is None, then there are no more pages to be fetched.

Here's an example of one such pagination call:

Maturity

This SDK is in beta, and there may be breaking changes between versions without a major version update. Therefore, we recommend pinning usage to a specific package version. This way, you can install the same version each time without breaking changes unless you are intentionally looking for the latest version.

Contributions

While we value open-source contributions to this SDK, this library is generated programmatically. Feel free to open a PR or a Github issue as a proof of concept and we'll do our best to include it in a future release!

SDK Created by Speakeasy

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

unstructured-client-0.5.1.tar.gz (15.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

unstructured_client-0.5.1-py3-none-any.whl (19.0 kB view details)

Uploaded Python 3

File details

Details for the file unstructured-client-0.5.1.tar.gz.

File metadata

  • Download URL: unstructured-client-0.5.1.tar.gz
  • Upload date:
  • Size: 15.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.9.18

File hashes

Hashes for unstructured-client-0.5.1.tar.gz
Algorithm Hash digest
SHA256 c639326ecb3da6de47213d4cd7356c2a0c7529b236f5685625e93de81e74e5b4
MD5 c79fea3a13d3f851666daa15098d8410
BLAKE2b-256 4d53185f98b48abeaafd71a0c3c2fa7ed3fa923442852535393cd9e3b323118a

See more details on using hashes here.

File details

Details for the file unstructured_client-0.5.1-py3-none-any.whl.

File metadata

File hashes

Hashes for unstructured_client-0.5.1-py3-none-any.whl
Algorithm Hash digest
SHA256 2acd952b84f643c343cf5668b58d48f984098d96a0a5bc00a1fbb2227b616632
MD5 09e0b006190d506db95d6dca38bfab06
BLAKE2b-256 45a0fc87da468b1d4917dcefad6b1db848cc3d2796dc1f4a601986b540dc8bdf

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page