oblidog-client
Python client for the Oblidog integration API.
Use the handwritten OblidogClient facade in application code. The
oblidog_client.generated namespace is OpenAPI-generated transport code and is
an implementation detail, not the recommended SDK API.
Installation
pip install oblidog-client
Usage
import datetime
from oblidog_client import OblidogClient
with OblidogClient(base_url="https://oblidog.example.com", api_key="fdg_live_...") as client:
with client.integrations.run() as run:
client.category_data.create(
observed_at=datetime.datetime.now(datetime.UTC),
data={"meter_reading_kwh": 1234.5},
)
run.finish_success(changes_detected=True)
The integration API key selects its integration and category. Use
client.integrations.run() around synchronization work: it reads context and
starts a run before the block, then reports a sanitized failure if the block
raises.
Documentation
The full documentation is published at oblidog.github.io/oblidog-client-python. It includes a quickstart, public API reference, and supported API boundary; it intentionally excludes generated endpoints and transport classes.
Development
This project uses uv for dependency and environment management. The low-level client is generated from the Oblidog Ledger integration OpenAPI contract; generated code should not be edited manually.
Use Commitizen to create Conventional Commit messages interactively, or to validate one non-interactively:
uv run cz commit
uv run cz check -m "feat: add a new capability"
Run the same distribution verification used by CI locally:
./scripts/verify-package.sh
The command builds the wheel and source distribution, validates their metadata and contents, installs the wheel into a clean environment, and checks the installed public API. It does not publish any artifacts.
Release maintainers should follow the Trusted Publishing setup and release procedure.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file oblidog_client-0.1.1.tar.gz.
File metadata
- Download URL: oblidog_client-0.1.1.tar.gz
- Upload date:
- Size: 110.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
9921280e8df2db27918cc41c94f91b41279e8384b4f0c3359f0492dac7497dca
|
|
| MD5 |
311c66198111e266051df4a1c3eee6c0
|
|
| BLAKE2b-256 |
9bad82383240fb315952870ccf158e88ac35d376424908e94f920e57cf40fd59
|
Provenance
The following attestation bundles were made for oblidog_client-0.1.1.tar.gz:
Publisher:
release.yml on oblidog/oblidog-client-python
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
oblidog_client-0.1.1.tar.gz -
Subject digest:
9921280e8df2db27918cc41c94f91b41279e8384b4f0c3359f0492dac7497dca - Sigstore transparency entry: 2797931230
- Sigstore integration time:
-
Permalink:
oblidog/oblidog-client-python@4b6b007ad3e33fce8fa7bcd25a316a69390c60de -
Branch / Tag:
refs/tags/v0.1.1 - Owner: https://github.com/oblidog
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@4b6b007ad3e33fce8fa7bcd25a316a69390c60de -
Trigger Event:
release
-
Statement type:
File details
Details for the file oblidog_client-0.1.1-py3-none-any.whl.
File metadata
- Download URL: oblidog_client-0.1.1-py3-none-any.whl
- Upload date:
- Size: 68.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
cf024e695c324acc76df6628e2af3347169cf96dd575609b9a8fd26effcfe7d0
|
|
| MD5 |
5ab6d2cfd5bf0dcefe7c2ad50ad7e2bd
|
|
| BLAKE2b-256 |
48c33fdd805733a962a74bb05877c07aed19705322b2b271f595445464e54093
|
Provenance
The following attestation bundles were made for oblidog_client-0.1.1-py3-none-any.whl:
Publisher:
release.yml on oblidog/oblidog-client-python
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
oblidog_client-0.1.1-py3-none-any.whl -
Subject digest:
cf024e695c324acc76df6628e2af3347169cf96dd575609b9a8fd26effcfe7d0 - Sigstore transparency entry: 2797931364
- Sigstore integration time:
-
Permalink:
oblidog/oblidog-client-python@4b6b007ad3e33fce8fa7bcd25a316a69390c60de -
Branch / Tag:
refs/tags/v0.1.1 - Owner: https://github.com/oblidog
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@4b6b007ad3e33fce8fa7bcd25a316a69390c60de -
Trigger Event:
release
-
Statement type:
