toons 0.4.0__tar.gz → 0.5.1__tar.gz

{toons-0.4.0 → toons-0.5.1}/.github/workflows/CI.yml

@@ -24,17 +24,17 @@ jobs:
     strategy:
       matrix:
         platform:
-          - runner: ubuntu-22.04
+          - runner: ubuntu-latest
             target: x86_64
-          - runner: ubuntu-22.04
+          - runner: ubuntu-latest
             target: x86
-          - runner: ubuntu-22.04
+          - runner: ubuntu-latest
             target: aarch64
-          - runner: ubuntu-22.04
+          - runner: ubuntu-latest
             target: armv7
-          - runner: ubuntu-22.04
+          - runner: ubuntu-latest
             target: s390x
-          - runner: ubuntu-22.04
+          - runner: ubuntu-latest
             target: ppc64le
     steps:
       - uses: actions/checkout@v4
@@ -66,13 +66,13 @@ jobs:
     strategy:
       matrix:
         platform:
-          - runner: ubuntu-22.04
+          - runner: ubuntu-latest
             target: x86_64
-          - runner: ubuntu-22.04
+          - runner: ubuntu-latest
             target: x86
-          - runner: ubuntu-22.04
+          - runner: ubuntu-latest
             target: aarch64
-          - runner: ubuntu-22.04
+          - runner: ubuntu-latest
             target: armv7
     steps:
       - uses: actions/checkout@v4

{toons-0.4.0 → toons-0.5.1}/.pre-commit-config.yaml

@@ -16,7 +16,7 @@ repos:
       - id: fmt
       - id: cargo-check
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.14.10
+    rev: v0.15.0
     hooks:
       - id: ruff
         args: [--fix, --select, I]  # I = isort (import sorting)

{toons-0.4.0 → toons-0.5.1}/Cargo.lock

@@ -2,41 +2,17 @@
 # It is not intended for manual editing.
 version = 4
 
-[[package]]
-name = "autocfg"
-version = "1.5.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c08606f8c3cbf4ce6ec8e28fb0014a2c086708fe954eaa885384a6165172e7e8"
-
 [[package]]
 name = "heck"
 version = "0.5.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "2304e00983f87ffb38b55b444b5e3b60a884b5d30c0fca7d82fe33449bbe55ea"
 
-[[package]]
-name = "indoc"
-version = "2.0.7"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "79cf5c93f93228cf8efb3ba362535fb11199ac548a09ce117c9b1adc3030d706"
-dependencies = [
- "rustversion",
-]
-
 [[package]]
 name = "libc"
-version = "0.2.178"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "37c93d8daa9d8a012fd8ab92f088405fb202ea0b6ab73ee2482ae66af4f42091"
-
-[[package]]
-name = "memoffset"
-version = "0.9.1"
+version = "0.2.180"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "488016bfae457b036d996092f6cb448677611ce4449e970ceaf42695203f218a"
-dependencies = [
- "autocfg",
-]
+checksum = "bcc35a38544a891a5f7c865aca548a982ccb3b8650a5b06d0fd33a10283c56fc"
 
 [[package]]
 name = "once_cell"
@@ -46,50 +22,47 @@ checksum = "42f5e15c9953c5e4ccceeb2e7382a716482c34515315f7b03532b8b4e8393d2d"
 
 [[package]]
 name = "portable-atomic"
-version = "1.13.0"
+version = "1.13.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f89776e4d69bb58bc6993e99ffa1d11f228b839984854c7daeb5d37f87cbe950"
+checksum = "c33a9471896f1c69cecef8d20cbe2f7accd12527ce60845ff44c153bb2a21b49"
 
 [[package]]
 name = "proc-macro2"
-version = "1.0.104"
+version = "1.0.106"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9695f8df41bb4f3d222c95a67532365f569318332d03d5f3f67f37b20e6ebdf0"
+checksum = "8fd00f0bb2e90d81d1044c2b32617f68fcb9fa3bb7640c23e9c748e53fb30934"
 dependencies = [
  "unicode-ident",
 ]
 
 [[package]]
 name = "pyo3"
