gcf-python 0.1.1__tar.gz → 0.1.3__tar.gz

{gcf_python-0.1.1 → gcf_python-0.1.3}/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## v0.1.2 (2026-06-04)
+
+- Fix: escape `"` inside quoted strings in `encode_generic`
+- Fix: quote empty strings as `""` per spec
+
 ## v0.1.1 (2026-06-03)
 
 - `encode_generic`: encode arbitrary Python values into GCF tabular format

{gcf_python-0.1.1 → gcf_python-0.1.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gcf-python
-Version: 0.1.1
+Version: 0.1.3
 Summary: Python implementation of GCF (Graph Compact Format): token-optimized wire format for LLM tool responses
 Project-URL: Homepage, https://github.com/blackwell-systems/gcf-python
 Project-URL: Documentation, https://blackwell-systems.github.io/gcf/
@@ -30,9 +30,11 @@ Description-Content-Type: text/markdown
 
 # gcf-python
 
-Python implementation of [GCF (Graph Compact Format)](https://github.com/blackwell-systems/gcf).
+Python implementation of [GCF (Graph Compact Format)](https://gcformat.com/) — the most token-efficient wire format for LLMs. A drop-in alternative to JSON and TOON for any structured data.
 
-**84% fewer tokens than JSON. 32% fewer than TOON. 100% LLM comprehension accuracy at 500 symbols, where JSON fails.**
+**79% fewer input tokens than JSON. 75% fewer output tokens. 52% smaller than TOON. 100% LLM comprehension at 500 symbols, where JSON fails at 66.7%.**
+
+Docs: [gcformat.com](https://gcformat.com/) · [Playground](https://gcformat.com/playground.html) · [GCF vs TOON](https://gcformat.com/guide/vs-toon.html)
 
 ## Install
 
@@ -40,7 +42,7 @@ Python implementation of [GCF (Graph Compact Format)](https://github.com/blackwe
 pip install gcf-python
 ```
 
-Zero dependencies. Pure Python. Python 3.9+. Includes CLI.
+Zero dependencies. Pure Python. Python 3.9+. Includes CLI. Don't want to change code? Use the [MCP proxy](https://github.com/blackwell-systems/gcf-proxy) for zero-code adoption.
 
 ## CLI
 
@@ -211,11 +213,16 @@ GCF wins on every dataset except deeply nested config (75 tokens on a 618-token
 
 Reproducible: [blackwell-systems/toon@gcf-comparison](https://github.com/blackwell-systems/toon/tree/gcf-comparison)
 
-## Other Implementations
+## Links
 
-- **Go**: [github.com/blackwell-systems/gcf-go](https://github.com/blackwell-systems/gcf-go)
-- **TypeScript**: [github.com/blackwell-systems/gcf-typescript](https://github.com/blackwell-systems/gcf-typescript)
-- **Specification**: [github.com/blackwell-systems/gcf](https://github.com/blackwell-systems/gcf)
+- [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)
 
 ## License
 

{gcf_python-0.1.1 → gcf_python-0.1.3}/README.md

@@ -5,9 +5,11 @@
 
 # gcf-python
 
-Python implementation of [GCF (Graph Compact Format)](https://github.com/blackwell-systems/gcf).
+Python implementation of [GCF (Graph Compact Format)](https://gcformat.com/) — the most token-efficient wire format for LLMs. A drop-in alternative to JSON and TOON for any structured data.
 
-**84% fewer tokens than JSON. 32% fewer than TOON. 100% LLM comprehension accuracy at 500 symbols, where JSON fails.**
+**79% fewer input tokens than JSON. 75% fewer output tokens. 52% smaller than TOON. 100% LLM comprehension at 500 symbols, where JSON fails at 66.7%.**
+
+Docs: [gcformat.com](https://gcformat.com/) · [Playground](https://gcformat.com/playground.html) · [GCF vs TOON](https://gcformat.com/guide/vs-toon.html)
 
 ## Install
 
@@ -15,7 +17,7 @@ Python implementation of [GCF (Graph Compact Format)](https://github.com/blackwe
 pip install gcf-python
 ```
 
-Zero dependencies. Pure Python. Python 3.9+. Includes CLI.
+Zero dependencies. Pure Python. Python 3.9+. Includes CLI. Don't want to change code? Use the [MCP proxy](https://github.com/blackwell-systems/gcf-proxy) for zero-code adoption.
 
 ## CLI
 
@@ -186,11 +188,16 @@ GCF wins on every dataset except deeply nested config (75 tokens on a 618-token
 
 Reproducible: [blackwell-systems/toon@gcf-comparison](https://github.com/blackwell-systems/toon/tree/gcf-comparison)
 
-## Other Implementations
+## Links
 
-- **Go**: [github.com/blackwell-systems/gcf-go](https://github.com/blackwell-systems/gcf-go)
-- **TypeScript**: [github.com/blackwell-systems/gcf-typescript](https://github.com/blackwell-systems/gcf-typescript)
-- **Specification**: [github.com/blackwell-systems/gcf](https://github.com/blackwell-systems/gcf)
+- [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)
 
 ## License
 

{gcf_python-0.1.1 → gcf_python-0.1.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "gcf-python"
-version = "0.1.1"
+version = "0.1.3"
 description = "Python implementation of GCF (Graph Compact Format): token-optimized wire format for LLM tool responses"
 readme = "README.md"
 license = {text = "MIT"}

{gcf_python-0.1.1 → gcf_python-0.1.3}/src/gcf/__init__.py

@@ -59,4 +59,4 @@ __all__ = [
     "encode_with_session",
 ]
 
-__version__ = "0.1.1"
+__version__ = "0.1.3"

{gcf_python-0.1.1 → gcf_python-0.1.3}/src/gcf/generic.py

@@ -18,6 +18,8 @@ def encode_generic(data: Any) -> str:
     Returns:
         GCF-formatted text string.
     """
+    if data is None or not isinstance(data, (dict, list)):
+        return str(data) if data is not None else "-"
     lines: list[str] = []
     _encode_value(data, lines, depth=0)
     return "\n".join(lines) + "\n" if lines else "\n"
@@ -33,15 +35,16 @@ def _encode_value(value: Any, lines: list[str], depth: int) -> None:
         lines.append(_indent(depth) + _format_value(value))
 
 
-def _encode_dict(d: dict, lines: list[str], depth: int) -> None:
+def _encode_dict(d: dict, lines: list[str], depth: int, name: str | None = None) -> None:
     """Encode a dict into key=value pairs with section headers for nested values."""
     prefix = _indent(depth)
+    if name is not None:
+        lines.append(f"{prefix}## {name}")
     for key, value in d.items():
         if isinstance(value, list):
             _encode_array(value, key, lines, depth)
         elif isinstance(value, dict):
-            lines.append(f"{prefix}## {key}")
-            _encode_dict(value, lines, depth + 1)
+            _encode_dict(value, lines, depth + 1, name=key)
         else:
             lines.append(f"{prefix}{key}={_format_value(value)}")
 
@@ -85,14 +88,12 @@ def _encode_tabular(items: list[dict], name: str, lines: list[str], depth: int)
 
         if nested_fields:
             lines.append(f"{prefix}@{i} {row_str}")
-            inner_prefix = _indent(depth + 1)
             for nk in nested_fields:
                 nv = item.get(nk)
                 if isinstance(nv, list):
                     _encode_array(nv, nk, lines, depth + 1)
                 elif isinstance(nv, dict):
-                    lines.append(f"{inner_prefix}## {nk}")
-                    _encode_dict(nv, lines, depth + 2)
+                    _encode_dict(nv, lines, depth + 1, name=nk)
         else:
             lines.append(f"{prefix}{row_str}")
 
@@ -140,8 +141,9 @@ def _format_value(value: Any) -> str:
     if isinstance(value, (int, float)):
         return str(value)
     s = str(value)
-    if "|" in s or "\n" in s:
-        return f'"{s}"'
+    if "|" in s or "\n" in s or s == "":
+        escaped = s.replace("\\", "\\\\").replace('"', '\\"')
+        return f'"{escaped}"'
     return s
 
 

{gcf_python-0.1.1 → gcf_python-0.1.3}/tests/test_generic.py

@@ -159,8 +159,8 @@ def test_encode_non_uniform_list():
 
 def test_encode_primitive_value():
     """A bare primitive is encoded directly."""
-    assert encode_generic(42) == "42\n"
-    assert encode_generic("hello") == "hello\n"
+    assert encode_generic(42) == "42"
+    assert encode_generic("hello") == "hello"
 
 
 def test_encode_string_with_pipe():