gmeow-gts 0.1.0

GTS (Graph Transport Substrate): a single-file CBOR transport for RDF 1.2 graphs — append-only log, BLAKE3 chain verification, deterministic fold, multi-segment cat-append composition.

gts — Graph Transport Substrate

A single-file, language-independent transport for an RDF 1.2 graph (statements and statement-level metadata) together with any content-addressed binary the graph references.

A GTS file is a CBOR Sequence of one or more segments, each an append-only log: a header followed by frames chained by BLAKE3 content-id. Composition is cat — concatenating valid GTS files yields a valid GTS file whose fold is the value-union of the segment graphs.

This package is the Python reference implementation of the GTS specification: reader (fold, chain verification, opaque degradation, torn-append detection), writer, COSE signing, N-Quads projection, and the frozen language-neutral conformance corpus. A Rust engine implementing the same spec is gated against the identical corpus and will ship inside this package as a native wheel.

Install

pip install gmeow-gts

The installed package name is gmeow-gts; the import name and CLI binary both remain gts, and GTS files keep the .gts extension.

Library

from pathlib import Path

import gts

graph = gts.read(Path("package.gts").read_bytes())
print(gts.to_nquads(graph))

Command line

gts info <file>...            per-segment composition ledger
gts fold <file>               fold to N-Quads on stdout
gts verify <file>...          verify chains; exit 1 on any diagnostic
gts cat -o <out> <file>...    validating composer: refuse degenerate inputs,
                              then byte-concatenate

cat output is the raw byte concatenation — validation added, transformation never. It refuses dirty inputs, contributes-nothing segments, and compositions whose suppressions hide every folded quad.

License

Apache-2.0. © Blackcat Informatics® Inc.