turtleshell 1.0.0__py3-none-any.whl

turtleshell/__init__.py

@@ -0,0 +1,3 @@
+from .core import Screen, Turtle
+
+__version__ = "1.0.0"

turtleshell/core.py

@@ -0,0 +1,168 @@
+"""Convenience wrappers around turtle.Turtle and turtle.Screen
+  See https://github.com/python/cpython/blob/main/Lib/turtle.py
+  """
+#TODO handle floats, randcoords, default screensize, default shape
+
+import colorsys
+from dataclasses import dataclass
+import turtle
+
+@dataclass
+class HSV:
+  hue: float
+  sat: float
+  val: float
+  def __iter__(self):
+    return iter(self.__dict__.values())
+
+def Screen():
+    """Return the singleton screen object."""
+    if Turtle._screen is None:
+        Turtle._screen = _Screen()
+    return Turtle._screen
+
+class _Screen(turtle._Screen):
+  def __init__(self):
+    super().__init__()
+    turtle.TurtleScreen.__init__(self, _Screen._canvas)
+    if turtle.Turtle._screen is None:
+      turtle.Turtle._screen = self
+    self.colormode(255)
+  
+  def _colorstr(self, color):
+    isnumber = lambda x: isinstance(x, (int, float))
+    if len(color) == 3 and all([isnumber(c) for c in color]):
+      lower, upper = 0, Turtle._screen.colormode()
+      color = [max(min(upper, round(c)), lower) for c in color]
+    return super()._colorstr(color)
+
+def _hsv_to_rgb(hsv):
+  rgb = colorsys.hsv_to_rgb(*hsv)
+  return [round(c*Turtle._screen.colormode()) for c in rgb]
+
+class Turtle(turtle.RawTurtle):
+
+  _pen = None
+  _screen = None
+
+  def __init__(self,
+              shape=turtle._CFG["shape"],
+              undobuffersize=turtle._CFG["undobuffersize"],
+              visible=turtle._CFG["visible"]):
+    if Turtle._screen is None:
+      Turtle._screen = Screen()
+    turtle.RawTurtle.__init__(self, Turtle._screen,
+                        shape=shape,
+                        undobuffersize=undobuffersize,
+                        visible=visible)
+    self.shapesize(20)
+    self._pen_hsv = HSV(0, 1, 1)
+    self._fill_hsv = HSV(0, 1, 1)
+
+  @property
+  def x(self):
+    return self.xcor()
+
+  @x.setter
+  def x(self, value):
+    self.setx(value)
+
+  @property
+  def y(self):
+    return self.ycor()
+
+  @y.setter
+  def y(self, value):
+    self.sety(value)
+
+  @property
+  def shapewidth(self):
+    xcoords = [vertex[0] for vertex in self.get_shapepoly()]
+    return max(xcoords) - min(xcoords)
+
+  @property
+  def shapeheight(self):
+    ycoords = [vertex[1] for vertex in self.get_shapepoly()]
+    return max(ycoords) - min(ycoords)
+
+  def hue(self, degrees):
+    self.penhue(degrees)
+    self.fillhue(degrees)
+
+  def penhue(self, degrees):
+    self._pen_hsv.hue = degrees/360
+    self.pencolor(_hsv_to_rgb(self._pen_hsv))
+
+  def fillhue(self, degrees):
+    self._fill_hsv.hue = degrees/360
+    self.fillcolor(_hsv_to_rgb(self._fill_hsv))
+
+  def sat(self, value):
+    self.pensat(value)
+    self.fillsat(value)
+
+  def pensat(self, value):
+    self._pen_hsv.sat = value/100
+    self.pencolor(_hsv_to_rgb(self._pen_hsv))
+
+  def fillsat(self, value):
+    self._fill_hsv.sat = value/100
+    self.fillcolor(_hsv_to_rgb(self._fill_hsv))
+
+  def val(self, value):
+    self.penval(value)
+    self.fillval(value)
+
+  def penval(self, value):
+    self._pen_hsv.val = value/100
+    self.pencolor(_hsv_to_rgb(self._pen_hsv))
+
+  def fillval(self, value):
+    self._fill_hsv.val = value/100
+    self.fillcolor(_hsv_to_rgb(self._fill_hsv))
+
+  def shapesize(self, stretch_wid=None, stretch_len=None, outline=None):
+    stretch_wid = stretch_wid/20 if stretch_wid else None
+    stretch_len = stretch_len/20 if stretch_len else None
+    super().shapesize(stretch_wid, stretch_len, outline)
+
+  def teleport(self, x, y):
+    pendown = self.isdown()
+    if pendown:
+      self.pen(pendown=False)
+    self.penup()
+    self._position = turtle.Vec2D(x, y)
+    self.pen(pendown=pendown)
+
+  def write(self, arg, move=False, align="center", font=("Arial", 18, "bold")):
+    super().write(arg, move, align, font)
+
+Pen = Turtle
+
+if __name__ == "__main__":
+  canvas = Screen()
+  canvas.bgcolor("gold")
+  pen = Turtle()
+  print(f"\n\n***\nTURTLE TYPE: {type(pen)}\nSCREEN TYPE: {type(canvas)}\n***\n")
+
+  pen.shape("square")
+  print(f"{pen.shapewidth}, {pen.shapeheight}")
+  pen.shapesize(30, 25)
+  print(f"{pen.shapewidth}, {pen.shapeheight}")
+
+  pen.hue(0)
+  pen.stamp()
+  pen.forward(50)
+  pen.hue(60)
+  pen.stamp()
+  pen.forward(50)
+  pen.hue(120)
+  pen.stamp()
+  pen.forward(50)
+  pen.hue(180)
+  pen.stamp()
+  pen.forward(50)
+  pen.hue(240)
+  pen.stamp()
+
+  canvas.exitonclick()

turtleshell-1.0.0.dist-info/METADATA

@@ -0,0 +1,18 @@
+Metadata-Version: 2.4
+Name: turtleshell
+Version: 1.0.0
+Summary: Convenience wrapper around turtle.Turtle and turtle.Screen
+Author-email: Sam Mangan <sam.mangan2@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/SamMangan/turtleshell
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Provides-Extra: dev
+Requires-Dist: bumpver; extra == "dev"
+Requires-Dist: pytest; extra == "dev"
+
+# TurtleShell
+
+Convenience wrapper around Python turtle standard library.

turtleshell-1.0.0.dist-info/RECORD

@@ -0,0 +1,6 @@
+turtleshell/__init__.py,sha256=h6t_4SE0atKJUhhgKKa_b-sPBTxZss4hnR-EnqRIixU,55
+turtleshell/core.py,sha256=6MXthwzvQmFWqnGJKijjn1olIzG_jS8WyGcMoXH1i1A,4437
+turtleshell-1.0.0.dist-info/METADATA,sha256=OOy35r3xo3pqEC-JNtB1z_wEmKaePxOf4fHjWxABPBA,590
+turtleshell-1.0.0.dist-info/WHEEL,sha256=0CuiUZ_p9E4cD6NyLD6UG80LBXYyiSYZOKDm5lp32xk,91
+turtleshell-1.0.0.dist-info/top_level.txt,sha256=nIp6ZtgikYbeYxpXq6zs04zeIaXIMs3ZzAx5QREfkYM,12
+turtleshell-1.0.0.dist-info/RECORD,,

turtleshell-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.3.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

turtleshell-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+turtleshell