Skip to main content

Istari Digital Client

The istari-digital-client library is a client SDK for interacting with the Istari Digital platform.

  • Install: pip install istari-digital-client
  • Documentation and Usage: Please see docs.istaridigital.com.
  • Supported Versions: This library supports Python 3.10, 3.11, 3.12, and 3.14
  • License: This library is released under an MIT license with the following clarification:

No license is hereby implied or granted to any patent or patent application relating to the Istari Digital platform itself. The list of patents applicable to the Istari Digital platform may be found at istaridigital.com/patent-list.

Direct S3 Upload

For environments with direct access to the backing S3 bucket, the client can bypass presigned URLs and upload via boto3 instead. This can improve throughput and simplifies large-file handling (boto3 manages multipart automatically).

Install the optional dependency:

# S3-compatible storage (minio, AWS, etc.)
pip install istari-digital-client[s3]

# AWS with high-speed CRT transfers (recommended for EC2 containers in same s3 environment as the data plane buckets)
pip install istari-digital-client[s3-crt]

Then configure via environment variables or constructor arguments:

Environment Variable Constructor Arg Description
ISTARI_CLIENT_S3_DIRECT_UPLOAD s3_direct_upload_enabled Set to true to enable direct S3 uploads
ISTARI_CLIENT_S3_BUCKET_NAME s3_bucket_name Target S3 bucket name (required when enabled)

Standard AWS credentials (environment variables, profile, or instance role) must be available for boto3 to authenticate.

Proxy Support

The client honors the conventional proxy environment variables — HTTP_PROXY, HTTPS_PROXY, ALL_PROXY, and NO_PROXY (upper or lower case; lowercase wins) — for all of its HTTP traffic, including presigned object-store downloads. No configuration is needed on a host that already has these set.

There are two common proxy shapes:

  • CONNECT tunneling (the proxy passes TLS through untouched): proxy settings alone are enough.
  • TLS termination (the proxy re-signs TLS with its own certificate authority): additionally provide the CA bundle that trusts the proxy's CA, via REQUESTS_CA_BUNDLE or SSL_CERT_FILE, or the ca_bundle setting. Certificate verification is always required — there is no insecure mode.
Environment Variable Constructor Arg Description
ISTARI_CLIENT_PROXY_URL proxy_url Explicit proxy for HTTP(S) traffic; overrides HTTP_PROXY/HTTPS_PROXY/ALL_PROXY. Credentials may be embedded (http://<user>:<password>@proxy:8080) and are sent as a Proxy-Authorization header.
ISTARI_CLIENT_CA_BUNDLE ca_bundle PEM CA bundle for TLS verification; overrides REQUESTS_CA_BUNDLE/SSL_CERT_FILE.
ISTARI_CLIENT_TRUST_ENV trust_env Set to false to ignore the proxy and CA environment variables entirely (explicit settings above still apply). Defaults to true.

NO_PROXY is honored with exact and dot-boundary suffix matching (NO_PROXY=internal.example bypasses the proxy for registry.internal.example), including when proxy_url is set explicitly. When the Istari control plane is reached over a direct route (for example a site-to-site VPN) while object storage requires the proxy, list the control-plane host in NO_PROXY.

SOCKS proxies are not supported: an explicit SOCKS proxy_url is rejected with an error, while a SOCKS URL arriving via environment variables (for example ALL_PROXY=socks5://...) is ignored with a warning and the client connects directly — it does not route traffic through the SOCKS proxy.

Contributing

See the contributing doc for additional info.

Download files

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

Source Distribution

istari_digital_client-13.0.0.tar.gz (574.5 kB view details)

Uploaded Source

Built Distribution

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

istari_digital_client-13.0.0-py3-none-any.whl (1.6 MB view details)

Uploaded Python 3

File details

Details for the file istari_digital_client-13.0.0.tar.gz.

File metadata

  • Download URL: istari_digital_client-13.0.0.tar.gz
  • Upload date:
  • Size: 574.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for istari_digital_client-13.0.0.tar.gz
Algorithm Hash digest
SHA256 f22cd3321fc51af79801d0e08ba6236d906ea9c01b9aac7f121a92cb174646d0
MD5 a2a3be8f690bf3e1be29ea1d23a30985
BLAKE2b-256 60326870203480a8aff2fee68f127aa4e55c4e33404e4cbe168141b74dbf730e

See more details on using hashes here.

Provenance

The following attestation bundles were made for istari_digital_client-13.0.0.tar.gz:

Publisher: release.yml on Istari-digital/istari-python-client

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file istari_digital_client-13.0.0-py3-none-any.whl.

File metadata

File hashes

Hashes for istari_digital_client-13.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 40e81269a30dcf370adb8e855cb5c247808b5de236ffbd884071f4ceea4e8ff0
MD5 1fc9198ee4553839fcfa3035f339df0c
BLAKE2b-256 42308f7d6014db1034a64d7de42c3b0715d18be496088deaad1725e0c337abcc

See more details on using hashes here.

Provenance

The following attestation bundles were made for istari_digital_client-13.0.0-py3-none-any.whl:

Publisher: release.yml on Istari-digital/istari-python-client

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

13.0.0 This release

2 files

12.0.0

2 files

11.2.0

2 files

11.1.0

2 files

11.0.0

2 files

10.14.0

2 files

10.11.1

2 files

10.11.0

2 files

10.10.5

2 files

10.10.3

2 files

10.10.2

2 files

10.10.1

2 files

10.10.0

2 files

10.9.5

2 files

10.9.4

2 files

10.9.2

2 files

10.8.6

2 files

10.8.4

2 files

10.8.2

2 files

10.7.0

2 files

10.6.0

2 files

10.5.0

2 files

10.4.0

2 files

10.3.1

2 files

10.3.0

2 files

10.2.0

2 files

10.1.0

2 files

10.0.0

2 files

9.0.0

2 files

8.0.1

2 files

8.0.0

2 files

7.21.2

2 files

7.21.1

2 files

7.20.1

2 files

7.20.0

2 files

7.19.3

2 files

7.19.2

2 files

7.19.1

2 files

7.19.0

2 files

7.18.1

2 files

7.18.0

2 files

7.17.0

2 files

7.16.1

2 files

7.16.0

2 files

7.15.1

2 files

7.15.0

2 files

7.14.0

2 files

7.13.0

2 files

7.12.0

2 files

7.11.0

2 files

7.10.0

2 files

7.9.0

2 files

7.8.0

2 files

7.7.0

2 files

7.6.2

2 files

7.6.1

2 files

7.6.0

2 files

7.5.0

2 files

7.4.0

2 files

7.3.7

2 files

7.3.6

2 files

7.3.5

2 files

7.3.4

2 files

7.3.3

2 files

7.3.2

2 files

7.3.1

2 files

7.3.0

2 files

7.2.0

2 files

7.0.0

2 files

6.5.1

2 files

6.5.0

2 files

6.4.0

2 files

6.3.0

2 files

6.2.0

2 files

6.0.4

2 files

Supported by

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