Skip to content

v0.5.0: Full round-trip + Generic streaming

Choose a tag to compare

@blackwell-systems blackwell-systems released this 06 Jun 06:04
· 101 commits to main since this release

What's new

decode_generic

Parse any GCF text back to native Python values. Works with both generic profile and graph profile payloads. Full round-trip: encode_generic -> GCF -> decode_generic.

from gcf import decode_generic

result = decode_generic(gcf_text)
# Returns dict, list, or primitives

GenericStreamEncoder

Zero-buffering streaming encoder for the generic profile. Write rows as data arrives with O(1) memory per row.

from gcf import GenericStreamEncoder

enc = GenericStreamEncoder(stream)
enc.begin_array('users', ['name', 'email', 'role'])
enc.write_row(['alice', 'alice@co.com', 'admin'])
enc.write_row(['bob', 'bob@co.com', 'user'])
enc.end_array()
enc.close()  # emits ## _summary trailer

Also in this release

  • Repositioned as drop-in JSON replacement for AI pipelines
  • Generic profile documentation leads all examples

Full changelog: v0.4.0...v0.5.0