jsonl.loads¶

Deserialize a JSON Lines formatted string into an object iterator.

Function Signature¶

jsonl.loads(
    text,
    *,
    broken=False,
    cls=None,
    **kwargs,
)

Parameter	Type	Default	Description
`text`	`str`	(required)	JSON Lines formatted string
`broken`	`bool`	`False`	If true, skip broken lines (only logging a warning)
`cls`	`type[json.JSONDecoder]` `Callable` or `None`	`json.JSONDecoder`	Custom decoder
`**kwargs`			Additional keyword arguments passed to the `cls` decoder

Iterator[Any] — An iterator yielding one deserialized object per line.

import jsonl

text = '{"foo": 1}\n{"bar": 2}\n'
for item in jsonl.loads(text):
    print(item)

Output:

{'foo': 1}
{'bar': 2}

import jsonl

data = [{"name": "Alice"}, {"name": "Bob"}]
text = jsonl.dumps(data)

for item in jsonl.loads(text):
    print(item)

Output:

{'name': 'Alice'}
{'name': 'Bob'}

import jsonl

text = '{"a": 1}\nnot json\n{"b": 2}\n'
result = list(jsonl.loads(text, broken=True))
print(result)

Output:

[{'a': 1}, {'b': 2}]