hgraph-persistence

Durable record/replay and frame storage for hgraph (RFC 0025): the FrameStore (memory / local filesystem / S3, Arrow IPC / Parquet), the frame-backed record/replay/compare overloads for the core operator markers, and the DataFrameStorage compatibility surface.

The public C++ ObjectStore is the durable metadata substrate shared by checkpoint/recovery and the versioned dataflow fabric. It provides:

  • immutable create-if-absent with distinct created, idempotent, and conflict outcomes;
  • typed absent reads carrying an opaque version token when present, with backend failures reported separately as ObjectStoreError;
  • deterministic lexicographic prefix paging;
  • compare/exchange for small named references; and
  • memory, local-filesystem, and S3 strategies behind one owning erased handle.

Local immutable publication uses atomic filesystem creation and reference CAS uses cross-process file locking plus atomic replacement. S3 conditional writes are sent with If-None-Match / If-Match and AWS Signature V4 through libcurl; they are not emulated with a read followed by an unconditional write. FrameStore immutable local and S3 writes use this same backend publication path after serialising the Frame. This requires one additional serialized-Frame-sized buffer for an immutable local or S3 write; mutable FrameStore writes retain their streaming path.

Wheel builds embed a pinned private curl for conditional S3 requests. A shared hgraph::persistence library carries that implementation itself; consumers of a static installed C++ library must provide CURL::libcurl version 7.75 or newer at the final link.

Installing and importing hgraph_persistence registers the "hgraph.persistence.frame" backend with the shared hgraph runtime; selecting that backend (set_record_replay_config) activates it from unchanged hgraph imports.

Runnable Python examples for direct record/replay, transparent component modes, and keyed time-series storage are in python/examples.

Project links

Data verified by PyPI on Sep 1, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.8.22)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for hhenson from gravatar.com hhenson

GitHub Statistics

Data verified by PyPI on Sep 1, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

MIT

Requires

Python >=3.12

Provides Extra

test

Report project as malware

Download files

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

Source Distribution

hgraph_persistence-0.8.21.tar.gz (112.2 kB view details)

Uploaded Source

Built Distributions

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

hgraph_persistence-0.8.21-cp312-abi3-win_amd64.whl (590.7 kB view details)

Uploaded CPython 3.12+Windows x86-64

hgraph_persistence-0.8.21-cp312-abi3-manylinux_2_28_x86_64.whl (2.5 MB view details)

Uploaded CPython 3.12+manylinux: glibc 2.28+ x86-64

hgraph_persistence-0.8.21-cp312-abi3-macosx_15_0_arm64.whl (251.9 kB view details)

Uploaded CPython 3.12+macOS 15.0+ ARM64

File details

Details for the file hgraph_persistence-0.8.21.tar.gz.

File metadata

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

File hashes

Hashes for hgraph_persistence-0.8.21.tar.gz
Algorithm Hash digest
SHA256 b7f1ebbc92f7401150165fc86b9a9968a2a4b0e1a72f3acde3c9af0daecc5b5e
MD5 339d5c52047188258fb5d0a07be39765
BLAKE2b-256 98595563851e752134df44bd66fabc714e008fc7133bec467eafcb77e4a6e696

See more details on using hashes here.

Provenance

The following attestation bundles were made for hgraph_persistence-0.8.21.tar.gz:

Publisher: release-wheels.yml on hhenson/hgraph

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

File details

Details for the file hgraph_persistence-0.8.21-cp312-abi3-win_amd64.whl.

File metadata

File hashes

Hashes for hgraph_persistence-0.8.21-cp312-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 7dd985ed0847b61f295bb31d5297f93d8ba09089076e0f31c73ce0c1ee59f733
MD5 80207aae1c7295a17cd479f9f5c54441
BLAKE2b-256 15c5f488a2fa56ebbeaf1787cf5ada6e115b3e38bf80555aa1043176265edca1

See more details on using hashes here.

Provenance

The following attestation bundles were made for hgraph_persistence-0.8.21-cp312-abi3-win_amd64.whl:

Publisher: release-wheels.yml on hhenson/hgraph

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

File details

Details for the file hgraph_persistence-0.8.21-cp312-abi3-manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for hgraph_persistence-0.8.21-cp312-abi3-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 baadd58d5073d879ef83d2beff478c3b111fe61882ab09b485431fe49fab5a0d
MD5 3110d4988e6798d6a24d8d4300155d07
BLAKE2b-256 90032305ae032b602f4a685a3d65a965b37ec8582bc7ae5e269e0e7f03c9d6d5

See more details on using hashes here.

Provenance

The following attestation bundles were made for hgraph_persistence-0.8.21-cp312-abi3-manylinux_2_28_x86_64.whl:

Publisher: release-wheels.yml on hhenson/hgraph

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

File details

Details for the file hgraph_persistence-0.8.21-cp312-abi3-macosx_15_0_arm64.whl.

File metadata

File hashes

Hashes for hgraph_persistence-0.8.21-cp312-abi3-macosx_15_0_arm64.whl
Algorithm Hash digest
SHA256 cfa6261bf44b8706c0611365216683a737113a7fb01f2539e7568beb2028a95b
MD5 020b215cc5009fec660d059de0d8e847
BLAKE2b-256 43ebeaa15e3cef9fbf6f958886f2871f0d8e3e8aac429f2be74c07cc2d31683d

See more details on using hashes here.

Provenance

The following attestation bundles were made for hgraph_persistence-0.8.21-cp312-abi3-macosx_15_0_arm64.whl:

Publisher: release-wheels.yml on hhenson/hgraph

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

Release history Release notifications | RSS feed

0.8.22

4 files

This release

0.8.21 This release

4 files

0.8.20

4 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