eolify 0.1.5

High-performance line ending normalization for Python.

eolify

High-performance line ending normalization for Python, powered by Rust.

eolify provides fast and memory-efficient conversion between LF (\n) and CRLF (\r\n) line endings for text, files, and streams.

Features

• Fast Rust implementation
• Supports LF and CRLF normalization
• Memory-efficient file processing
• Cross-platform
• Typed API with Python type hints

Installation

pip install eolify

Pre-built wheels are available for common platforms, so a Rust toolchain is usually not required.

Quick Start

Normalize text

import eolify

text = "hello\r\nworld\r\n"

normalized = eolify.normalize_text(
    text,
    eolify.Mode.LF,
)

print(repr(normalized))
# 'hello\nworld\n'

Normalize a file

import eolify

eolify.normalize_file(
    "input.txt",
    "output.txt",
    eolify.Mode.LF,
)

By default, the destination file must not already exist.

eolify.normalize_file(
    "input.txt",
    "output.txt",
    eolify.Mode.LF,
    overwrite=True,
)

Normalize a stream

import eolify

with open("input.txt", "rb") as source:
    with open("output.txt", "wb") as destination:
        eolify.normalize_stream(
            source,
            destination,
            eolify.Mode.LF,
        )

API

normalize_text(text, mode) -> str

Normalize line endings in a string.

Parameters:

• text: Input text.
• mode: Mode.LF or Mode.CRLF.

Returns:

• The normalized string.

normalize_file(input, output, mode, overwrite=False) -> None

Normalize line endings while copying one file to another.

Parameters:

• input: Source file path.
• output: Destination file path.
• mode: Mode.LF or Mode.CRLF.
• overwrite: Whether an existing destination file may be replaced.

normalize_stream(input, output, mode) -> None

Normalize line endings while copying from one binary stream to another.

Parameters:

• input: Binary file-like object opened for reading.
• output: Binary file-like object opened for writing.
• mode: Mode.LF or Mode.CRLF.

Modes

eolify.Mode.LF
eolify.Mode.CRLF

Why eolify?

Python's built-in newline handling is often sufficient, but there are situations where explicit normalization is desirable:

• Converting files between platforms
• Preparing source archives
• Processing generated files
• Build and CI pipelines
• Working with mixed line endings

eolify uses the same Rust implementation as the eolify crate, providing predictable and efficient normalization behavior.