gcf-python 1.0.0__tar.gz → 1.0.1__tar.gz

{gcf_python-1.0.0 → gcf_python-1.0.1}/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## v1.0.1 (2026-06-10)
+
+- CLI: `encode-generic` and `decode-generic` subcommands for generic profile
+- CLI now supports both graph and generic profiles
+- `python -m gcf` entry point
+
 ## v1.0.0 (2026-06-10)
 
 SPEC v2.0 implementation. 126/133 conformance fixtures passing (7 skipped: session, delta, binary UTF-8, negative zero, graph encode). 40M property-based round-trips with zero failures.

{gcf_python-1.0.0 → gcf_python-1.0.1}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: gcf-python
-Version: 1.0.0
-Summary: Drop-in JSON replacement for AI pipelines. 79% fewer tokens. 90.5% comprehension across 10 models. Zero dependencies.
+Version: 1.0.1
+Summary: Drop-in JSON replacement for AI pipelines. 79% fewer tokens. 90.7% comprehension across 10 models. Zero dependencies.
 Project-URL: Homepage, https://github.com/blackwell-systems/gcf-python
 Project-URL: Documentation, https://blackwell-systems.github.io/gcf/
 Project-URL: Specification, https://github.com/blackwell-systems/gcf
@@ -32,7 +32,7 @@ Description-Content-Type: text/markdown
 
 Python implementation of [GCF](https://gcformat.com/) — the most token-efficient wire format for LLMs. A drop-in alternative to JSON and TOON for any structured data.
 
-**79% fewer input tokens than JSON. 63% fewer output tokens. 90.5% average comprehension accuracy across 10 models and 3 providers (four models hit 100%). 1,300+ LLM evaluations. Zero training.**
+**79% fewer input tokens than JSON. 63% fewer output tokens. 90.7% average comprehension accuracy across 10 models and 3 providers (four models hit 100%). 1,300+ LLM evaluations. Zero training.**
 
 Docs: [gcformat.com](https://gcformat.com/) · [Playground](https://gcformat.com/playground.html) · [GCF vs TOON](https://gcformat.com/guide/vs-toon.html)
 
@@ -210,7 +210,7 @@ Works on dicts, lists, and primitives. Lists of uniform dicts get tabular rows.
 
 | | GCF | TOON | JSON |
 |---|---|---|---|
-| **Comprehension** (23 runs, 10 models) | **90.5%** | 68.5% | 53.6% |
+| **Comprehension** (23 runs, 10 models) | **90.7%** | 68.5% | 53.6% |
 | **Generation** (28 runs, 9 models) | **5/5** | 1.0/5 | 5.0/5 |
 | **Input tokens** (500 symbols) | **11,090** | 16,378 | 53,341 |
 | **Output tokens** (100 symbols) | **5,976** | 8,937 | 16,121 |

{gcf_python-1.0.0 → gcf_python-1.0.1}/README.md

@@ -7,7 +7,7 @@
 
 Python implementation of [GCF](https://gcformat.com/) — the most token-efficient wire format for LLMs. A drop-in alternative to JSON and TOON for any structured data.
 
-**79% fewer input tokens than JSON. 63% fewer output tokens. 90.5% average comprehension accuracy across 10 models and 3 providers (four models hit 100%). 1,300+ LLM evaluations. Zero training.**
+**79% fewer input tokens than JSON. 63% fewer output tokens. 90.7% average comprehension accuracy across 10 models and 3 providers (four models hit 100%). 1,300+ LLM evaluations. Zero training.**
 
 Docs: [gcformat.com](https://gcformat.com/) · [Playground](https://gcformat.com/playground.html) · [GCF vs TOON](https://gcformat.com/guide/vs-toon.html)
 
@@ -185,7 +185,7 @@ Works on dicts, lists, and primitives. Lists of uniform dicts get tabular rows.
 
 | | GCF | TOON | JSON |
 |---|---|---|---|
-| **Comprehension** (23 runs, 10 models) | **90.5%** | 68.5% | 53.6% |
+| **Comprehension** (23 runs, 10 models) | **90.7%** | 68.5% | 53.6% |
 | **Generation** (28 runs, 9 models) | **5/5** | 1.0/5 | 5.0/5 |
 | **Input tokens** (500 symbols) | **11,090** | 16,378 | 53,341 |
 | **Output tokens** (100 symbols) | **5,976** | 8,937 | 16,121 |

{gcf_python-1.0.0 → gcf_python-1.0.1}/pyproject.toml

@@ -4,8 +4,8 @@ build-backend = "hatchling.build"
 
 [project]
 name = "gcf-python"
-version = "1.0.0"
-description = "Drop-in JSON replacement for AI pipelines. 79% fewer tokens. 90.5% comprehension across 10 models. Zero dependencies."
+version = "1.0.1"
+description = "Drop-in JSON replacement for AI pipelines. 79% fewer tokens. 90.7% comprehension across 10 models. Zero dependencies."
 readme = "README.md"
 license = {text = "MIT"}
 requires-python = ">=3.9"

gcf_python-1.0.1/src/gcf/__main__.py

@@ -0,0 +1,5 @@
+"""Allow running as `python -m gcf`."""
+
+from .cli import main
+
+main()

{gcf_python-1.0.0 → gcf_python-1.0.1}/src/gcf/cli.py

@@ -5,19 +5,25 @@ import sys
 
 from .decode import decode
 from .encode import encode
+from .decode_generic import decode_generic
+from .generic import encode_generic
 from .types import Edge, Payload, Symbol
 
 USAGE = """gcf - token-optimized wire format for LLM tool responses
 
 Usage:
-  gcf encode [file]    Encode JSON payload to GCF (stdin if no file)
-  gcf decode [file]    Decode GCF text to JSON (stdin if no file)
-  gcf stats  [file]    Compare token counts: JSON vs GCF (stdin if no file)
-  gcf version          Print version
+  gcf encode          [file]  Encode JSON graph payload to GCF (stdin if no file)
+  gcf decode          [file]  Decode GCF graph text to JSON (stdin if no file)
+  gcf encode-generic  [file]  Encode JSON to GCF generic profile (stdin if no file)
+  gcf decode-generic  [file]  Decode GCF generic text to JSON (stdin if no file)
+  gcf stats           [file]  Compare token counts: JSON vs GCF (stdin if no file)
+  gcf version                 Print version
 
 Examples:
   gcf encode < payload.json
   gcf decode < payload.gcf
+  echo '{"name":"Alice"}' | gcf encode-generic
+  echo 'GCF profile=generic\\nname=Alice' | gcf decode-generic
   gcf stats payload.json
 """
 
@@ -37,11 +43,18 @@ def main() -> None:
     elif cmd == "decode":
         data = _read_input(file_args)
         _do_decode(data)
+    elif cmd == "encode-generic":
+        data = _read_input(file_args)
+        _do_encode_generic(data)
+    elif cmd == "decode-generic":
+        data = _read_input(file_args)
+        _do_decode_generic(data)
     elif cmd == "stats":
         data = _read_input(file_args)
         _do_stats(data)
     elif cmd == "version":
-        print("gcf 0.1.0")
+        from . import __version__
+        print(f"gcf {__version__}")
     else:
         print(f"unknown command: {cmd}\n", file=sys.stderr)
         print(USAGE, file=sys.stderr, end="")
@@ -115,6 +128,20 @@ def _payload_to_json(p: Payload) -> str:
     return json.dumps(obj, indent=2)
 
 
+def _do_encode_generic(data: str) -> None:
+    try:
+        obj = json.loads(data)
+    except json.JSONDecodeError as e:
+        print(f"error: invalid JSON: {e}", file=sys.stderr)
+        sys.exit(1)
+    print(encode_generic(obj), end="")
+
+
+def _do_decode_generic(data: str) -> None:
+    result = decode_generic(data)
+    print(json.dumps(result))
+
+
 def _do_encode(data: str) -> None:
     try:
         p = _payload_from_json(data)