Update gosper_curve.py

Author: badtommy67

fractals/gosper_curve.py

@@ -1,74 +1,89 @@
 """
-A Python implementation of the Gosper curve using the turtle module.
-Reference: https://en.wikipedia.org/wiki/Gosper_curve
+Description
+The Gosper curve (also known as the flowsnake) is a fractal curve discovered
+by Bill Gosper. It is generated recursively by replacing each line segment
+with a specific pattern of smaller segments rotated by multiples of
+60 degrees.
+
+```
+With each iteration, the curve becomes more complex and gradually fills
+a hexagonal region.
+
+(description adapted from https://en.wikipedia.org/wiki/Gosper_curve)
+```
+
+Requirements (pip):
+- turtle (standard library)
 """
 
 import math
 import turtle
 
-
 def draw_gosper_curve(
-    side_length: float, depth: int, direction: int = -1, angle: float = 60.0
+side_length: float, depth: int, direction: int = -1, angle: float = 60.0
 ) -> None:
-    """
-    Recursively draws a Gosper curve fractal using turtle graphics.
+"""
+Recursively draw a Gosper curve using turtle graphics.
 
-    Args:
-        side_length: The length of the current segment.
-        depth: The recursive depth of the curve.
-        direction: The direction of the drawing (1 or -1).
-        angle: The angle of the turns in degrees.
+```
+Args:
+    side_length: Length of the current segment.
+    depth: Recursive depth of the fractal.
+    direction: Direction of the curve (1 or -1).
+    angle: Turn angle in degrees.
 
-    Example:
-    >>> import turtle
-    >>> draw_gosper_curve(200.0, 4, -1, 60.0)  # doctest: +SKIP
-    """
-    if depth == 0:
-        turtle.forward(side_length)
-    else:
-        side_length /= math.sqrt(7)
-        depth -= 1
-        if direction == -1:
-            draw_gosper_curve(side_length, depth, -1, angle)
-            turtle.left(angle)
-            draw_gosper_curve(side_length, depth, 1, angle)
-            turtle.left(2 * angle)
-            draw_gosper_curve(side_length, depth, 1, angle)
-            turtle.right(angle)
-            draw_gosper_curve(side_length, depth, -1, angle)
-            turtle.right(2 * angle)
-            draw_gosper_curve(side_length, depth, -1, angle)
-            draw_gosper_curve(side_length, depth, -1, angle)
-            turtle.right(angle)
-            draw_gosper_curve(side_length, depth, 1, angle)
-            turtle.left(angle)
-        else:
-            turtle.right(angle)
-            draw_gosper_curve(side_length, depth, -1, angle)
-            turtle.left(angle)
-            draw_gosper_curve(side_length, depth, 1, angle)
-            draw_gosper_curve(side_length, depth, 1, angle)
-            turtle.left(2 * angle)
-            draw_gosper_curve(side_length, depth, 1, angle)
-            turtle.left(angle)
-            draw_gosper_curve(side_length, depth, -1, angle)
-            turtle.right(2 * angle)
-            draw_gosper_curve(side_length, depth, -1, angle)
-            turtle.right(angle)
-            draw_gosper_curve(side_length, depth, 1, angle)
+>>> import turtle
+>>> draw_gosper_curve(100.0, 1)
+"""
+if depth == 0:
+    turtle.forward(side_length)
+    return
+
+side_length /= math.sqrt(7)
+depth -= 1
+
+if direction == -1:
+    draw_gosper_curve(side_length, depth, -1, angle)
+    turtle.left(angle)
+    draw_gosper_curve(side_length, depth, 1, angle)
+    turtle.left(2 * angle)
+    draw_gosper_curve(side_length, depth, 1, angle)
+    turtle.right(angle)
+    draw_gosper_curve(side_length, depth, -1, angle)
+    turtle.right(2 * angle)
+    draw_gosper_curve(side_length, depth, -1, angle)
+    draw_gosper_curve(side_length, depth, -1, angle)
+    turtle.right(angle)
+    draw_gosper_curve(side_length, depth, 1, angle)
+    turtle.left(angle)
+else:
+    turtle.right(angle)
+    draw_gosper_curve(side_length, depth, -1, angle)
+    turtle.left(angle)
+    draw_gosper_curve(side_length, depth, 1, angle)
+    draw_gosper_curve(side_length, depth, 1, angle)
+    turtle.left(2 * angle)
+    draw_gosper_curve(side_length, depth, 1, angle)
+    turtle.left(angle)
+    draw_gosper_curve(side_length, depth, -1, angle)
+    turtle.right(2 * angle)
+    draw_gosper_curve(side_length, depth, -1, angle)
+    turtle.right(angle)
+    draw_gosper_curve(side_length, depth, 1, angle)
+```
 
+if **name** == "**main**":
+turtle.title("Gosper Curve")
+turtle.speed(0)
 
-if __name__ == "__main__":
-    # Screen setup
-    turtle.title("Gosper Curve")
-    turtle.penup()
-    turtle.goto(0, -200)
-    turtle.pendown()
-    turtle.speed(0)
-    turtle.width(1)
+```
+turtle.penup()
+turtle.goto(0, -200)
+turtle.pendown()
 
-    # Drawing the curve
-    draw_gosper_curve(side_length=200.0, depth=4, direction=-1, angle=60.0)
+draw_gosper_curve(200.0, 4)
 
-    # Close window on click
-    turtle.exitonclick()
+turtle.exitonclick()
+```
+
+"""