refactor: rename classes and update type variables for consistency and clarity

Author: ya7010

src/tppt/__init__.py

@@ -1,21 +1,10 @@
 """Typed Python PowerPoint Tool"""
 
 from tppt import types as types
-from tppt._pptx.presentation import Presentation
-from tppt._pptx.shape import Shape
-from tppt._pptx.slide import Slide, SlideBuilder
-from tppt._pptx.slide_layout import SlideLayout
-from tppt._pptx.slide_master import SlideMaster
-from tppt._tppt.slide_master import tpptSlideMaster
-
-__all__ = [
-    # Pptx
-    "Presentation",
-    "Shape",
-    "Slide",
-    "SlideBuilder",
-    "SlideLayout",
-    "SlideMaster",
-    # tppt
-    "tpptSlideMaster",
-]
+from tppt._pptx.presentation import Presentation as Presentation
+from tppt._pptx.shape import Shape as Shape
+from tppt._pptx.slide import Slide as Slide
+from tppt._pptx.slide import SlideBuilder as SlideBuilder
+from tppt._pptx.slide_layout import SlideLayout as SlideLayout
+from tppt._pptx.slide_master import SlideMaster as SlideMaster
+from tppt._tppt.slide_master import TpptSlideMaster as TpptSlideMaster

src/tppt/_pptx/presentation.py

@@ -6,7 +6,7 @@
 from pptx.presentation import Presentation as PptxPresentation
 
 from tppt._pptx.tree import presentation_to_dict
-from tppt._tppt.slide_master import GenerictpptSlideMaster
+from tppt._tppt.slide_master import GenericTpptSlideMaster
 from tppt.types import FilePath
 
 from .converter import PptxConvertible
@@ -40,8 +40,8 @@ def tree(self) -> dict[str, Any]:
 
     @classmethod
     def builder(
-        cls, slide_master: GenerictpptSlideMaster | None = None
-    ) -> "PresentationBuilder[GenerictpptSlideMaster]":
+        cls, slide_master: GenericTpptSlideMaster | None = None
+    ) -> "PresentationBuilder[GenericTpptSlideMaster]":
         """Get a builder for the presentation."""
         return PresentationBuilder(slide_master)
 
@@ -61,10 +61,10 @@ def from_pptx(cls, pptx_obj: PptxPresentation) -> Self:
         return cls(pptx_obj)
 
 
-class PresentationBuilder(Generic[GenerictpptSlideMaster]):
+class PresentationBuilder(Generic[GenericTpptSlideMaster]):
     """Builder for presentations."""
 
-    def __init__(self, slide_master: GenerictpptSlideMaster | None = None) -> None:
+    def __init__(self, slide_master: GenericTpptSlideMaster | None = None) -> None:
         """Initialize the builder."""
         import pptx
 
@@ -82,3 +82,7 @@ def build(self) -> Presentation:
         """Build the presentation."""
 
         return Presentation(self._pptx)
+
+    def save(self, file: FilePath | IO[bytes]) -> None:
+        """Save the presentation to a file."""
+        self.build().save(file)

src/tppt/_tppt/slide_layout.py

@@ -0,0 +1,9 @@
+from abc import ABC
+
+from tppt._pptx.slide import SlideBuilder
+
+
+class TttpSlideLayout(ABC):
+    @classmethod
+    def builder(cls) -> "SlideBuilder":
+        raise NotImplementedError("tppt.SlideLayout.builder must be implemented")

src/tppt/_tppt/slide_master.py

@@ -1,7 +1,7 @@
 from typing import TypeVar
 
 
-class tpptSlideMaster: ...
+class TpptSlideMaster: ...
 
 
-GenerictpptSlideMaster = TypeVar("GenerictpptSlideMaster", bound=tpptSlideMaster)
+GenericTpptSlideMaster = TypeVar("GenericTpptSlideMaster", bound=TpptSlideMaster)