text_decorators.py

Persian Text Transformation Workflow Documentation

This document outlines the workflow for handling Persian text transformations within the application. These transformations are essential for processing Persian text correctly, considering the unique characteristics of the Persian script and language-specific rules.

🔄 Workflow Steps

Step 1: Splitting Strings Language-Specific

The split_string_language_specific() function takes an input string and splits it into a list of characters or words. This function has special handling for Arabic and Persian texts, ensuring that the splitting accounts for the right-to-left script and language-specific nuances.

def split_string_language_specific(s, english=False):
    # Function implementation

This step is crucial for correctly processing mixed-language texts or texts that include numbers and special characters alongside Persian script.

Step 2: Reshaping Persian Text

To ensure Persian text is displayed correctly in environments that do not natively support Arabic script shaping, the reshape_persian_text() function transforms the script into its correctly shaped form.

def reshape_persian_text(string):
    # Function implementation

This transformation is necessary for displaying Persian text in UI elements or external systems that may not handle right-to-left text correctly.

Step 3: Converting English to Persian Characters

When dealing with license plates or other texts that may include English characters needing conversion to Persian, the convert_english_to_persian() function is used. This function maps English characters and numbers to their Persian equivalents.

def convert_english_to_persian(license_plate, display=False):
    # Function implementation

This conversion is particularly useful for standardizing license plate displays or any textual content requiring a uniform script presentation.

Step 4: Converting Persian to English Characters

Similarly, the convert_persian_to_english() function reverses the process, converting Persian script back into English characters. This is especially useful for processing or storing data in systems that require Roman script.

def convert_persian_to_english(license_plate):
    # Function implementation

This step ensures flexibility in handling data input and output in different scripts, accommodating various processing and storage needs.

🏁 Conclusion

The Persian Text Transformation Workflow is a critical component of the application, ensuring that Persian text is handled accurately and efficiently throughout the system. By correctly splitting, reshaping, and converting text between English and Persian, the application can support a wide range of text processing requirements, making it versatile and user-friendly for both Persian and English-speaking users.