jsonseq

What it is and what it does

jsonseq implements RFC 7464 JSON Text Sequences, a standard format for streaming multiple JSON objects in a single stream or file. It provides two main classes: JSONSeqEncoder takes Python objects and yields them as JSON with optional ASCII record separators (\x1e) and newlines, and JSONSeqDecoder reverses the process, reading delimited JSON sequences and yielding decoded Python objects.

The package is useful when you need to write or read multiple JSON objects sequentially—for example, writing one JSON object per line to a file, or reading a stream of JSON objects from a network connection. It handles both compact and pretty-printed JSON, and supports incremental encoding via iterencode() for streaming to files or network sockets.

Use it for:

• Write streaming JSON logs where each line is a separate JSON object with record delimiters
• Read JSON object sequences from a file or network stream that conform to RFC 7464
• Encode Python objects to RFC 7464 format for interoperability with other tools that consume JSON sequences
• Process large datasets as a stream of JSON objects without loading everything into memory at once

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Encodes and decodes JSON text sequences according to RFC 7464, allowing streaming of multiple JSON objects delimited by record separators and newlines.

Yes, if you specifically need RFC 7464 compliance and can accept an abandoned package. The code is simple, has no dependencies, and the standard is stable. However, verify compatibility with your target Python version and be prepared to maintain a fork if critical issues arise, since the last release was 2019-07-31.

Install

jsonseq on PyPI

pip install jsonseq

uv add jsonseq

poetry add jsonseq

Installing jsonseq

Before you install

Low install friction with no runtime dependencies. However, the package is abandoned—last commit was 2021-11-20 and no releases since 2019-07-31. It remains marked Production/Stable but receives no maintenance.

License in practice

Licensed under MIT (permissive), so you can use, modify, and distribute it freely with minimal restrictions.

Quickstart

from jsonseq.encode import JSONSeqEncoder
from jsonseq.decode import JSONSeqDecoder

# Encode objects to RFC 7464 format
for chunk in JSONSeqEncoder(with_rs=True).encode([{"a": 0}, {"a": 1}]):
    print(repr(chunk))

# Decode from RFC 7464 format
stream = ['\x1e', '{', '"a"', ': ', '0', '}', '\n']
for obj in JSONSeqDecoder().decode(stream):
    print(obj)

Verify before relying

• Whether the package works reliably with Python versions beyond 3.7 (classifiers list only up to 3.7, but no explicit requires_python constraint)
• Whether there are known issues or edge cases in the abandoned codebase that affect production use

Package facts

Evidence: jsonseq-1.0.0-py3-none-any.whl

Keywords: json, rfc7464

Tags

More Text Processing packages