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.0
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.0.tar.gz | 34.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| icegraph_client-0.20.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 54.5 kB
Release files / icegraph_client-0.20.0.tar.gz
| Download URL | icegraph_client-0.20.0.tar.gz |
|---|---|
| Size | 34.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c86dc7967000ff20b83bdadbef808d952a3627a0821a144b852c157472eb225f
|
|
BLAKE2b-256 checksum How to use checksums |
8d55bb1c0338badb0cc333ad3ac9300279f39a384edf191800bae9a362394315
|
| 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.0-py3-none-any.whl
| Download URL | icegraph_client-0.20.0-py3-none-any.whl |
|---|---|
| Size | 20.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
4010ed7c261717cea41ca195a2461880dcf5448c59e9320ffea2b4da56b4d52b
|
|
BLAKE2b-256 checksum How to use checksums |
04989585a3285228e506965815656a22c025fe930b939f901f50441a772e5d58
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.3
|
