whirligig 0.1.0__tar.gz

whirligig-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 GabeBecker2048
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

whirligig-0.1.0/PKG-INFO

@@ -0,0 +1,36 @@
+Metadata-Version: 2.3
+Name: whirligig
+Version: 0.1.0
+Summary: A fun wheel spinner for python and CLI
+Keywords: wheel,spinner,terminal,ascii,random,picker
+Author: GabeBecker2048
+License: MIT License
+         
+         Copyright (c) 2026 GabeBecker2048
+         
+         Permission is hereby granted, free of charge, to any person obtaining a copy
+         of this software and associated documentation files (the "Software"), to deal
+         in the Software without restriction, including without limitation the rights
+         to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+         copies of the Software, and to permit persons to whom the Software is
+         furnished to do so, subject to the following conditions:
+         
+         The above copyright notice and this permission notice shall be included in all
+         copies or substantial portions of the Software.
+         
+         THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+         IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+         FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+         AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+         LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+         OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+         SOFTWARE.
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Environment :: Console
+Classifier: Topic :: Games/Entertainment
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# whirligig
+A fun wheel spinner for python and CLI 

whirligig-0.1.0/README.md

@@ -0,0 +1,2 @@
+# whirligig
+A fun wheel spinner for python and CLI 

whirligig-0.1.0/pyproject.toml

@@ -0,0 +1,22 @@
+[project]
+name = "whirligig"
+version = "0.1.0"
+description = "A fun wheel spinner for python and CLI"
+readme = "README.md"
+license = { file = "LICENSE" }
+authors = [
+    { name = "GabeBecker2048" },
+]
+requires-python = ">=3.9"
+dependencies = []
+keywords = ["wheel", "spinner", "terminal", "ascii", "random", "picker"]
+classifiers = [
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Environment :: Console",
+    "Topic :: Games/Entertainment",
+]
+
+[build-system]
+requires = ["uv_build>=0.8.24,<0.9.0"]
+build-backend = "uv_build"

whirligig-0.1.0/src/whirligig/__init__.py

@@ -0,0 +1,3 @@
+from whirligig.spinner import spin
+
+__all__ = ["spin"]

whirligig-0.1.0/src/whirligig/spinner.py

@@ -0,0 +1,137 @@
+from math import sin, cos, pi
+from copy import deepcopy
+import os
+import random
+import time
+
+WHEEL_RADIUS = 10
+DELAY = 0.1
+
+class Colors:
+    """ ANSI color codes """
+    RESET = "\033[0m"
+    colors = [
+        "\033[0;31m",
+        "\033[0;32m",
+        "\033[0;33m",
+        "\033[0;34m",
+        "\033[0;35m",
+        "\033[0;36m",
+        "\033[0;37m",
+        "\033[1;31m",
+        "\033[1;32m",
+        "\033[1;33m",
+        "\033[1;34m",
+        "\033[1;35m",
+        "\033[1;36m",
+    ]
+
+
+class Wheel:
+    def __init__(self, radius, labels) -> None:
+        self.r = radius
+        self.d = radius*2
+        self.labels = labels
+        self.m = [" " * (self.d+1)] * (self.d+1)
+        self.num_labels = len(labels)
+        self.angles = [pi/(self.num_labels/2) * p for p in range(self.num_labels)]
+        self.points = []
+        for i in range(self.num_labels):
+            p = self.get_coords(i, self.r) 
+            self[p] = "*"
+            self.points.append(p)
+
+    def __setitem__(self, key: tuple[int, int], value: str) -> None:
+        x, y = key
+        lrow = list(self.m[y])
+        lrow[x] = value
+        self.m[y] = "".join(lrow)
+
+    def __getitem__(self, key: tuple[int, int]) -> str:
+        x, y = key
+        return self.m[y][x]
+    
+    def __str__(self) -> str:
+        return "\n".join(self.m)
+
+    def add_labels(self, inplace = False):
+        wheel = self if inplace else deepcopy(self)
+
+        # adds whitespace
+        whitespace = " " * (len(max(wheel.labels, key=len)) + 1)
+        for y in range(len(wheel.m)):
+            wheel.m[y] = wheel.m[y].replace(" ", "   ").replace("*", " * ")
+            wheel.m[y] = whitespace + wheel.m[y] + whitespace
+        
+        # adds labels
+        for label, point in zip(wheel.labels, wheel.points):
+            x, y = point
+            if x<wheel.r or (x==wheel.r and y<wheel.r):
+                for i in range(len(label)):
+                    ix = x-len(label) + i + len(whitespace) + (x * 2)
+                    wheel[ix, y] = label[i]
+            elif x>wheel.r or (x==wheel.r and y>wheel.r):
+                for i in range(len(label)):
+                    ix = x+3 + i + len(whitespace) + (x * 2)
+                    wheel[ix, y] = label[i]
+
+        # adds color
+        for y in range(len(wheel.m)):
+            for i, label in enumerate(wheel.labels):
+                wheel.m[y] = wheel.m[y].replace(f" {label} *", f" {Colors.colors[i%len(Colors.colors)]}{label} *{Colors.RESET}")
+                wheel.m[y] = wheel.m[y].replace(f"* {label} ", f"{Colors.colors[i%len(Colors.colors)]}* {label}{Colors.RESET} ")
+
+        return wheel
+
+    # given an angle and a scaler, returns a tuple of coords to the point
+    def get_coords(self, idx: int, scaler: int) -> tuple[int, int]:
+        a = self.angles[idx]
+        return round(cos(a)*scaler) + self.r, round(sin(a)*scaler) + self.r
+    
+    # given an angle and the circle array, we return a deepcopy with a line drawn from the center
+    def draw_line(self, idx: int):
+        c = deepcopy(self)
+        for line_scaler in range(1, c.r):
+            p = c.get_coords(idx, line_scaler)
+            c[p] = "*"
+        return c
+
+
+# clears the screen
+def clear() -> None:
+    if os.name == 'nt':
+        os.system('cls')
+    else:
+        os.system('clear')
+
+# clears the screen, prints the circle, waits DELAY
+def display(wheel: Wheel, i=-1) -> None:
+    wheel = wheel.draw_line(i)
+    wheel = wheel.add_labels()
+    clear()
+    print(wheel)
+    if i != -1:
+        print(f"You got {Colors.colors[i%len(Colors.colors)]}{wheel.labels[i]}{Colors.RESET}!")
+    time.sleep(DELAY)
+
+## THE MAIN FUNCTION ##
+# given a list, this function will create and print a spinning wheel ASCII animation
+def spin(labels: list[str], w_radius=WHEEL_RADIUS):
+    wheel = Wheel(w_radius, labels)
+
+    # full rotations
+    for j in range(random.randint(2, 5)):
+        for i in range(wheel.num_labels):
+            display(wheel, i=i)
+
+    # actual choice
+    for i in range(random.randint(1, wheel.num_labels)):
+        display(wheel, i=i)
+
+
+if __name__ == "__main__":
+    dice_roll = [str(i+1) for i in range(6)]
+    clock = [str((i+2)%12 + 1) for i in range(12)]
+    alphabet = list(map(chr, range(ord('a'), ord('z')+1)))
+    coin_flip = ["heads", "tails"]
+    spin(random.choice([dice_roll, clock, alphabet, coin_flip]))