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

{gcf_python-2.0.0 → gcf_python-2.1.1}/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## v2.1.0 (2026-06-14)
+
+### Spec v3.1
+
+- `tool` field in graph profile header is now optional (SHOULD be present for MCP, not required)
+
+### Bug Fixes
+
+- Quote strings containing commas (conformance: `inline-schema/006_inline_with_quoted_values`)
+- Decode v2-format indented attachments in tabular rows (conformance: `decode/002_attachment`)
+- Reject duplicate attachments on the same row (conformance: `errors-v2/027_duplicate_attachment`)
+
 ## v2.0.0 (2026-06-12)
 
 ### Breaking Changes

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gcf-python
-Version: 2.0.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.0.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.0.0 → gcf_python-2.1.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "gcf-python"
-version = "2.0.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.0.0 → gcf_python-2.1.1}/src/gcf/decode.py

@@ -34,8 +34,7 @@ def decode(input_text: str) -> Payload:
         raise DecodeError(f"invalid header, expected 'GCF ...' got {header!r}")
     _parse_header(header[4:], p)
 
-    if not p.tool:
-        raise DecodeError("missing_tool: header missing required 'tool' field")
+    # v3.1: tool field is optional (SHOULD be present for MCP tool responses, not required).
 
     # Detect delta mode.
     is_delta = "delta=true" in header

{gcf_python-2.0.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:
@@ -442,6 +451,10 @@ def _parse_tabular_body(
                 if a_content is None:
                     break
 
+                # Handle v2 indented attachments: strip one extra indent level.
+                if not a_content.startswith(".") and a_content.startswith("  ."):
+                    a_content = a_content[2:]
+
                 # Line starts with ".": traditional or prefixed inline.
                 if a_content.startswith("."):
                     rest = a_content[1:]
@@ -459,6 +472,8 @@ def _parse_tabular_body(
                             p = parse_scalar(inline_vals[k], tabular_context=True)
                             if p is not MISSING:
                                 obj[inf] = p
+                        if att_name in attachment_values:
+                            raise ValueError(f"duplicate_attachment: {att_name}")
                         attachment_values[att_name] = obj
                         i += 1
                         continue
@@ -469,6 +484,8 @@ def _parse_tabular_body(
                     )
                     if not rows and parsed_fields:
                         shared_array_schemas[att_name_t] = parsed_fields
+                    if att_name_t in attachment_values:
+                        raise ValueError(f"duplicate_attachment: {att_name_t}")
                     attachment_values[att_name_t] = att_val
                     i += consumed
                     continue
@@ -503,6 +520,19 @@ def _parse_tabular_body(
                 if f not in attachment_values:
                     raise ValueError(f"missing_attachment: {f}")
 
+            # Check for extra attachment lines after all fields resolved (duplicate).
+            if i < len(lines):
+                extra_line = lines[i]
+                extra_content = ""
+                if depth == 0 or extra_line.startswith(ind):
+                    extra_content = extra_line[len(ind):] if depth > 0 else extra_line
+                if not extra_content.startswith(".") and extra_content.startswith("  ."):
+                    extra_content = extra_content[2:]
+                if extra_content.startswith("."):
+                    extra_name, _ = _parse_attachment_name(extra_content[1:])
+                    if extra_name in attachment_values:
+                        raise ValueError(f"duplicate_attachment: {extra_name}")
+
         if not row_has_id or not all_att_fields:
             att_indent = ind + "  "
             if i < len(lines) and lines[i].startswith(att_indent):

{gcf_python-2.0.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,9 +37,11 @@ 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"):
+        if c in ('"', "\\", "|", ",") or o < 0x20 or c in ("\n", "\r"):
             return True
         # C1 control characters
         if 0x80 <= o <= 0x9F:

{gcf_python-2.0.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.