toons 0.4.0__tar.gz → 0.5.0__tar.gz

{toons-0.4.0 → toons-0.5.0}/.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.0}/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"
+version = "0.2.180"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "37c93d8daa9d8a012fd8ab92f088405fb202ea0b6ab73ee2482ae66af4f42091"
-
-[[package]]
-name = "memoffset"
-version = "0.9.1"
-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.0"
 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.0}/Cargo.toml

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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: toons
-Version: 0.4.0
+Version: 0.5.0
 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.0}/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.0}/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.0}/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.0}/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.0}/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.0}/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.0}/src/lib.rs

@@ -7,8 +7,8 @@
 //!
 //! # Features
 //!
-//! - **Full TOON v2.0 Specification Compliance**: Implements all features
-//!   from the official TOON specification dated 2025-11-10
+//! - **Full TOON v3.0 Specification Compliance**: Implements all features
+//!   from the official TOON specification dated 2025-11-24
 //! - **Direct Python Integration**: No intermediate JSON representation
 //! - **Configurable Indentation**: Support for custom indent sizes (≥2 spaces)
 //! - **Smart Parser**: Automatic indentation detection when parsing
@@ -54,7 +54,7 @@
 //!
 //! # Specification
 //!
-//! This implementation follows TOON Specification v2.0 (2025-11-10).
+//! This implementation follows TOON Specification v3.0 (2025-11-24).
 //! For complete specification details, see:
 //! <https://github.com/johannschopplich/toon>
 
@@ -69,7 +69,7 @@ mod toon;
 ///
 /// Args:
 ///     s: A string containing TOON formatted data
-///     strict: If True (default), enforce strict TOON v2.0 compliance.
+///     strict: If True (default), enforce strict TOON v3.0 compliance.
 ///             If False, allow some leniency (e.g. blank lines in arrays).
 ///
 /// Returns:
@@ -84,9 +84,16 @@ mod toon;
 ///     >>> print(data)
 ///     {'name': 'Alice', 'age': 30}
 #[pyfunction]
