Function stringify

core/src/stdlib/pyscript/flatted.py:192–225

Serialize a Python object to a Flatted JSON string. This function converts `value`, a Python object (including those with circular references), into a JSON string that can be safely transmitted or stored. The resulting string can be reconstructed using Flatted's parse(). The `*

(value, *args, **kwargs)

def stringify(value, *args, **kwargs):
    """
    Serialize a Python object to a Flatted JSON string.

    This function converts `value`, a Python object (including those with
    circular references), into a JSON string that can be safely transmitted
    or stored. The resulting string can be reconstructed using Flatted's
    parse(). The `*args` and `**kwargs` are passed to json.dumps() for
    additional customization.

    ```python
    from pyscript import flatted


    # Create an object with a circular reference.
    parent = {"name": "parent", "children": []}
    child = {"name": "child", "parent": parent}
    parent["children"].append(child)

    # Serialize it (standard json.dumps would fail here).
    json_string = flatted.stringify(parent)

    # Can optionally pretty-print via JSON indentation etc.
    pretty = flatted.stringify(parent, indent=2)
    ```
    """
    known = _Known()
    input = []
    output = []
    i = int(_index(known, input, value))
    while i < len(input):
        output.append(_transform(known, input, input[i]))
        i += 1
    return _json.dumps(output, *args, **kwargs)