Skip to main content

🕸️ Iris Python Client

Tests Coverage PyPI

Minimalist Python client for the Iris API, built on top of Authlib and httpx.

Installation

pip install dioptra-iris-client

Usage

from iris_client import IrisClient, AsyncIrisClient

base_url = "https://api.iris.dioptra.io"
username = "user@example.org"
password = "password"

# Synchronous client
with IrisClient(base_url, username, password) as client:
    measurements = client.get("/measurements/").json()

# Asynchronous client
async with AsyncIrisClient(base_url, username, password) as client:
    measurements = (await client.get("/measurements/")).json()

# Helper function to fetch all the results from a paginated endpoint,
# available for both clients:
all_measurements = client.all("/measurements/")

Credential provider chain

The Iris client looks for credentials in a way similar to the AWS SDK:

  1. If one of base_url, username or password is specified, these values will be used.
  2. If none of the previous values are specified, and one of IRIS_BASE_URL, IRIS_USERNAME or IRIS_PASSWORD environment variables are present, these values will be used.
  3. If none of the previous values are specified, and the file ~/.config/iris/credentials.json exists, the fields base_url, username and password will be used.

Metadata

Release files for dioptra-iris-client 0.5.10

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for dioptra-iris-client 0.5.10
File Size Uploaded
dioptra_iris_client-0.5.10.tar.gz 3.6 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for dioptra-iris-client 0.5.10
File Interpreter ABI Platform
dioptra_iris_client-0.5.10-py3-none-any.whl Python 3 none any Details

Total release size: 8.5 kB

Release files / dioptra_iris_client-0.5.10.tar.gz

Download URL dioptra_iris_client-0.5.10.tar.gz
Size 3.6 kB
Tags Source
SHA-256 checksum
How to use checksums
d935de60e26c857597a6a53c57fb384a9c8677206e078cabbec31fd54793bb6a
BLAKE2b-256 checksum
How to use checksums
f8b9d8a9a4c5a97e4c7f484c41074d5eafc54491dc3ebed7ab9eb509a197e7f6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.8

Release files / dioptra_iris_client-0.5.10-py3-none-any.whl

Download URL dioptra_iris_client-0.5.10-py3-none-any.whl
Size 4.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
93bbde043c9124112eee21b6aa2f06920e0c6d766af22f4e244aec77a7db332c
BLAKE2b-256 checksum
How to use checksums
ee61261ddb9c08d0e1e90dae41320e41af69ff6d24d3689eb0bf237581903ee6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.8

Release history Release notifications | RSS feed

This release

0.5.10 This release

2 release files

0.5.9

2 release files

0.5.8

2 release files

0.5.7

2 release files

0.5.6

2 release files

0.5.5

2 release files

0.5.4

2 release files

0.5.3

2 release files

0.5.2

2 release files

0.5.1

2 release files

0.5.0

2 release files

0.4.5

2 release files

0.4.4

2 release files

0.4.3

2 release files

0.4.2

2 release files

0.4.1

2 release files

0.4.0

2 release files

0.3.0

2 release files

0.2.1

2 release files

0.2.0

2 release files

0.1.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page