CToon Documentation

import ctoon

# Encode Python dict → TOON string
toon = ctoon.dumps({"name": "Alice", "age": 30})
# name: Alice
# age: 30

# Decode TOON string → Python dict
data = ctoon.loads(toon)

# File I/O — path strings or file-like objects
ctoon.dump(data, "out.toon")
data = ctoon.load("out.toon")

# JSON interop
json_str = ctoon.dumps_json(data, indent=2)
data     = ctoon.loads_json(json_str)
ctoon.dump_json(data, "out.json")

# Advanced encode flags
from ctoon import WriteFlag, Delimiter
toon = ctoon.dumps(data,
    indent=4,
    delimiter=Delimiter.PIPE,
    flags=WriteFlag.LENGTH_MARKER | WriteFlag.NEWLINE_AT_END)

#include "ctoon.h"
#include <stdio.h>
#include <stdlib.h>
#include <string.h>

int main(void) {
    const char *src = "name: Alice\nage: 30";
    ctoon_doc *doc  = ctoon_read(src, strlen(src), 0);
    ctoon_val *root = ctoon_doc_get_root(doc);

    /* Access fields */
    ctoon_val *name = ctoon_obj_get(root, "name");
    printf("%s\n", ctoon_get_str(name));   /* Alice */

    /* Serialise back to TOON */
    size_t len;
    char *toon = ctoon_write(doc, &len);
    free(toon);

    /* Export as JSON (CTOON_ENABLE_JSON=1, default) */
    char *json = ctoon_doc_to_json(doc, 2,
                     CTOON_WRITE_NOFLAG, NULL, &len, NULL);
    printf("%s\n", json);
    free(json);

    ctoon_doc_free(doc);
    return 0;
}

#include "ctoon.hpp"
#include <iostream>

int main() {
    // Parse a TOON document
    auto doc  = ctoon::document::parse("name: Alice\nage: 30");
    auto root = doc.root();
    std::cout << root["name"].get_str().str() << "\n";  // Alice
    std::cout << root["age"].get_uint()        << "\n";  // 30

    // Serialise to TOON and JSON
    std::cout << doc.write().c_str()    << "\n";
    std::cout << doc.to_json(2).c_str() << "\n";

    // Build a document programmatically
    auto mdoc = ctoon::make_document();
    auto obj  = mdoc.make_obj();
    mdoc.set_root(obj);
    obj.obj_put(mdoc.make_str("city"), mdoc.make_str("Tehran"));
    obj.obj_put(mdoc.make_str("pop"),  mdoc.make_uint(9000000));
    std::cout << mdoc.to_json(0).c_str() << "\n";

    // Parse from JSON
    auto jdoc = ctoon::document::from_json(R"({"x":1,"y":2})");
    std::cout << jdoc.root()["x"].get_uint() << "\n";  // 1
}

package main

import (
    "fmt"
    ctoon "github.com/mohammadraziei/ctoon"
)

func main() {
    data := map[string]interface{}{
        "name": "Alice",
        "age":  int64(30),
    }

    // Encode → TOON
    toon, _ := ctoon.Dumps(data)
    fmt.Println(toon)

    // Decode ← TOON
    val, _ := ctoon.Loads(toon)
    fmt.Println(val)

    // File I/O
    ctoon.EncodeToFile(data, "out.toon", ctoon.DefaultEncodeOptions())
    val, _ = ctoon.DecodeFromFile("out.toon", ctoon.DefaultDecodeOptions())

    // JSON interop
    json, _ := ctoon.DumpsJSON(data, 2)
    fmt.Println(json)
    ctoon.DumpJSON(data, "out.json")
}

% Encode a MATLAB struct → TOON string
s = ctoon_encode(struct('name', 'Alice', 'age', uint64(30), 'active', true));
% name: Alice
% age: 30
% active: true

% Decode TOON string → MATLAB struct
v = ctoon_decode(s);
v.name    % 'Alice'
v.age     % uint64(30)
v.active  % true

% File I/O
ctoon_write(v, 'data.toon');
v = ctoon_read('data.toon');