typeglide 0.3.3__tar.gz → 0.3.5__tar.gz

{typeglide-0.3.3 → typeglide-0.3.5}/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 Daksh
+Copyright (c) 2026 Dakshu
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

{typeglide-0.3.3 → typeglide-0.3.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: typeglide
-Version: 0.3.3
+Version: 0.3.5
 Summary: A smooth typewriter text effect library for Python. Works with tkinter too! Made by dakshu.
 Author-email: Dakshu <dakshumail98@gmail.com>
 License-File: LICENSE

{typeglide-0.3.3 → typeglide-0.3.5}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "typeglide"
-version = "0.3.3"
+version = "0.3.5"
 description = "A smooth typewriter text effect library for Python. Works with tkinter too! Made by dakshu."
 readme = "README.md"
 requires-python = ">=3.11.14"

typeglide-0.3.5/typeglide/__init__.py

@@ -0,0 +1,3 @@
+from .engine import write, erase, save, Glide
+
+__version__ = "0.3.5"

typeglide-0.3.5/typeglide/engine.py

@@ -0,0 +1,160 @@
+import sys
+import time
+
+
+def write(text, delay=0.05, end="\n"):
+    """
+    Prints text to the console character by character.
+
+    :param text: The string to print.
+    :param delay: Time in seconds between each character.
+    :param end: The character to print at the very end (defaults to newline).
+    """
+    for char in text:
+        sys.stdout.write(char)
+        sys.stdout.flush()
+        time.sleep(delay)
+    sys.stdout.write(end)
+    sys.stdout.flush()
+
+
+def erase(text, delay=0.05):
+    """
+    Erases text character by character using backspaces.
+
+    :param text: The string to erase (determines how many characters to delete).
+    :param delay: Time in seconds between each character deletion.
+
+    Example:
+        typeglide.write("Hello", end="")
+        typeglide.erase("Hello")
+    """
+    for _ in text:
+        sys.stdout.write('\b \b')
+        sys.stdout.flush()
+        time.sleep(delay)
+
+
+class Glide:
+    """
+    A saveable typewriter-effect object.
+
+    Usage:
+        glide = typeglide.save("Hello", delay=0.05)
+
+        # Terminal — animates character by character:
+        print(glide)
+
+        # Erase the text character by character:
+        glide.erase()
+
+        # Type then erase in one go:
+        glide.type_and_erase()
+
+        # Tkinter static text:
+        button.config(text=glide.text)
+
+        # Tkinter animated text:
+        glide.animate_widget(label)
+    """
+
+    def __init__(self, text, delay=0.05, end="\n"):
+        self.text = text
+        self.delay = delay
+        self.end = end
+
+    def __str__(self):
+        for char in self.text:
+            sys.stdout.write(char)
+            sys.stdout.flush()
+            time.sleep(self.delay)
+        return ""
+
+    def __repr__(self):
+        return f"Glide({self.text!r}, delay={self.delay})"
+
+    def erase(self):
+        """
+        Erases the saved text character by character using backspaces.
+
+        Example:
+            glide = typeglide.save("Hello", delay=0.05)
+            print(glide, end="")  # type it (no newline)
+            glide.erase()         # then erase it
+        """
+        for _ in self.text:
+            sys.stdout.write('\b \b')
+            sys.stdout.flush()
+            time.sleep(self.delay)
+
+    def type_and_erase(self, pause=0.5):
+        """
+        Types the text out, pauses, then erases it character by character.
+
+        :param pause: Seconds to wait between finishing typing and starting to erase.
+
+        Example:
+            glide = typeglide.save("Hello!", delay=0.05)
+            glide.type_and_erase(pause=1)
+        """
+        for char in self.text:
+            sys.stdout.write(char)
+            sys.stdout.flush()
+            time.sleep(self.delay)
+        time.sleep(pause)
+        for _ in self.text:
+            sys.stdout.write('\b \b')
+            sys.stdout.flush()
+            time.sleep(self.delay)
+
+    def animate_widget(self, widget, attr="text"):
+        """
+        Animate the text into a tkinter widget one character at a time.
+
+        :param widget: Any tkinter widget that supports .config().
+        :param attr:   The config attribute to update (default 'text').
+
+        Example:
+            glide.animate_widget(label)
+            glide.animate_widget(button)
+        """
+        delay_ms = int(self.delay * 1000)
+
+        def _step(index):
+            widget.config(**{attr: self.text[:index]})
+            if index < len(self.text):
+                widget.after(delay_ms, _step, index + 1)
+
+        _step(0)
+
+    def erase_widget(self, widget, attr="text"):
+        """
+        Erases the text from a tkinter widget one character at a time.
+
+        :param widget: Any tkinter widget that supports .config().
+        :param attr:   The config attribute to update (default 'text').
+
+        Example:
+            glide.erase_widget(label)
+        """
+        delay_ms = int(self.delay * 1000)
+        length = len(self.text)
+
+        def _step(index):
+            widget.config(**{attr: self.text[:index]})
+            if index > 0:
+                widget.after(delay_ms, _step, index - 1)
+
+        _step(length)
+
+
+def save(text, delay=0.05, end="\n"):
+    """
+    Save a typewriter-effect string for later use.
+
+    :param text:  The string to animate.
+    :param delay: Time in seconds between each character.
+    :param end:   End character used when printing (defaults to newline).
+    :returns:     A Glide object.
+    """
+    return Glide(text, delay=delay, end=end)

typeglide-0.3.3/typeglide/__init__.py

@@ -1,3 +0,0 @@
-from .engine import write, save, Glide
-
-__version__ = "0.3.3"

typeglide-0.3.3/typeglide/engine.py

@@ -1,83 +0,0 @@
-import sys
-import time
-
-
-def write(text, delay=0.05, end="\n"):
-    """
-    Prints text to the console character by character.
-
-    :param text: The string to print.
-    :param delay: Time in seconds between each character.
-    :param end: The character to print at the very end (defaults to newline).
-    """
-    for char in text:
-        sys.stdout.write(char)
-        sys.stdout.flush()
-        time.sleep(delay)
-    sys.stdout.write(end)
-    sys.stdout.flush()
-
-
-class Glide:
-    """
-    A saveable typewriter-effect object.
-
-    Usage:
-        glide = typeglide.save("Hello", delay=0.05)
-
-        # Terminal — animates character by character:
-        print(glide)
-
-        # Tkinter static text:
-        button.config(text=glide.text)
-
-        # Tkinter animated text:
-        glide.animate_widget(button)
-    """
-
-    def __init__(self, text, delay=0.05, end="\n"):
-        self.text = text
-        self.delay = delay
-        self.end = end
-
-    def __str__(self):
-        for char in self.text:
-            sys.stdout.write(char)
-            sys.stdout.flush()
-            time.sleep(self.delay)
-        return ""
-
-    def __repr__(self):
-        return f"Glide({self.text!r}, delay={self.delay})"
-
-    def animate_widget(self, widget, attr="text"):
-        """
-        Animate the text into a tkinter widget one character at a time.
-
-        :param widget: Any tkinter widget that supports .config().
-        :param attr:   The config attribute to update (default 'text').
-
-        Example:
-            glide.animate_widget(button)
-            glide.animate_widget(label)
-        """
-        delay_ms = int(self.delay * 1000)
-
-        def _step(index):
-            widget.config(**{attr: self.text[:index]})
-            if index < len(self.text):
-                widget.after(delay_ms, _step, index + 1)
-
-        _step(0)
-
-
-def save(text, delay=0.05, end="\n"):
-    """
-    Save a typewriter-effect string for later use.
-
-    :param text:  The string to animate.
-    :param delay: Time in seconds between each character.
-    :param end:   End character used when printing (defaults to newline).
-    :returns:     A Glide object.
-    """
-    return Glide(text, delay=delay, end=end)