jsonyx.paste_values¶

jsonyx.paste_values(current_nodes, values, operation, *, allow=NOTHING)[source]¶

Paste value to a node or values to a list of nodes.

Added in version 2.0.

Changed in version 2.4: Removed use_decimal.

Parameters:

current_nodes (_Node | list[_Node]) – a node or a list of nodes
values (Any | list[Any]) – a value or a list of values
operation (_Operation) – a JSON copy or move operation
allow (Container[str], default: NOTHING) – the JSON deviations from jsonyx.allow

Raises:

IndexError – if an index is out of range
JSONSyntaxError – if a query is invalid
KeyError – if a key is not found
TypeError – if a value has the wrong type
ValueError – if a value is invalid

Example:

>>> import jsonyx as json
>>> obj = [1, 2, 3]
>>> root = [obj]
>>> node = root, 0  # pointer to obj
>>> json.paste_values(node, 4, {"mode": "append"})
>>> root[0]
[1, 2, 3, 4]

Tip

Use jsonyx.Manipulator directly for better performance.