rgwfuncs 0.0.111__py3-none-any.whl → 0.0.113__py3-none-any.whl

rgwfuncs/str_lib.py

@@ -101,17 +101,19 @@ def send_telegram_message(message: str, preset_name: Optional[str] = None, bot_t
     response.raise_for_status()
 
 
-def title(text: str, font: str = "slant", typing_speed: float = 0.005) -> None:
+def title(text: str, font: str = "slant", typing_speed: float = 0.005, animate: bool = True) -> None:
     """
-    Print text as ASCII art with a typewriter effect using the specified font (default: slant),
+    Print text as ASCII art with an optional typewriter effect using the specified font (default: slant),
     indented by 4 spaces. All output, including errors and separators, is printed with the
-    typewriter effect within this function.
+    typewriter effect if animate is True.
 
     Args:
         text (str): The text to convert to ASCII art.
         font (str, optional): The pyfiglet font to use. Defaults to "slant".
         typing_speed (float, optional): Delay between printing each character in seconds.
                                       Defaults to 0.005.
+        animate (bool, optional): If True, applies typewriter effect. If False, prints instantly.
+                                 Defaults to True.
 
     Raises:
         ValueError: If the specified font is invalid or unavailable.
@@ -129,20 +131,26 @@ def title(text: str, font: str = "slant", typing_speed: float = 0.005) -> None:
         # Indent each line by 4 spaces
         indented_ascii_art = '\n'.join('    ' + line for line in ascii_art.splitlines())
 
-        # Print ASCII art with typewriter effect
+        # Print ASCII art with or without typewriter effect
         print(heading_color, end='')
-        for char in indented_ascii_art + '\n':
-            print(char, end='', flush=True)
-            if char != '\n':  # Don't delay on newlines
-                time.sleep(typing_speed)
+        if animate:
+            for char in indented_ascii_art + '\n':
+                print(char, end='', flush=True)
+                if char != '\n':  # Don't delay on newlines
+                    time.sleep(typing_speed)
+        else:
+            print(indented_ascii_art + '\n', end='', flush=True)
         print(reset_color, end='')
 
-        # Print separator line with typewriter effect
+        # Print separator line with or without typewriter effect
         print(heading_color, end='')
-        for char in '=' * 79 + '\n':
-            print(char, end='', flush=True)
-            if char != '\n':
-                time.sleep(typing_speed)
+        if animate:
+            for char in '=' * 79 + '\n':
+                print(char, end='', flush=True)
+                if char != '\n':
+                    time.sleep(typing_speed)
+        else:
+            print('=' * 79 + '\n', end='', flush=True)
         print(reset_color, end='')
 
     except Exception as e:
@@ -150,19 +158,26 @@ def title(text: str, font: str = "slant", typing_speed: float = 0.005) -> None:
         if "font" in str(e).lower():
             error_msg = f"Invalid or unavailable font: {font}. Ensure the font is supported by pyfiglet.\n"
             print(reset_color, end='')
+            if animate:
+                for char in error_msg:
+                    print(char, end='', flush=True)
+                    if char != '\n':
+                        time.sleep(typing_speed)
+            else:
+                print(error_msg, end='', flush=True)
+            raise ValueError(error_msg)
+        error_msg = f"Error generating ASCII art for \"{text}\" with font {font}: {e}\n"
+        print(reset_color, end='')
+        if animate:
             for char in error_msg:
                 print(char, end='', flush=True)
                 if char != '\n':
                     time.sleep(typing_speed)
-            raise ValueError(error_msg)
-        error_msg = f"Error generating ASCII art for \"{text}\" with font {font}: {e}\n"
-        print(reset_color, end='')
-        for char in error_msg:
-            print(char, end='', flush=True)
-            if char != '\n':
-                time.sleep(typing_speed)
+        else:
+            print(error_msg, end='', flush=True)
         raise RuntimeError(error_msg)
 
+
 def heading(text: str, typing_speed: float = 0.002) -> None:
     """
     Print a heading with the specified text in uppercase,

{rgwfuncs-0.0.111.dist-info → rgwfuncs-0.0.113.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rgwfuncs
-Version: 0.0.111
+Version: 0.0.113
 Summary: A functional programming paradigm for mathematical modelling and data science
 Home-page: https://github.com/ryangerardwilson/rgwfuncs
 Author: Ryan Gerard Wilson

rgwfuncs-0.0.113.dist-info/RECORD

@@ -0,0 +1,11 @@
+rgwfuncs/__init__.py,sha256=WafmLtqJRnQ7LWU7Son0inje75tF-m6qHJqrmCgiM84,1354
+rgwfuncs/df_lib.py,sha256=lcKrMj8IpxWxnWkBFekWBQd9-Ed2nXTsHo57gTeATjE,85153
+rgwfuncs/docs_lib.py,sha256=i63NzX-V8cGhikYdtkRGAEe2VcuwpXxDUyTRa9xI7l8,1972
+rgwfuncs/interactive_shell_lib.py,sha256=YeJBW9YgH5Nv77ONdOyIKFgtf0ItXStdlKGN9GGf8bU,4228
+rgwfuncs/str_lib.py,sha256=vQ4CYzSLYDIWh4WM1Kjhbg6DqbX4rX6VKdJ_EBJJVyE,11322
+rgwfuncs-0.0.113.dist-info/licenses/LICENSE,sha256=jLvt20gcUZYB8UOvyBvyKQ1qhYYhD__qP7ZDx2lPFkU,1062
+rgwfuncs-0.0.113.dist-info/METADATA,sha256=a7_g8iP1CxnhsQJFe7kmnYa6eIahl0jiRLlq4B7B-Ww,42972
+rgwfuncs-0.0.113.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+rgwfuncs-0.0.113.dist-info/entry_points.txt,sha256=j-c5IOPIQ0252EaOV6j6STio56sbXl2C4ym_fQ0lXx0,43
+rgwfuncs-0.0.113.dist-info/top_level.txt,sha256=aGuVIzWsKiV1f2gCb6mynx0zx5ma0B1EwPGFKVEMTi4,9
+rgwfuncs-0.0.113.dist-info/RECORD,,

rgwfuncs-0.0.111.dist-info/RECORD

@@ -1,11 +0,0 @@
-rgwfuncs/__init__.py,sha256=WafmLtqJRnQ7LWU7Son0inje75tF-m6qHJqrmCgiM84,1354
-rgwfuncs/df_lib.py,sha256=lcKrMj8IpxWxnWkBFekWBQd9-Ed2nXTsHo57gTeATjE,85153
-rgwfuncs/docs_lib.py,sha256=i63NzX-V8cGhikYdtkRGAEe2VcuwpXxDUyTRa9xI7l8,1972
-rgwfuncs/interactive_shell_lib.py,sha256=YeJBW9YgH5Nv77ONdOyIKFgtf0ItXStdlKGN9GGf8bU,4228
-rgwfuncs/str_lib.py,sha256=rfzRd7bOc0KQ7UxUN-J6yxY23pHEUHqerVR1u-TyIAY,10690
-rgwfuncs-0.0.111.dist-info/licenses/LICENSE,sha256=jLvt20gcUZYB8UOvyBvyKQ1qhYYhD__qP7ZDx2lPFkU,1062
-rgwfuncs-0.0.111.dist-info/METADATA,sha256=Krg_iCOkr1AD2LJai679k3oLih0ljcr15Lt4was6H48,42972
-rgwfuncs-0.0.111.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-rgwfuncs-0.0.111.dist-info/entry_points.txt,sha256=j-c5IOPIQ0252EaOV6j6STio56sbXl2C4ym_fQ0lXx0,43
-rgwfuncs-0.0.111.dist-info/top_level.txt,sha256=aGuVIzWsKiV1f2gCb6mynx0zx5ma0B1EwPGFKVEMTi4,9
-rgwfuncs-0.0.111.dist-info/RECORD,,