Bilingual Document Formatter

A utility for formatting bilingual documents that contain mixed Hebrew and English text, converting them from logical storage order to visual display order suitable for terminal or text-based output.

Capabilities

Process mixed Hebrew-English text

• Given the text "Hello שלום World", converts it to the correct visual display order @test
• Given the text "2023 was שנה טובה for everyone", reorders it to proper visual display @test

Handle multiple lines with mixed scripts

• Given a multi-line string with Hebrew on the first line and English on the second, processes each line correctly @test

Process text with punctuation in mixed contexts

• Given the text "He said: כן! That's right", maintains correct punctuation positioning @test

Implementation

@generates

API

def format_bilingual_text(text: str) -> str:
    """
    Converts bidirectional text from logical storage order to visual display order.

    Args:
        text: A string containing mixed Hebrew/English text

    Returns:
        The text reordered for proper visual display
    """
    pass

Dependencies { .dependencies }

python-bidi { .dependency }

Provides bidirectional text algorithm implementation for handling mixed LTR/RTL text.

@satisfied-by