gcf-python 2.1.0__tar.gz → 2.1.1__tar.gz

{gcf_python-2.1.0 → gcf_python-2.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gcf-python
-Version: 2.1.0
+Version: 2.1.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/
@@ -217,26 +217,26 @@ Works on dicts, lists, and primitives. Lists of uniform dicts get tabular rows.
 
 GCF wins 13/15 datasets on the expanded [token efficiency benchmark](https://github.com/blackwell-systems/toon/tree/gcf-comparison). Full results: [gcformat.com/guide/benchmarks](https://gcformat.com/guide/benchmarks.html)
 
-## Links
-
-- [Documentation](https://gcformat.com/)
-- [Playground](https://gcformat.com/playground.html)
-- [Specification](https://github.com/blackwell-systems/gcf)
-- [Go library](https://github.com/blackwell-systems/gcf-go)
-- [TypeScript library](https://github.com/blackwell-systems/gcf-typescript)
-- [MCP Proxy](https://github.com/blackwell-systems/gcf-proxy) (zero-code adoption)
-- [GCF vs TOON](https://gcformat.com/guide/vs-toon.html)
-- [TOON benchmark fork](https://github.com/blackwell-systems/toon/tree/gcf-comparison)
-
-
-<details>
-<summary>More links</summary>
-
-- [betterthanjson.com](https://betterthanjson.com)
-- [jsonalternative.com](https://jsonalternative.com)
-- [betterthantoon.com](https://betterthantoon.com)
-
-</details>
+## Implementations
+
+| Language | Package | Repository |
+|----------|---------|-----------|
+| Go | `go get github.com/blackwell-systems/gcf-go` | [gcf-go](https://github.com/blackwell-systems/gcf-go) |
+| TypeScript | `npm install @blackwell-systems/gcf` | [gcf-typescript](https://github.com/blackwell-systems/gcf-typescript) |
+| Python | `pip install gcf-python` | [gcf-python](https://github.com/blackwell-systems/gcf-python) |
+| Rust | `cargo add gcf` | [gcf-rust](https://github.com/blackwell-systems/gcf-rust) |
+| Swift | Swift Package Manager | [gcf-swift](https://github.com/blackwell-systems/gcf-swift) |
+| Kotlin | JitPack | [gcf-kotlin](https://github.com/blackwell-systems/gcf-kotlin) |
+| MCP Proxy | `pip install gcf-proxy` | [gcf-proxy](https://github.com/blackwell-systems/gcf-proxy) (bidirectional, session dedup, HTTP frontend) |
+| Claude Code Plugin | `/plugin install` | [gcf-claude-plugin](https://github.com/blackwell-systems/gcf-claude-plugin) (one-command install, session stats hook) |
+| Codex Plugin | `codex plugin add` | [gcf-codex-plugin](https://github.com/blackwell-systems/gcf-codex-plugin) (one-command install, session stats hook) |
+| VS Code | `ext install blackwell-systems.gcf-vscode` | [gcf-vscode](https://marketplace.visualstudio.com/items?itemName=blackwell-systems.gcf-vscode) (syntax highlighting) |
+| n8n | `npm install n8n-nodes-gcf` | [gcf-n8n-nodes](https://github.com/blackwell-systems/gcf-n8n-nodes) (workflow encode/decode) |
+| Tree-sitter | `npm install tree-sitter-gcf` | [tree-sitter-gcf](https://github.com/blackwell-systems/tree-sitter-gcf) |
+
+Zero runtime dependencies. MIT licensed. All implementations support both generic profile (`encodeGeneric`) and graph profile (`encode`). CLI included in all 6 languages.
+
+**Specification:** [SPEC v3.1 Stable](https://github.com/blackwell-systems/gcf/blob/main/SPEC.md) with 157 conformance fixtures, 33,000,000,000+ lossless round-trips verified across 5 formats and 6 languages. All implementations at v2.1.0+ (Go v1.2.0). Cross-language 6x6 matrix verified.
 
 ## License
 

{gcf_python-2.1.0 → gcf_python-2.1.1}/README.md

@@ -192,26 +192,26 @@ Works on dicts, lists, and primitives. Lists of uniform dicts get tabular rows.
 
 GCF wins 13/15 datasets on the expanded [token efficiency benchmark](https://github.com/blackwell-systems/toon/tree/gcf-comparison). Full results: [gcformat.com/guide/benchmarks](https://gcformat.com/guide/benchmarks.html)
 
-## Links
-
-- [Documentation](https://gcformat.com/)
-- [Playground](https://gcformat.com/playground.html)
-- [Specification](https://github.com/blackwell-systems/gcf)
-- [Go library](https://github.com/blackwell-systems/gcf-go)
-- [TypeScript library](https://github.com/blackwell-systems/gcf-typescript)
-- [MCP Proxy](https://github.com/blackwell-systems/gcf-proxy) (zero-code adoption)
-- [GCF vs TOON](https://gcformat.com/guide/vs-toon.html)
-- [TOON benchmark fork](https://github.com/blackwell-systems/toon/tree/gcf-comparison)
-
-
-<details>
-<summary>More links</summary>
-
-- [betterthanjson.com](https://betterthanjson.com)
-- [jsonalternative.com](https://jsonalternative.com)
-- [betterthantoon.com](https://betterthantoon.com)
-
-</details>
+## Implementations
+
+| Language | Package | Repository |
+|----------|---------|-----------|
+| Go | `go get github.com/blackwell-systems/gcf-go` | [gcf-go](https://github.com/blackwell-systems/gcf-go) |
+| TypeScript | `npm install @blackwell-systems/gcf` | [gcf-typescript](https://github.com/blackwell-systems/gcf-typescript) |
+| Python | `pip install gcf-python` | [gcf-python](https://github.com/blackwell-systems/gcf-python) |
+| Rust | `cargo add gcf` | [gcf-rust](https://github.com/blackwell-systems/gcf-rust) |
+| Swift | Swift Package Manager | [gcf-swift](https://github.com/blackwell-systems/gcf-swift) |
+| Kotlin | JitPack | [gcf-kotlin](https://github.com/blackwell-systems/gcf-kotlin) |
+| MCP Proxy | `pip install gcf-proxy` | [gcf-proxy](https://github.com/blackwell-systems/gcf-proxy) (bidirectional, session dedup, HTTP frontend) |
+| Claude Code Plugin | `/plugin install` | [gcf-claude-plugin](https://github.com/blackwell-systems/gcf-claude-plugin) (one-command install, session stats hook) |
+| Codex Plugin | `codex plugin add` | [gcf-codex-plugin](https://github.com/blackwell-systems/gcf-codex-plugin) (one-command install, session stats hook) |
+| VS Code | `ext install blackwell-systems.gcf-vscode` | [gcf-vscode](https://marketplace.visualstudio.com/items?itemName=blackwell-systems.gcf-vscode) (syntax highlighting) |
+| n8n | `npm install n8n-nodes-gcf` | [gcf-n8n-nodes](https://github.com/blackwell-systems/gcf-n8n-nodes) (workflow encode/decode) |
+| Tree-sitter | `npm install tree-sitter-gcf` | [tree-sitter-gcf](https://github.com/blackwell-systems/tree-sitter-gcf) |
+
+Zero runtime dependencies. MIT licensed. All implementations support both generic profile (`encodeGeneric`) and graph profile (`encode`). CLI included in all 6 languages.
+
+**Specification:** [SPEC v3.1 Stable](https://github.com/blackwell-systems/gcf/blob/main/SPEC.md) with 157 conformance fixtures, 33,000,000,000+ lossless round-trips verified across 5 formats and 6 languages. All implementations at v2.1.0+ (Go v1.2.0). Cross-language 6x6 matrix verified.
 
 ## License
 

{gcf_python-2.1.0 → gcf_python-2.1.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "gcf-python"
-version = "2.1.0"
+version = "2.1.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"}

{gcf_python-2.1.0 → gcf_python-2.1.1}/src/gcf/decode_generic.py

@@ -151,6 +151,17 @@ def _parse_object_body(
             i += consumed
             continue
 
+        # Key=value. Check before inline array so bracket patterns in quoted
+        # values (e.g. text="ERR[404]: Not Found") are not misinterpreted.
+        eq_idx = _find_kv_split(content)
+        if eq_idx > 0:
+            name = _parse_key_from_header(content[:eq_idx])
+            _check_dup(out, name)
+            out[name] = parse_scalar(content[eq_idx + 1:])
+            i += 1
+            continue
+
+        # Inline array (e.g. items[3]: a,b,c). Only reached if no = found.
         if not content.startswith("@") and not content.startswith("##"):
             bracket_idx = content.find("[")
             if bracket_idx > 0:
@@ -166,14 +177,6 @@ def _parse_object_body(
                         i += 1
                         continue
 
-        eq_idx = _find_kv_split(content)
-        if eq_idx > 0:
-            name = _parse_key_from_header(content[:eq_idx])
-            _check_dup(out, name)
-            out[name] = parse_scalar(content[eq_idx + 1:])
-            i += 1
-            continue
-
         i += 1
     return i - start
 
@@ -191,7 +194,13 @@ def _find_kv_split(s: str) -> int:
                 return i + 1 if i + 1 < len(s) and s[i + 1] == "=" else -1
             i += 1
         return -1
-    return s.find("=")
+    eq_idx = s.find("=")
+    if eq_idx < 0:
+        return -1
+    bracket_idx = s.find("[")
+    if bracket_idx >= 0 and bracket_idx < eq_idx:
+        return -1
+    return eq_idx
 
 
 def _parse_key_from_header(s: str) -> str:

{gcf_python-2.1.0 → gcf_python-2.1.1}/src/gcf/scalar.py

@@ -8,6 +8,7 @@ from typing import Any
 
 _JSON_NUMBER_RE = re.compile(r"^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$")
 _NUMERIC_LIKE_RE = re.compile(r"^[+-]\.?\d|^\.\d|^0\d")
+_INLINE_ARRAY_RE = re.compile(r"\[[^\]]*\]\s*:")
 _BARE_KEY_RE = re.compile(r"^[a-zA-Z_][a-zA-Z0-9_]*$")
 
 
@@ -36,6 +37,8 @@ def needs_quote(s: str) -> bool:
         return True
     if s[0] in ("#", "@", "."):
         return True
+    if _INLINE_ARRAY_RE.search(s):
+        return True
     for c in s:
         o = ord(c)
         if c in ('"', "\\", "|", ",") or o < 0x20 or c in ("\n", "\r"):

{gcf_python-2.1.0 → gcf_python-2.1.1}/tests/test_conformance_v2.py

@@ -97,6 +97,16 @@ def test_conformance(rel_path, data):
             _json_norm(data["expected"]), _json_norm(got)
         ), f"decode mismatch:\n  got: {got}\n  exp: {data['expected']}"
 
+    elif op == "roundtrip":
+        # Encode, verify GCF output matches expected, then decode and verify round-trip.
+        got = encode_generic(data["input"])
+        if isinstance(data["expected"], str):
+            assert got == data["expected"], f"encode mismatch:\n  got: {got!r}\n  exp: {data['expected']!r}"
+        decoded = decode_generic(got)
+        assert _structural_equal(
+            _json_norm(data["input"]), _json_norm(decoded)
+        ), f"round-trip mismatch:\n  input:   {data['input']}\n  decoded: {decoded}"
+
     elif op == "error":
         # v3 decoder may surface different error categories for same invalid input.
         # The requirement is that it rejects.