-version = "0.27.2"
+version = "0.28.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ab53c047fcd1a1d2a8820fe84f05d6be69e9526be40cb03b73f86b6b03e6d87d"
+checksum = "fcf3ccafdf54c050be48a3a086d372f77ba6615f5057211607cd30e5ac5cec6d"
 dependencies = [
- "indoc",
  "libc",
- "memoffset",
  "once_cell",
  "portable-atomic",
  "pyo3-build-config",
  "pyo3-ffi",
  "pyo3-macros",
- "unindent",
 ]
 
 [[package]]
 name = "pyo3-build-config"
-version = "0.27.2"
+version = "0.28.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b455933107de8642b4487ed26d912c2d899dec6114884214a0b3bb3be9261ea6"
+checksum = "972720a441c91fd9c49f212a1d2d74c6e3803b231ebc8d66c51efbd7ccab11c8"
 dependencies = [
  "target-lexicon",
 ]
 
 [[package]]
 name = "pyo3-ffi"
-version = "0.27.2"
+version = "0.28.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "1c85c9cbfaddf651b1221594209aed57e9e5cff63c4d11d1feead529b872a089"
+checksum = "5994456d9dab8934d600d3867571b6410f24fbd6002570ad56356733eb54859b"
 dependencies = [
  "libc",
  "pyo3-build-config",
@@ -97,9 +70,9 @@ dependencies = [
 
 [[package]]
 name = "pyo3-macros"
-version = "0.27.2"
+version = "0.28.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "0a5b10c9bf9888125d917fb4d2ca2d25c8df94c7ab5a52e13313a07e050a3b02"
+checksum = "11ce9cc8d81b3c4969748807604d92b4eef363c5bb82b1a1bdb34ec6f1093a18"
 dependencies = [
  "proc-macro2",
  "pyo3-macros-backend",
@@ -109,9 +82,9 @@ dependencies = [
 
 [[package]]
 name = "pyo3-macros-backend"
-version = "0.27.2"
+version = "0.28.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "03b51720d314836e53327f5871d4c0cfb4fb37cc2c4a11cc71907a86342c40f9"
+checksum = "eaf4b60036a154d23282679b658e3cc7d88d3b8c9a40b43824785f232d2e1b98"
 dependencies = [
  "heck",
  "proc-macro2",
@@ -122,24 +95,18 @@ dependencies = [
 
 [[package]]
 name = "quote"
-version = "1.0.42"
+version = "1.0.44"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a338cc41d27e6cc6dce6cefc13a0729dfbb81c262b1f519331575dd80ef3067f"
+checksum = "21b2ebcf727b7760c461f091f9f0f539b77b8e87f2fd88131e7f1b433b3cece4"
 dependencies = [
  "proc-macro2",
 ]
 
-[[package]]
-name = "rustversion"
-version = "1.0.22"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b39cdef0fa800fc44525c84ccb54a029961a8215f9619753635a9c0d2538d46d"
-
 [[package]]
 name = "syn"
-version = "2.0.112"
+version = "2.0.114"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "21f182278bf2d2bcb3c88b1b08a37df029d71ce3d3ae26168e3c653b213b99d4"
+checksum = "d4d107df263a3013ef9b1879b0df87d706ff80f65a86ea879bd9c31f9b307c2a"
 dependencies = [
  "proc-macro2",
  "quote",
@@ -154,7 +121,7 @@ checksum = "b1dd07eb858a2067e2f3c7155d54e929265c264e6f37efe3ee7a8d1b5a1dd0ba"
 
 [[package]]
 name = "toons"
-version = "0.4.0"
+version = "0.5.1"
 dependencies = [
  "pyo3",
 ]
@@ -164,9 +131,3 @@ name = "unicode-ident"
 version = "1.0.22"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "9312f7c4f6ff9069b165498234ce8be658059c6728633667c526e27dc2cf1df5"
-
-[[package]]
-name = "unindent"
-version = "0.2.4"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7264e107f553ccae879d21fbea1d6724ac785e8c3bfc762137959b5802826ef3"

{toons-0.4.0 → toons-0.5.1}/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "toons"
-version = "0.4.0"
+version = "0.5.1"
 edition = "2024"
 readme = "README.md"
 

{toons-0.4.0 → toons-0.5.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: toons
-Version: 0.4.0
+Version: 0.5.1
 Classifier: Programming Language :: Rust
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Programming Language :: Python :: Implementation :: PyPy
@@ -24,6 +24,17 @@ Project-URL: Source, https://github.com/alesanfra/toons
 
 TOONS - Token Oriented Object Notation Serializer - is a fast Rust-based library that provides a Python interface mirroring the `json` module API, making it easy to work with the TOON format—a token-efficient data serialization format designed specifically for Large Language Models.
 
+
+## Documentation
+
+📖 Read the full documentation at **[toons.readthedocs.io](https://toons.readthedocs.io/en/stable/)**.
+
+Quick start pages:
+- 🚀 **[Getting Started](https://toons.readthedocs.io/en/stable/getting-started/)** - Installation and first steps
+- 💡 **[Examples](https://toons.readthedocs.io/en/stable/examples/)** - Practical usage examples
+- 📚 **[API Reference](https://toons.readthedocs.io/en/stable/api-reference/)** - Complete API documentation
+
+
 ## Why TOON?
 
 The TOON format achieves **30-60% fewer tokens** than equivalent JSON, making it ideal for LLM contexts where token count impacts costs and context capacity.
@@ -50,7 +61,7 @@ users[2]{name,age}:
 - 🚀 **Fast**: Rust implementation with PyO3 bindings
 - 📊 **Token-Efficient**: 30-60% fewer tokens than JSON
 - 🔄 **Familiar API**: Drop-in replacement for `json` module
-- ✅ **Spec Compliant**: Full TOON Specification v2.0 support
+- ✅ **Spec Compliant**: Full TOON Specification v3.0 support
 - 🐍 **Python Native**: Works with standard Python types
 
 ## Quick Start
@@ -97,15 +108,6 @@ with open("data.toon", "r") as f:
     data = toons.load(f)
 ```
 
-## Documentation
-
-📖 **[Read the full documentation at toons.readthedocs.io](https://toons.readthedocs.io/en/stable/)**
-
-- 🚀 **[Getting Started](https://toons.readthedocs.io/en/stable/getting-started/)** - Installation and first steps
-- 💡 **[Examples](https://toons.readthedocs.io/en/stable/examples/)** - Practical usage examples
-- 📚 **[API Reference](https://toons.readthedocs.io/en/stable/api-reference/)** - Complete API documentation
-- 📋 **[TOON Specification](https://toons.readthedocs.io/en/stable/specification/)** - Format specification v2.0
-
 ## Development
 
 ```bash

{toons-0.4.0 → toons-0.5.1}/README.md

@@ -10,6 +10,17 @@
 
 TOONS - Token Oriented Object Notation Serializer - is a fast Rust-based library that provides a Python interface mirroring the `json` module API, making it easy to work with the TOON format—a token-efficient data serialization format designed specifically for Large Language Models.
 
+
+## Documentation
+
+📖 Read the full documentation at **[toons.readthedocs.io](https://toons.readthedocs.io/en/stable/)**.
+
+Quick start pages:
+- 🚀 **[Getting Started](https://toons.readthedocs.io/en/stable/getting-started/)** - Installation and first steps
+- 💡 **[Examples](https://toons.readthedocs.io/en/stable/examples/)** - Practical usage examples
+- 📚 **[API Reference](https://toons.readthedocs.io/en/stable/api-reference/)** - Complete API documentation
+
+
 ## Why TOON?
 
 The TOON format achieves **30-60% fewer tokens** than equivalent JSON, making it ideal for LLM contexts where token count impacts costs and context capacity.
@@ -36,7 +47,7 @@ users[2]{name,age}:
 - 🚀 **Fast**: Rust implementation with PyO3 bindings
 - 📊 **Token-Efficient**: 30-60% fewer tokens than JSON
 - 🔄 **Familiar API**: Drop-in replacement for `json` module
-- ✅ **Spec Compliant**: Full TOON Specification v2.0 support
+- ✅ **Spec Compliant**: Full TOON Specification v3.0 support
 - 🐍 **Python Native**: Works with standard Python types
 
 ## Quick Start
@@ -83,15 +94,6 @@ with open("data.toon", "r") as f:
     data = toons.load(f)
 ```
 
-## Documentation
-
-📖 **[Read the full documentation at toons.readthedocs.io](https://toons.readthedocs.io/en/stable/)**
-
-- 🚀 **[Getting Started](https://toons.readthedocs.io/en/stable/getting-started/)** - Installation and first steps
-- 💡 **[Examples](https://toons.readthedocs.io/en/stable/examples/)** - Practical usage examples
-- 📚 **[API Reference](https://toons.readthedocs.io/en/stable/api-reference/)** - Complete API documentation
-- 📋 **[TOON Specification](https://toons.readthedocs.io/en/stable/specification/)** - Format specification v2.0
-
 ## Development
 
 ```bash

{toons-0.4.0 → toons-0.5.1}/docs/README.md

@@ -53,7 +53,7 @@ docs/
 - **[Quick Start](quick-start.md)** - Get up and running quickly
 - **[Examples](examples.md)** - Practical usage examples
 - **[API Reference](api-reference.md)** - Complete API documentation
-- **[Specification](specification.md)** - TOON format specification v2.0
+- **[Specification](specification.md)** - TOON format specification v3.0
 - **[Data Types](data-types.md)** - Type mapping and conversion
 
 ### Developer Documentation

{toons-0.4.0 → toons-0.5.1}/docs/api-reference.md

@@ -22,7 +22,7 @@ def loads(s: str, *, strict: bool = True) -> Any
 **Parameters:**
 
 - `s` (`str`): TOON-formatted string to parse
-- `strict` (`bool`, optional): If `True` (default), enforce strict TOON v2.0 compliance. If `False`, allow some leniency (e.g., blank lines in arrays, indentation mismatches).
+- `strict` (`bool`, optional): If `True` (default), enforce strict TOON v3.0 compliance. If `False`, allow some leniency (e.g., blank lines in arrays, indentation mismatches).
 
 **Returns:**
 
@@ -89,7 +89,7 @@ def load(fp: IO[str], *, strict: bool = True) -> Any
 **Parameters:**
 
 - `fp`: File-like object supporting `.read()` method
-- `strict` (`bool`, optional): If `True` (default), enforce strict TOON v2.0 compliance. If `False`, allow some leniency.
+- `strict` (`bool`, optional): If `True` (default), enforce strict TOON v3.0 compliance. If `False`, allow some leniency.
 
 **Returns:**
 
@@ -122,18 +122,23 @@ except ValueError as e:
 
 ---
 
-### `dumps(obj)`
+### `dumps(obj, *, indent=2, delimiter=",")`
 
 Serialize a Python object to a TOON-formatted string.
 
 **Signature:**
 ```python
-def dumps(obj: Any) -> str
+def dumps(obj: Any, *, indent: int = 2, delimiter: str = ",") -> str
 ```
 
 **Parameters:**
 
 - `obj`: Python object to serialize (must be JSON-serializable types)
+- `indent` (`int`, optional): Number of spaces per indentation level (default: 2, minimum: 2)
+- `delimiter` (`str`, optional): Delimiter character for arrays and tabular format (default: ","). Supported values:
+  - `","` - Comma (default)
+  - `"\t"` - Tab
+  - `"|"` - Pipe
 
 **Returns:**
 
@@ -183,35 +188,50 @@ print(toons.dumps(data))
 #   Alice,30
 #   Bob,25
 
-# Nested objects
+# Custom indentation (4 spaces)
+data = {"nested": {"value": 42}}
+print(toons.dumps(data, indent=4))
+# nested:
+#     value: 42
+
+# Tab delimiter
+data = {"items": [1, 2, 3]}
+print(toons.dumps(data, delimiter="\t"))
+# items[3\t]: 1\t2\t3
+
+# Pipe delimiter with tabular format
 data = {
-    "user": {
-        "name": "Alice",
-        "contact": {"email": "alice@example.com"}
-    }
+    "users": [
+        {"name": "Alice", "age": 30},
+        {"name": "Bob", "age": 25}
+    ]
 }
-print(toons.dumps(data))
-# user:
-#   name: Alice
-#   contact:
-#     email: alice@example.com
+print(toons.dumps(data, delimiter="|"))
+# users[2|]{name|age}:
+#   Alice|30
+#   Bob|25
 ```
 
 ---
 
-### `dump(obj, fp)`
+### `dump(obj, fp, *, indent=2, delimiter=",")`
 
 Serialize a Python object to TOON format and write to a file object.
 
 **Signature:**
 ```python
-def dump(obj: Any, fp: IO[str]) -> None
+def dump(obj: Any, fp: IO[str], *, indent: int = 2, delimiter: str = ",") -> None
 ```
 
 **Parameters:**
 
 - `obj`: Python object to serialize
 - `fp`: File-like object supporting `.write()` method
+- `indent` (`int`, optional): Number of spaces per indentation level (default: 2, minimum: 2)
+- `delimiter` (`str`, optional): Delimiter character for arrays and tabular format (default: ","). Supported values:
+  - `","` - Comma (default)
+  - `"\t"` - Tab
+  - `"|"` - Pipe
 
 **Returns:**
 
@@ -238,6 +258,18 @@ data = {
 with open("users.toon", "w") as f:
     toons.dump(data, f)
 
+# Custom indentation
+with open("users.toon", "w") as f:
+    toons.dump(data, f, indent=4)
+
+# Tab delimiter
+with open("users.toon", "w") as f:
+    toons.dump(data, f, delimiter="\t")
+
+# Pipe delimiter with custom indentation
+with open("users.toon", "w") as f:
+    toons.dump(data, f, indent=4, delimiter="|")
+
 # With error handling
 try:
     with open("output.toon", "w") as f:

{toons-0.4.0 → toons-0.5.1}/docs/examples.md

@@ -366,7 +366,7 @@ print(result)  # None (with error message)
 
 ### Strict Mode
 
-By default, TOONS enforces strict compliance with the v2.0 specification. You can disable this for lenient parsing of slightly malformed data (e.g., blank lines in arrays).
+By default, TOONS enforces strict compliance with the v3.0 specification. You can disable this for lenient parsing of slightly malformed data (e.g., blank lines in arrays).
 
 ```python
 import toons

{toons-0.4.0 → toons-0.5.1}/docs/index.md

@@ -9,7 +9,7 @@ TOONS provides a Python interface that mirrors the API of Python's standard `jso
 - **🚀 Fast**: Implemented in Rust with PyO3 bindings for maximum performance
 - **📊 Token-Efficient**: 30-60% fewer tokens than JSON, ideal for LLM contexts
 - **🔄 Familiar API**: Mirrors Python's `json` module (`load`, `loads`, `dump`, `dumps`)
-- **✅ Spec Compliant**: Full support for TOON Specification v2.0
+- **✅ Spec Compliant**: Full support for TOON Specification v3.0
 - **🐍 Python Native**: Returns/accepts Python dict, list, str, int, float, bool, None
 - **📁 File & String**: Complete support for both file I/O and string operations
 
@@ -64,7 +64,7 @@ The library is fully implemented in Rust with a custom parser and serializer, us
 - High-performance parsing and serialization
 - Memory efficiency
 - Type safety
-- Full TOON Specification v2.0 compliance
+- Full TOON Specification v3.0 compliance
 - Complete control over implementation details
 
 ## Next Steps

{toons-0.4.0 → toons-0.5.1}/docs/testing.md

@@ -219,11 +219,11 @@ class TestRoundTrip:
 
 ### Specification Compliance Tests
 
-Verify TOON Spec v2.0 compliance:
+Verify TOON Spec v3.0 compliance:
 
 ```python
 class TestSpecCompliance:
-    """Test TOON Specification v2.0 compliance."""
+    """Test TOON Specification v3.0 compliance."""
 
     def test_array_count_notation(self):
         """Test that arrays include element count [N]."""

{toons-0.4.0 → toons-0.5.1}/pyproject.toml

@@ -23,6 +23,7 @@ Source = "https://github.com/alesanfra/toons"
 
 [tool.maturin]
 features = ["pyo3/extension-module", "pyo3/abi3-py37"]
+include = ["toons.pyi"]
 
 [tool.ruff]
 line-length = 79