linesep 0.1.1

Handling lines with arbitrary separators

GitHub | PyPI | Issues

This module provides basic functions for reading & writing text with custom line separators that can occur either before, between, or after lines — though its primary purpose is actually to allow me to experiment with proper Python packaging & testing procedures. Being actually useful is not its #1 goal.

Installation

Just use pip (You have pip, right?) to install linesep:

pip install linesep

Examples

Reading paragraphs separated by a blank line:

with open('text.txt') as fp:
    for entry in linesep.read_separated(fp, '\n\n'):
        ...

Parsing output from find -print0:

find = subprocess.Popen(
    ['find', '/', '-some', '-complicated', '-condition', '-print0'],
    stdout=subprocess.PIPE,
)
for filepath in linesep.read_terminated(find.stdout, '\0'):
    ...

A poor man’s JSON Sequence parser:

for entry in linesep.read_preceded(fp, '\x1E'):
    try:
        obj = json.loads(entry)
    except ValueError:
        pass
    else:
        yield obj

See Also

Prior art: <http://bugs.python.org/issue1152248#msg109117>