icegraph-client
Python client and CLI for the IceGraph server API - script access to tables, snapshot history, and the metadata graph.
Install
icegraph-client is only guaranteed compatible with the exact version of the IceGraph server it talks to - pin to that version:
pip install icegraph-client==<version>
CLI
icegraph --base-url http://<icegraph-server-host> tables
icegraph --base-url http://<icegraph-server-host> snapshots <database.table> [--before-snapshot-id ID]
icegraph --base-url http://<icegraph-server-host> metadata <database.table>
icegraph --base-url http://<icegraph-server-host> graph <database.table> [--start-snapshot-id ID] [--end-snapshot-id ID]
--base-url also falls back to the ICEGRAPH_BASE_URL environment variable. If your server sits behind a proxy that requires auth, pass --token/--cookie (or ICEGRAPH_TOKEN/ICEGRAPH_COOKIE).
Each command prints its result as JSON on stdout; status messages go to stderr, so output pipes cleanly.
snapshots returns one page, starting from the table's newest snapshots, as {"snapshots": [...], "next_before_snapshot_id": ...}. Pass next_before_snapshot_id as --before-snapshot-id to get the next older page; it is null when no older snapshots remain.
Python
from icegraph_client import IceGraphClient
client = IceGraphClient("http://<icegraph-server-host>")
client.list_tables()
page = client.get_snapshot_map("database.table")
if page.next_before_snapshot_id is not None: # None when no older snapshots remain
client.get_snapshot_map("database.table", before_snapshot_id=page.next_before_snapshot_id)
client.get_table_metadata("database.table")
client.get_graph("database.table", start_snapshot_id, end_snapshot_id)
Docs
Product page: https://yanivzalach.github.io/IceGraph-Site/
Full documentation, the IceGraph application, and the source code: github.com/YanivZalach/IceGraph
License
icegraph-client is licensed under the
GNU Affero General Public License version 3 only.
Copyright (c) 2026 Yaniv Zalach and the IceGraph contributors.
1 maintainer
Metadata
1 maintainer
Release files for icegraph-client 0.20.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| icegraph_client-0.20.1.tar.gz | 34.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| icegraph_client-0.20.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 54.5 kB
Release files / icegraph_client-0.20.1.tar.gz
| Download URL | icegraph_client-0.20.1.tar.gz |
|---|---|
| Size | 34.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
dc128ba7670773c58d98e0bb87fdb681409e32c6fed7e329f83eadb53e8fb932
|
|
BLAKE2b-256 checksum How to use checksums |
ac9c0a0286f2e3ec7ba88fd8c38e907797e3d9ccc07db639abdb2480163acc31
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.3
|
Release files / icegraph_client-0.20.1-py3-none-any.whl
| Download URL | icegraph_client-0.20.1-py3-none-any.whl |
|---|---|
| Size | 20.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
89586625222bdb84a330a564cbf1bab13357e5bd36bf3f34ae715ea86041ef67
|
|
BLAKE2b-256 checksum How to use checksums |
d6ae46778e9027788ed55eb380c949dc0535238c68e34ef77b453965c6e1262a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.3
|
