Coverage for src / rtflite / text_conversion / __init__.py: 100%

1""" 

2Text conversion module for LaTeX to Unicode conversion. 

3 

4This module provides functionality to convert LaTeX mathematical symbols 

5and commands to their Unicode equivalents, matching the behavior of the 

6r2rtf package. 

7 

8The main entry point is the `convert_text` function which handles the 

9text_convert parameter found throughout RTF components. 

10""" 

11 

12from .converter import TextConverter 

13from .symbols import LaTeXSymbolMapper 

14 

15 

16# Main public interface 

17def convert_text(text: str | None, enable_conversion: bool = True) -> str | None: 

18 """ 

19 Convert LaTeX symbols in text to Unicode characters. 

20 

21 This function provides the main text conversion interface used throughout 

22 the RTF encoding pipeline. It respects the enable_conversion flag to 

23 allow selective enabling/disabling of conversion. 

24 

25 Args: 

26 text: Input text that may contain LaTeX commands 

27 enable_conversion: Whether to perform LaTeX to Unicode conversion 

28 

29 Returns: 

30 Text with LaTeX commands converted to Unicode (if enabled) 

31 

32 Examples: 

33 >>> convert_text("Area: \\pm 0.05", True) 

34 "Area: +/- 0.05" 

35 

36 >>> convert_text("\\alpha + \\beta", False) 

37 "\\alpha + \\beta" 

38 """ 

39 if not enable_conversion or not text: 

40 return text 

41 

42 converter = TextConverter() 

43 return converter.convert_latex_to_unicode(text) 

44 

45 

46__all__ = [ 

47 "convert_text", 

48 "TextConverter", 

49 "LaTeXSymbolMapper", 

50]