TurtleExtension 1.0.0__tar.gz → 2.1.0__tar.gz

{turtleextension-1.0.0 → turtleextension-2.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: TurtleExtension
-Version: 1.0.0
+Version: 2.1.0
 Summary: A Python utility library providing turtle extensions on top of Python's original turtle feature.
 Author-email: "Miah M. Sabiq" <miah.sabiq@gibs.at>
 Requires-Python: >=3.14
@@ -30,7 +30,7 @@ TurtleExtension is a Python project dedicated to extending and experimenting wit
 Once published to PyPI, install with:
 
 ```bash
-python -m pip install TurtleExtension
+python -m pip install turtle_extension
 ```
 
 ## Usage
@@ -38,7 +38,7 @@ python -m pip install TurtleExtension
 ```python
 import turtle
 
-# Your TurtleExtension functionality goes here.
+# Your turtle_extension functionality goes here.
 ```
 
 The public API and usage examples will be documented as the project develops.
@@ -49,7 +49,7 @@ Clone the repository:
 
 ```bash
 git clone https://github.com/YOUR-USERNAME/TurtleExtension.git
-cd TurtleExtension
+cd turtle_extension
 ```
 
 Install the package locally if your project contains a `pyproject.toml`:

{turtleextension-1.0.0 → turtleextension-2.1.0}/README.md

@@ -19,7 +19,7 @@ TurtleExtension is a Python project dedicated to extending and experimenting wit
 Once published to PyPI, install with:
 
 ```bash
-python -m pip install TurtleExtension
+python -m pip install turtle_extension
 ```
 
 ## Usage
@@ -27,7 +27,7 @@ python -m pip install TurtleExtension
 ```python
 import turtle
 
-# Your TurtleExtension functionality goes here.
+# Your turtle_extension functionality goes here.
 ```
 
 The public API and usage examples will be documented as the project develops.
@@ -38,7 +38,7 @@ Clone the repository:
 
 ```bash
 git clone https://github.com/YOUR-USERNAME/TurtleExtension.git
-cd TurtleExtension
+cd turtle_extension
 ```
 
 Install the package locally if your project contains a `pyproject.toml`:

{turtleextension-1.0.0 → turtleextension-2.1.0}/TurtleExtension.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: TurtleExtension
-Version: 1.0.0
+Version: 2.1.0
 Summary: A Python utility library providing turtle extensions on top of Python's original turtle feature.
 Author-email: "Miah M. Sabiq" <miah.sabiq@gibs.at>
 Requires-Python: >=3.14
@@ -30,7 +30,7 @@ TurtleExtension is a Python project dedicated to extending and experimenting wit
 Once published to PyPI, install with:
 
 ```bash
-python -m pip install TurtleExtension
+python -m pip install turtle_extension
 ```
 
 ## Usage
@@ -38,7 +38,7 @@ python -m pip install TurtleExtension
 ```python
 import turtle
 
-# Your TurtleExtension functionality goes here.
+# Your turtle_extension functionality goes here.
 ```
 
 The public API and usage examples will be documented as the project develops.
@@ -49,7 +49,7 @@ Clone the repository:
 
 ```bash
 git clone https://github.com/YOUR-USERNAME/TurtleExtension.git
-cd TurtleExtension
+cd turtle_extension
 ```
 
 Install the package locally if your project contains a `pyproject.toml`:

turtleextension-2.1.0/TurtleExtension.egg-info/SOURCES.txt

@@ -0,0 +1,21 @@
+LICENSE
+README.md
+pyproject.toml
+TurtleExtension.egg-info/PKG-INFO
+TurtleExtension.egg-info/SOURCES.txt
+TurtleExtension.egg-info/dependency_links.txt
+TurtleExtension.egg-info/requires.txt
+TurtleExtension.egg-info/top_level.txt
+turtle_extension/__init__.py
+turtle_extension/foundations/__init__.py
+turtle_extension/foundations/custom_turtle_shapes.py
+turtle_extension/foundations/custom_turtle_shapes.pyi
+turtle_extension/foundations/global_functions.py
+turtle_extension/foundations/global_functions.pyi
+turtle_extension/foundations/global_variables.py
+turtle_extension/foundations/global_variables.pyi
+turtle_extension/foundations/turtle_functions.py
+turtle_extension/foundations/turtle_functions.pyi
+turtle_extension/turtle_heart/__init__.py
+turtle_extension/turtle_heart/turtle_skeleton.py
+turtle_extension/turtle_heart/turtle_skeleton.pyi

turtleextension-2.1.0/TurtleExtension.egg-info/top_level.txt

@@ -0,0 +1 @@
+turtle_extension

{turtleextension-1.0.0 → turtleextension-2.1.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "TurtleExtension"
-version = "1.0.0"
+version = "2.1.0"
 description = "A Python utility library providing turtle extensions on top of Python's original turtle feature."
 readme = "README.md"
 requires-python = ">= 3.14"
@@ -19,5 +19,10 @@ authors = [
 
 [tool.setuptools.packages.find]
 include = [
-    "TurtleExtension*",
+    "turtle_extension*",
+]
+
+[tool.ruff.lint]
+ignore = [
+    "RUF022",
 ]

turtleextension-2.1.0/turtle_extension/__init__.py

@@ -0,0 +1,63 @@
+"""
+This package is part of the GeometricalDomination project ecosystem.
+
+It contains a chainable turtle class called ChainTurtle and a collection of extra provided features along with it:
+
+1. tls_color -> this function make a list of colored turtles and returns it
+2. get_screen -> turtle screen initializer function
+3. SU -> screen update function
+
+And a lot more.
+
+Author: Miah M. Sabiq
+"""
+
+#* Imports foundational functions across numerous files
+from .foundations import (
+   CUSTOM_SHAPES,       #* [[custom_turtle_shapes.py]]
+   get_UserShape_dict,  #* [[custom_turtle_shapes.py#get_UserShape_dict]]
+
+   get_screen,          #* [[global_functions.py#get_screen]]
+   mainloop,            #* [[global_functions.py#mainloop]]
+   reset_tls,           #* [[global_functions.py#reset_tls]]
+   SU,                  #* [[global_functions.py#SU]]
+   tls_color,           #* [[global_functions.py#tls_color]]
+
+   t_now,               #* [[global_variables.py#t_now]]
+   t_shape,             #* [[global_variables.py#t_shape]]
+   UV,                  #* [[global_variables.py]]
+
+   TurtleFct,           #* [[TurtleFct]]
+   UserShape,           #* [[UserShape]]
+)
+
+#* Imports core mechanisms of this package:
+#*  [[ChainTurtle]] and [[turtle.py]] from [[turtle_skeleton.py]]
+from .turtle_heart import (
+   ChainTurtle,         #* [[ChainTurtle]]
+   tl,                  #* [[turtle.py]]
+)
+
+
+#* Specifies all available functions and dictionaries through wild card import
+__all__ = [
+    "UV",
+    "t_now",
+    "t_shape",
+
+    "get_screen",
+    "SU",
+    "mainloop",
+    "tls_color",
+    "reset_tls",
+
+    "UserShape",
+    "get_UserShape_dict",
+    "CUSTOM_SHAPES",
+
+    "TurtleFct",
+
+
+   "ChainTurtle",
+   "tl",
+]

turtleextension-2.1.0/turtle_extension/foundations/__init__.py

@@ -0,0 +1,48 @@
+#* Imports function, class and dictionary from [[custom_turtle_shapes.py]]
+from .custom_turtle_shapes import (
+    CUSTOM_SHAPES,
+    UserShape,
+    get_UserShape_dict,
+)
+
+#* Imports fundamental turtle functions from [[global_functions.py]]
+from .global_functions import (
+    SU,
+    get_screen,
+    mainloop,
+    reset_tls,
+    tls_color,
+)
+
+#* Imports universal dictionary and related functions from [[global_variables.py]]
+from .global_variables import (
+    UV,
+    t_now,
+    t_shape,
+)
+
+#* Imports class from [[turtle_functions.py]]
+from .turtle_functions import (
+    TurtleFct,
+)
+
+
+#* Specifies functions, classes, and dictionaries available in foundations package
+#* through wild card import
+__all__ = [
+    "UV",
+    "t_now",
+    "t_shape",
+
+    "get_screen",
+    "SU",
+    "mainloop",
+    "tls_color",
+    "reset_tls",
+
+    "UserShape",
+    "get_UserShape_dict",
+    "CUSTOM_SHAPES",
+
+    "TurtleFct",
+]

turtleextension-1.0.0/TurtleExtension/Foundations/CustomTurtleShapes.py → turtleextension-2.1.0/turtle_extension/foundations/custom_turtle_shapes.py

@@ -1,10 +1,11 @@
-from ..TurtleHeart import tl
 from numbers import Real
-import UF as uf
 
+import uf
 
-helper = uf.helper
+from ..turtle_heart import tl
 
+
+#* Class containing all premade turtle shape functions
 @uf.cls_deco_superposition(staticmethod)
 class UserShape:
     def custom_circle():
@@ -15,7 +16,7 @@ class UserShape:
         return tl.get_poly()
 
     def custom_square():
-        length: Real = helper.length_float()
+        length: Real = uf.helper.length_float()
         tl.begin_poly()
 
         for _ in range(4):
@@ -26,7 +27,7 @@ class UserShape:
         return tl.get_poly()
 
     def custom_triangle():
-        length: Real = helper.length_float()
+        length: Real = uf.helper.length_float()
         tl.begin_poly()
 
         for _ in range(3):
@@ -37,8 +38,8 @@ class UserShape:
         return tl.get_poly()
 
     def custom_poly():
-        length: Real = helper.length_float()
-        sides: int = helper.sides_num()
+        length: Real = uf.helper.length_float()
+        sides: int = uf.helper.sides_num()
 
         radius = length / (2 * uf.sine(180 / sides))
         angle_to_right = (180 - (180 * (sides - 2)) / sides) / 2
@@ -52,7 +53,7 @@ class UserShape:
         return tl.get_poly()
 
     def custom_SOD():
-        side: Real = helper.length_float()
+        side: Real = uf.helper.length_float()
         tl.begin_poly()
 
         for _ in range(6):
@@ -64,15 +65,20 @@ class UserShape:
         tl.end_poly()
         return tl.get_poly()
 
+    #* Creates and returns a dictionary mapping [[UserShape]]
+    #* function names with their corresponding function
     @classmethod
-    def _list_shapes(cls):
+    def list_shapes(cls):
         return uf.classes_to_dict(cls)
 
+#* Creates a customized dictionary mapping [[UserShape]] functions by having the
+#* prefix "custom_" switched with cm
 def get_UserShape_dict():
     return {
         f"cm {name.removeprefix('custom_')}": func
-        for name, func in UserShape._list_shapes().items()
+        for name, func in UserShape.list_shapes().items()
         if not name.startswith("_")
     }
 
+#* [[UserShape]] dictionary storage
 CUSTOM_SHAPES = get_UserShape_dict()

turtleextension-1.0.0/TurtleExtension/Foundations/CustomTurtleShapes.pyi → turtleextension-2.1.0/turtle_extension/foundations/custom_turtle_shapes.pyi

@@ -2,70 +2,70 @@
 This module contains the class Usershape which contains functions to make a customized turtle shape.
 """
 
-from numbers import Real
 from collections.abc import Callable, Sequence
+from numbers import Real
+
+
+#* The type returned by each turtle shape changer function from [[UserShape]]
+type ReturnShapeType = Sequence[tuple[Real,Real]] | None
 
+#* The type of the dictionary derived from [[UserShape]]
+type UserShapeDictType = dict[
+    str,
+    Callable[[], ReturnShapeType]
+]
 
-type return_shape = Sequence[tuple[Real,Real]] | None
-type user_shape_dict = dict[str, Callable[[], return_shape]]
 
 class UserShape:
     """
     This class contains different custom turtle shape maker functions
     """
     @staticmethod
-    def custom_circle() -> return_shape:
+    def custom_circle() -> ReturnShapeType:
         """
         Creates a custom circle turtle shape.
         :return: the custom shape
         """
-        ...
 
     @staticmethod
-    def custom_square() -> return_shape:
+    def custom_square() -> ReturnShapeType:
         """
         Creates a custom square turtle shape.
         :return: the custom shape
         """
-        ...
 
     @staticmethod
-    def custom_triangle() -> return_shape:
+    def custom_triangle() -> ReturnShapeType:
         """
         Creates a custom equilateral triangle turtle shape.
         :return: the custom shape
         """
-        ...
 
     @staticmethod
-    def custom_poly() -> return_shape:
+    def custom_poly() -> ReturnShapeType:
         """
         Creates a custom regular polygon turtle shape.
         :return: the custom shape
         """
-        ...
 
     @staticmethod
-    def custom_SOD() -> return_shape:
+    def custom_SOD() -> ReturnShapeType:
         """
         Creates a custom star of David turtle shape.
         :return: the custom shape
         """
-        ...
 
     @classmethod
-    def _list_shapes(cls) -> user_shape_dict:
+    def list_shapes(cls) -> UserShapeDictType:
         """
         Creates a dictionary with the functions in UserShape and returns it
         :return: dictionary containing function names -> function
         """
-        ...
 
-def get_UserShape_dict() -> user_shape_dict:
+def get_UserShape_dict() -> UserShapeDictType:
     """
     Takes all custom turtle functions in UserShape and returns a dictionary with them
     :return: dictionary mapping function names to functions
     """
-    ...
 
-CUSTOM_SHAPES: user_shape_dict
+CUSTOM_SHAPES: UserShapeDictType

turtleextension-1.0.0/TurtleExtension/Foundations/GlobalFunctions.py → turtleextension-2.1.0/turtle_extension/foundations/global_functions.py

@@ -1,13 +1,16 @@
-from ..TurtleHeart import tl, ChainTurtle
-from .GlobalVariables import t_shape, UV
-from turtle import TurtleGraphicsError
 from time import sleep as rest
-import UF as uf
-from typing import Final, Literal
+from turtle import TurtleGraphicsError
+from typing import Final
+
+import uf
 
+from ..turtle_heart import ChainTurtle, tl
+from .global_variables import UV, t_shape
 
 _screen = None
 
+#* Retrieves the turtle screen [[turtle.py#Screen]] if one has been made,
+#* else, a new screen is initialized
 def get_screen():
     global _screen
 
@@ -18,19 +21,23 @@ def get_screen():
 
     return _screen
 
+#* Updates the current turtle screen if one exists,
+#* else a new one is created and updated
 def SU():
     get_screen().update()
 
+#* Keeps the turtle window open if one exists,
+#* else a new one is created and kept open
 def mainloop():
     get_screen().mainloop()
 
-type turtle_list = list[ChainTurtle]
-
+#* Creates a chosen number of turtles with different modes,
+#* also known as the turtle factory by the developer
 def tls_color(**options):
 
-    tl_num_name: Final[Literal["tl_num"]] = "tl_num"
-    entry_name: Final[Literal["entry"]] = "entry"
-    index_name: Final[Literal["index"]] = "index"
+    tl_num_name: Final = "tl_num"
+    entry_name: Final = "entry"
+    index_name: Final = "index"
 
     if tl_num_name in options:
         tl_num = options[tl_num_name]
@@ -51,7 +58,8 @@ def tls_color(**options):
     else:
         print("NONE of the entered options exist!")
         return None
-    tls: turtle_list = []
+
+    tls: list[ChainTurtle] = []
 
     for color_num in range(turtles_num_count):
         while True:
@@ -77,10 +85,11 @@ def tls_color(**options):
         return tls
     return None
 
-
+#* Resets the provided turtle list,
+#* deletes all turtle drawings and the turtles themselves
 def reset_tls(tls_list):
 
-    tls_list_name: Final[Literal["tls_list"]] = "tls_list"
+    tls_list_name: Final = "tls_list"
     uf.TypeValidate(list)(tls_list, name=tls_list_name)
     uf.SequenceValidate(ChainTurtle, ...)(tls_list, name=tls_list_name)
 

turtleextension-1.0.0/TurtleExtension/Foundations/GlobalFunctions.pyi → turtleextension-2.1.0/turtle_extension/foundations/global_functions.pyi

@@ -3,7 +3,7 @@ This module contains a very useful function: tls_color, which lets the user crea
 colors and get a list with them.
 """
 
-from ..TurtleHeart import tl, ChainTurtle
+from ..turtle_heart import ChainTurtle, tl
 
 
 def get_screen() -> tl.Screen:
@@ -11,25 +11,22 @@ def get_screen() -> tl.Screen:
     Initiates the turtle screen when the function is called.
     :return: turtle screen object
     """
-    ...
 
 def SU() -> None:
     """
     This function updates the turtle screen.
     :return: None
     """
-    ...
 
 def mainloop() -> None:
     """
     This function keeps the turtle screen open.
     :return: None
     """
-    ...
 
-type turtle_list = list[ChainTurtle]
+type TurtleListType = list[ChainTurtle]
 
-def tls_color(**options) -> int | tuple[turtle_list, int] | turtle_list | None:
+def tls_color(**options) -> int | tuple[TurtleListType, int] | TurtleListType | None:
     """This function creates a turtle list with their colors or adds newly creates turtles to the UV["tls"] list
     to be used for the user_drawing_ft()
 
@@ -39,9 +36,8 @@ def tls_color(**options) -> int | tuple[turtle_list, int] | turtle_list | None:
     & it returns the index of the last turtle
     :return: tls_num: turtle list with colored turtles, entry: list with colored turtles + number of turtles ,otherwise: index of last turtle
     """
-    ...
 
-def reset_tls(tls_list: turtle_list) -> list:
+def reset_tls(tls_list: TurtleListType) -> list:
     """
     This function deletes the drawings of given turtle list + turtles
 

turtleextension-2.1.0/turtle_extension/foundations/global_variables.py

@@ -0,0 +1,15 @@
+#* UV = UNIVERSAL VARIABLES
+UV = {
+    "delay": None,              #* Delay for [[turtle_runner.py#user_drawing_ft]]
+      "t": 0,                   #* user_drawing_ft's current turtle
+      "tls": [],                #* user_drawing_ft's turtle list
+      "tls_shape": "arrow",     #* turtle's current shape
+}
+
+#* Retrieves the current turtle from UV
+def t_now():
+    return UV["tls"][UV["t"]]
+
+#* Retrieves the current turtle shape
+def t_shape():
+    return UV["tls_shape"]

turtleextension-1.0.0/TurtleExtension/Foundations/GlobalVariables.pyi → turtleextension-2.1.0/turtle_extension/foundations/global_variables.pyi

@@ -9,9 +9,11 @@ t_shape() -> lets users take the current turtle shape
 """
 
 from typing import Any
-from ..TurtleHeart import ChainTurtle
 
+from ..turtle_heart import ChainTurtle
 
+
+#* The type for the [[global_variables.py]] UV dictionary
 UV: dict[str, Any]
 
 def t_now() -> ChainTurtle:
@@ -25,7 +27,6 @@ def t_now() -> ChainTurtle:
 
     :return: ChainTurtle
     """
-    ...
 
 def t_shape() -> str:
     """
@@ -37,4 +38,3 @@ def t_shape() -> str:
 
     :return: string
     """
-    ...

turtleextension-1.0.0/TurtleExtension/Foundations/TurtleFunctions.py → turtleextension-2.1.0/turtle_extension/foundations/turtle_functions.py

@@ -1,10 +1,13 @@
-from ..TurtleHeart import tl, ChainTurtle
-from .GlobalVariables import UV
-from .CustomTurtleShapes import CUSTOM_SHAPES
-import UF as uf
+import uf
 
+from ..turtle_heart import ChainTurtle, tl
+from .custom_turtle_shapes import CUSTOM_SHAPES
+from .global_variables import UV
 
+
+#* Class containing turtle shape changer functions
 class TurtleFct:
+    #* Main turtle shape changer function, potentially triggers [[TurtleFct#user_tls_shape_ft]]
     @classmethod
     def change_shape(cls, tls_num = None):
         if tls_num is not None:
@@ -31,6 +34,7 @@ class TurtleFct:
             else:
                 return cls.user_tls_shape_ft()
 
+    #* Lets the user choose custom shapes from [[UserShape]]
     @staticmethod
     def user_tls_shape_ft(tls_num = None):
         if tls_num is not None:

turtleextension-1.0.0/TurtleExtension/Foundations/TurtleFunctions.pyi → turtleextension-2.1.0/turtle_extension/foundations/turtle_functions.pyi

@@ -2,7 +2,7 @@
 This module contains the class TurtleFct which lets the user change the turtle shape to a customized one.
 """
 
-from ..TurtleHeart import ChainTurtle
+from ..turtle_heart import ChainTurtle
 
 
 class TurtleFct:
@@ -16,7 +16,6 @@ class TurtleFct:
         :param tls_num: ChainTurtle() or None
         :return: ChainTurtle() if tls_num is a ChainTurtle(), otherwise None
         """
-        ...
 
     @staticmethod
     def user_tls_shape_ft(tls_num: ChainTurtle | None = None) -> ChainTurtle | str:
@@ -24,5 +23,4 @@ class TurtleFct:
         This function lets the user create custom turtle shapes.
         :param tls_num: ChainTurtle() or None
         :return: ChainTurtle() if tls_num is a ChainTurtle(), otherwise None
-        """
-        ...
+        """

turtleextension-2.1.0/turtle_extension/turtle_heart/__init__.py

@@ -0,0 +1,8 @@
+#* Imports the [[ChainTurtle]] and [[turtle.py]] from [[turtle_skeleton.py]]
+from .turtle_skeleton import ChainTurtle, tl
+
+#* Specifies the classes found in [[turtle_skeleton.py]]
+__all__ = [
+    "ChainTurtle",
+    "tl",
+]

turtleextension-1.0.0/TurtleExtension/TurtleHeart/TurtleSkeleton.py → turtleextension-2.1.0/turtle_extension/turtle_heart/turtle_skeleton.py

@@ -1,7 +1,9 @@
 import turtle as tl
-import UF as uf
 
+import uf
 
+
+#* Class for chaining the conventional turtle functions [[turtle.py]]
 class ChainTurtle(tl.Turtle):
     def fd(self, distance):
         super().fd(distance)
@@ -95,6 +97,7 @@ class ChainTurtle(tl.Turtle):
         super().ht()
         return self
 
+#* Creates and returns a dictionary with all [[ChainTurtle]] functions
     @classmethod
     def list_methods(cls):
         return uf.classes_to_dict(cls)

turtleextension-1.0.0/TurtleExtension/TurtleHeart/TurtleSkeleton.pyi → turtleextension-2.1.0/turtle_extension/turtle_heart/turtle_skeleton.pyi

@@ -2,8 +2,8 @@
 This module contains the class ChainTurtle() which is the foundational object around which this entire software has been made.
 """
 
-from numbers import Real
 from collections.abc import Callable
+from numbers import Real
 
 
 tl = tl
@@ -16,7 +16,6 @@ class ChainTurtle:
         :param distance: distance in pixels
         :return: ChainTurtle()
         """
-        ...
 
     def fd_inv(self, distance: Real) -> ChainTurtle:
         """
@@ -24,7 +23,6 @@ class ChainTurtle:
         :param distance: distance in pixels
         :return: ChainTurtle()
         """
-        ...
 
     def bk(self, distance: Real) -> ChainTurtle:
         """
@@ -32,7 +30,6 @@ class ChainTurtle:
         :param distance: distance in pixels
         :return: ChainTurtle()
         """
-        ...
 
     def bk_inv(self, distance: Real) -> ChainTurtle:
         """
@@ -40,7 +37,6 @@ class ChainTurtle:
         :param distance: distance in pixels
         :return: ChainTurtle()
         """
-        ...
 
     def rt(self, angle: Real) -> ChainTurtle:
         """
@@ -48,7 +44,6 @@ class ChainTurtle:
         :param angle: angle in degrees
         :return: ChainTurtle()
         """
-        ...
 
     def lt(self, angle: Real) -> ChainTurtle:
         """
@@ -56,7 +51,6 @@ class ChainTurtle:
         :param angle: angle in degrees
         :return: ChainTurtle()
         """
-        ...
 
     def setpos(self, x_val: Real, y_val: Real) -> ChainTurtle:
         """
@@ -65,61 +59,54 @@ class ChainTurtle:
         :param y_val: y position in pixels
         :return: ChainTurtle()
         """
-        ...
 
     def pu(self) -> ChainTurtle:
         """
         Puts the pen down to leave a trace.
         :return: ChainTurtle()
         """
-        ...
 
     def pd(self) -> ChainTurtle:
         """
         Puts the pen up to not leave a trace.
         :return: ChainTurtle()
         """
-        ...
 
     def seth(self, direction: Real) -> ChainTurtle:
         """
         Sets the direction of the turtle starting East, going counterclockwise.
         :param direction: direction in degrees
+        :return: ChainTurtle()
         """
-        ...
 
     def home(self) -> ChainTurtle:
         """
         Sets the position of the turtle to home (0, 0) with trace, heading = 0 .
         :return: ChainTurtle()
         """
-        ...
 
     def home_inv(self) -> ChainTurtle:
         """
         Sets the position of the turtle to home (0, 0) without trace, heading = 0 .
         :return: ChainTurtle()
         """
-        ...
 
     def begin_fill(self) -> ChainTurtle:
         """
         Makes the turtle begin fill for a closed shape.
         :return: ChainTurtle()
         """
-        ...
 
     def end_fill(self) -> ChainTurtle:
         """
         Ends the turtle fill for a closed shape, therefore fills the shapes.
         :return: ChainTurtle()
         """
-        ...
 
     def circle(self,
                radius: Real,
                extent: Real | None = None,
-               steps: int = None) -> ChainTurtle:
+               steps: int | None = None) -> ChainTurtle:
         """
         Makes the turtle draw a circle
         :param radius: radius in pixels
@@ -127,74 +114,69 @@ class ChainTurtle:
         :param steps: number of sides
         :return: ChainTurtle()
         """
-        ...
 
     def circle_fill(self,
                     radius: Real,
                     angle: Real | None = None,
-                    sides: int = None) -> ChainTurtle:
+                    sides: int | None = None) -> ChainTurtle:
         """
         Makes the turtle draw a circle and fills it
         :param radius: radius in degrees
         :param angle: angle in degrees
         :param sides: number of sides
+        :return: ChainTurtle()
         """
-        ...
 
     def dot(self, radius: Real) -> ChainTurtle:
         """
         Makes the turtle draw a colored dot
         :param radius: radius in pixels
+        :return: ChainTurtle()
         """
-        ...
 
     def color(self, turtle_color: str) -> ChainTurtle:
         """
         Lets the user change the color of the turtle trace and turtle color itself
         :param turtle_color: valid turtle color
+        :return: ChainTurtle()
         """
-        ...
 
     def teleport(self, x: Real, y: Real, *, fill_gap: bool = False) -> ChainTurtle:
         """
         Makes the turtle to go a specific coordinate with no trace
         :param x: x position in pixels
         :param y: y position in pixels
+        :return: ChainTurtle()
         """
-        ...
 
     def shape(self, shape_name: str) -> ChainTurtle:
         """
         Changes the shape of the turtle shape
         :param shape_name: name of the shape
+        :return: ChainTurtle()
         """
-        ...
 
     def undo(self) -> ChainTurtle:
         """
         Undoes the last turtle command.
         :return: ChainTurtle()
         """
-        ...
 
     def clear(self) -> ChainTurtle:
         """
         Deletes the turtles drawings.
         :return: ChainTurtle()
         """
-        ...
 
     def ht(self) -> ChainTurtle:
         """
         Hides the turtle.
         :return: ChainTurtle()
         """
-        ...
 
     @classmethod
     def list_methods(cls) -> dict[str, Callable]:
         """
         Creates a dictionary with all ChainTurtle methods and returns it
         :return: dictionary
-        """
-        ...
+        """

turtleextension-1.0.0/TurtleExtension/Foundations/GlobalVariables.py

@@ -1,14 +0,0 @@
-# UV = UNIVERSAL VARIABLES
-UV = {
-    "delay": None,            # Delay for user_drawing_ft()
-      "t": 0,                   # user_drawing_ft's current turtle
-      "tls": [],                # user_drawing_ft's turtle list
-      "tls_shape": "arrow",     # user_drawing_ft's turtle's current shape
-      "shape_library": [],      # user_drawing_ft's turtle shapes list
-}
-def t_now():
-    return UV["tls"][UV["t"]]
-
-def t_shape():
-    return UV["tls_shape"]
-

turtleextension-1.0.0/TurtleExtension/Foundations/__init__.py

@@ -1,41 +0,0 @@
-from .GlobalVariables import (
-    UV,
-    t_now,
-    t_shape,
-)
-
-from .GlobalFunctions import (
-    get_screen,
-    SU,
-    mainloop,
-    tls_color,
-    reset_tls,
-)
-
-from .CustomTurtleShapes import (
-    UserShape,
-    get_UserShape_dict,
-    CUSTOM_SHAPES,
-)
-
-from .TurtleFunctions import (
-TurtleFct,
-)
-
-__all__ = [
-    "UV",
-    "t_now",
-    "t_shape",
-
-    "get_screen",
-    "SU",
-    "mainloop",
-    "tls_color",
-    "reset_tls",
-
-    "UserShape",
-    "get_UserShape_dict",
-    "CUSTOM_SHAPES",
-
-    "TurtleFct",
-]

turtleextension-1.0.0/TurtleExtension/TurtleHeart/__init__.py

@@ -1,6 +0,0 @@
-from .TurtleSkeleton import ChainTurtle, tl
-
-__all__ = [
-    "ChainTurtle",
-    "tl",
-]

turtleextension-1.0.0/TurtleExtension/__init__.py

@@ -1,58 +0,0 @@
-"""
-This package is part of the GeometricalDomination project ecosystem.
-
-It contains a chainable turtle class called ChainTurtle and a collection of extra provided features along with it:
-
-1. tls_color -> this function make a list of colored turtles and returns it
-2. get_screen -> turtle screen initializer function
-3. SU -> screen update function
-
-And a lot more.
-
-Author: Miah M. Sabiq
-"""
-
-from .Foundations import (
-   UV,
-   t_now,
-   t_shape,
-
-   get_screen,
-   SU,
-   mainloop,
-   tls_color,
-   reset_tls,
-
-   UserShape,
-   get_UserShape_dict,
-   CUSTOM_SHAPES,
-
-   TurtleFct,
-)
-
-from .TurtleHeart import (
-ChainTurtle,
-tl,
-)
-
-__all__ = [
-    "UV",
-    "t_now",
-    "t_shape",
-
-    "get_screen",
-    "SU",
-    "mainloop",
-    "tls_color",
-    "reset_tls",
-
-    "UserShape",
-    "get_UserShape_dict",
-    "CUSTOM_SHAPES",
-
-    "TurtleFct",
-
-
-   "ChainTurtle",
-   "tl",
-]

turtleextension-1.0.0/TurtleExtension.egg-info/SOURCES.txt

@@ -1,21 +0,0 @@
-LICENSE
-README.md
-pyproject.toml
-TurtleExtension/__init__.py
-TurtleExtension.egg-info/PKG-INFO
-TurtleExtension.egg-info/SOURCES.txt
-TurtleExtension.egg-info/dependency_links.txt
-TurtleExtension.egg-info/requires.txt
-TurtleExtension.egg-info/top_level.txt
-TurtleExtension/Foundations/CustomTurtleShapes.py
-TurtleExtension/Foundations/CustomTurtleShapes.pyi
-TurtleExtension/Foundations/GlobalFunctions.py
-TurtleExtension/Foundations/GlobalFunctions.pyi
-TurtleExtension/Foundations/GlobalVariables.py
-TurtleExtension/Foundations/GlobalVariables.pyi
-TurtleExtension/Foundations/TurtleFunctions.py
-TurtleExtension/Foundations/TurtleFunctions.pyi
-TurtleExtension/Foundations/__init__.py
-TurtleExtension/TurtleHeart/TurtleSkeleton.py
-TurtleExtension/TurtleHeart/TurtleSkeleton.pyi
-TurtleExtension/TurtleHeart/__init__.py

turtleextension-1.0.0/TurtleExtension.egg-info/top_level.txt

@@ -1 +0,0 @@
-TurtleExtension