refactor: simplify type annotations in formatted_text functions and enhance module docstring

Author: ya7010

examples/formatted_text.py

@@ -3,13 +3,12 @@
 from pathlib import Path
 
 import tppt
-import tppt.pptx.shape.text
 
 EXAMPLE_DIR = Path(__file__).parent
 
 
 def main():
-    def formatted_text(text: tppt.pptx.shape.text.Text, /) -> tppt.pptx.shape.text.Text:
+    def formatted_text(text: tppt.pptx.Text, /) -> tppt.pptx.Text:
         run = text.text_frame.add_paragraph().add_run()
         run.text = "Hello, world!"
         font = run.font
@@ -19,14 +18,14 @@ def formatted_text(text: tppt.pptx.shape.text.Text, /) -> tppt.pptx.shape.text.T
         return text
 
     def functional_text(
-        text_obj: tppt.pptx.shape.text.Text,
+        text_obj: tppt.pptx.Text,
         /,
         *,
         text: str,
         bold: bool = False,
         italic: bool = False,
         color: tppt.types.Color | tppt.types.LiteralColor | None = None,
-    ) -> tppt.pptx.shape.text.Text:
+    ) -> tppt.pptx.Text:
         run = text_obj.text_frame.add_paragraph().add_run()
         run.text = text
         font = run.font

src/tppt/__init__.py

@@ -1,17 +1,16 @@
-"""Typed Python PowerPoint Tool"""
+"""🐍 🛡️ Typed Python PowerPoint Tool 🛡️ 🐍"""
 
 import importlib.metadata
 from typing import Callable, Concatenate, ParamSpec, TypeVar
 
-from tppt.pptx import Presentation as Presentation
-from tppt.template.slide_layout import Placeholder as Placeholder
-from tppt.template.slide_layout import SlideLayout as SlideLayout
-from tppt.template.slide_master import Layout as Layout
-from tppt.template.slide_master import SlideMaster as SlideMaster
-from tppt.template.slide_master import slide_master as slide_master
-
 from . import pptx as pptx
 from . import types as types
+from .pptx import Presentation as Presentation
+from .template.slide_layout import Placeholder as Placeholder
+from .template.slide_layout import SlideLayout as SlideLayout
+from .template.slide_master import Layout as Layout
+from .template.slide_master import SlideMaster as SlideMaster
+from .template.slide_master import slide_master as slide_master
 
 __version__ = importlib.metadata.version("tppt")