splurge-safe-io 2025.0.5

A utility library for working with DSV (Delimited String Values) files

splurge-safe-io

A small, secure, and deterministic text file I/O helper library.

Key features

• Deterministic newline normalization (LF) for text reads/writes.
• Secure path validation utilities to avoid traversal and dangerous characters.
• Streaming reader with incremental decoding and a safe fallback for tricky encodings.
• Clear, small exception hierarchy for stable error handling.

Quick start

from splurge_safe_io.safe_text_file_reader import SafeTextFileReader
from splurge_safe_io.safe_text_file_writer import open_safe_text_writer

# Read lines
reader = SafeTextFileReader('data.csv')
rows = reader.read()

# Write via context manager
with open_safe_text_writer('out.txt') as buf:
    buf.write('\n'.join(['one','two','three']))

See docs/README-DETAILS.md for a complete guide and usage examples.