-#[pyo3(signature = (s, *, strict=true))]
-fn loads(py: Python, s: String, strict: bool) -> PyResult<Py<PyAny>> {
-    toon::deserialize(py, &s, strict)
+#[pyo3(signature = (s, *, strict=true, expand_paths=None, indent=None))]
+fn loads(
+    py: Python,
+    s: String,
+    strict: bool,
+    expand_paths: Option<&str>,
+    indent: Option<usize>,
+) -> PyResult<Py<PyAny>> {
+    let expand_mode = expand_paths.unwrap_or("off");
+    toon::deserialize(py, &s, strict, expand_mode, indent)
 }
 
 /// Deserialize a TOON formatted file to a Python object.
@@ -96,7 +103,7 @@ fn loads(py: Python, s: String, strict: bool) -> PyResult<Py<PyAny>> {
 ///
 /// Args:
 ///     fp: A file-like object with a read() method returning a string
-///     strict: If True (default), enforce strict TOON v2.0 compliance.
+///     strict: If True (default), enforce strict TOON v3.0 compliance.
 ///             If False, allow some leniency (e.g. blank lines in arrays).
 ///
 /// Returns:
@@ -110,12 +117,19 @@ fn loads(py: Python, s: String, strict: bool) -> PyResult<Py<PyAny>> {
 ///     >>> with open('data.toon', 'r') as f:
 ///     ...     data = toons.load(f)
 #[pyfunction]
-#[pyo3(signature = (fp, *, strict=true))]
-fn load(py: Python, fp: &Bound<'_, PyAny>, strict: bool) -> PyResult<Py<PyAny>> {
+#[pyo3(signature = (fp, *, strict=true, expand_paths=None, indent=None))]
+fn load(
+    py: Python,
+    fp: &Bound<'_, PyAny>,
+    strict: bool,
+    expand_paths: Option<&str>,
+    indent: Option<usize>,
+) -> PyResult<Py<PyAny>> {
+    let expand_mode = expand_paths.unwrap_or("off");
     let read_method = fp.getattr("read")?;
     let content = read_method.call0()?;
     let content_str: String = content.extract()?;
-    toon::deserialize(py, &content_str, strict)
+    toon::deserialize(py, &content_str, strict, expand_mode, indent)
 }
 
 /// Serialize a Python object to a TOON formatted string.
@@ -144,9 +158,30 @@ fn load(py: Python, fp: &Bound<'_, PyAny>, strict: bool) -> PyResult<Py<PyAny>>
 ///     >>> # Custom indentation
 ///     >>> toon_str = toons.dumps(data, indent=4)
 #[pyfunction]
-#[pyo3(signature = (obj, *, indent=2))]
-fn dumps(py: Python, obj: &Bound<'_, PyAny>, indent: usize) -> PyResult<String> {
-    toon::serialize(py, obj, indent)
+#[pyo3(signature = (obj, *, indent=2, delimiter=",", key_folding=None, flatten_depth=None))]
+fn dumps(
+    py: Python,
+    obj: &Bound<'_, PyAny>,
+    indent: usize,
+    delimiter: &str,
+    key_folding: Option<&str>,
+    flatten_depth: Option<usize>,
+) -> PyResult<String> {
+    if indent < 2 {
+        return Err(PyErr::new::<pyo3::exceptions::PyValueError, _>(
+            "indent must be >= 2",
+        ));
+    }
+    // key_folding: only enable when explicitly set to "safe", "on", or "always"
+    let enable_key_folding = matches!(key_folding, Some("safe") | Some("on") | Some("always"));
+    toon::serialize(
+        py,
+        obj,
+        delimiter.chars().next().unwrap(),
+        indent,
+        enable_key_folding,
+        flatten_depth,
+    )
 }
 
 /// Serialize a Python object to a TOON formatted file.
@@ -171,9 +206,31 @@ fn dumps(py: Python, obj: &Bound<'_, PyAny>, indent: usize) -> PyResult<String>
 ///     >>> with open('data.toon', 'w') as f:
 ///     ...     toons.dump(data, f, indent=4)
 #[pyfunction]
-#[pyo3(signature = (obj, fp, *, indent=2))]
-fn dump(py: Python, obj: &Bound<'_, PyAny>, fp: &Bound<'_, PyAny>, indent: usize) -> PyResult<()> {
-    let toon_str = toon::serialize(py, obj, indent)?;
+#[pyo3(signature = (obj, fp, *, indent=2, delimiter=",", key_folding=None, flatten_depth=None))]
+fn dump(
+    py: Python,
+    obj: &Bound<'_, PyAny>,
+    fp: &Bound<'_, PyAny>,
+    indent: usize,
+    delimiter: &str,
+    key_folding: Option<&str>,
+    flatten_depth: Option<usize>,
+) -> PyResult<()> {
+    if indent < 2 {
+        return Err(PyErr::new::<pyo3::exceptions::PyValueError, _>(
+            "indent must be >= 2",
+        ));
+    }
+    // key_folding: only enable when explicitly set to "safe", "on", or "always"
+    let enable_key_folding = matches!(key_folding, Some("safe") | Some("on") | Some("always"));
+    let toon_str = toon::serialize(
+        py,
+        obj,
+        delimiter.chars().next().unwrap(),
+        indent,
+        enable_key_folding,
+        flatten_depth,
+    )?;
     let write_method = fp.getattr("write")?;
     write_method.call1((toon_str,))?;
     Ok(())
@@ -197,7 +254,7 @@ implementation with Python bindings for high-performance encoding
 and decoding of TOON data.
 
 Features:
-    - Full TOON v2.0 Specification Compliance
+    - Full TOON v3.0 Specification Compliance
     - Direct Python Integration (no JSON overhead)
     - Configurable Indentation (≥2 spaces)
     - Smart Parser with automatic indentation detection
@@ -214,7 +271,7 @@ Quick Start:
     >>> data = toons.loads(toon_str)
 
 Specification:
-    TOON Specification v2.0 (2025-11-10)
+    TOON Specification v3.0 (2025-11-24)
     https://github.com/johannschopplich/toon
 ",
     )?;