From 59f9677b3b76be55849a02f8468d1859c63ef171 Mon Sep 17 00:00:00 2001
From: jerick <jerick00201@gmail.com>
Date: Sat, 9 Aug 2025 15:57:55 -0400
Subject: [PATCH] first commit, working through CLI

---
 README.md       |   0
 random_timer.py | 134 ++++++++++++++++++++++++++++++++++++++++++++++++
 words.txt       |   5 ++
 3 files changed, 139 insertions(+)
 create mode 100644 README.md
 create mode 100755 random_timer.py
 create mode 100644 words.txt

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..e69de29
diff --git a/random_timer.py b/random_timer.py
new file mode 100755
index 0000000..73c2243
--- /dev/null
+++ b/random_timer.py
@@ -0,0 +1,134 @@
+#!/usr/bin/env python3
+"""
+Catchphrase
+Author: Jerick Oates
+"""
+
+import random
+import time
+import threading
+import sys
+
+# ---------- CONFIG ----------
+WORDS_FILE   = "words.txt"   # file with one word per line
+TIMER_SECONDS = 30           # how long the timer runs
+
+
+# ---------- HELPERS ----------
+def load_words(path=WORDS_FILE):
+    """Return a list of non‑empty stripped lines from the given file."""
+    try:
+        with open(path, "r", encoding="utf-8") as f:
+            words = [line.strip() for line in f if line.strip()]
+        if not words:
+            raise ValueError("Word file is empty.")
+        return words
+    except Exception as e:
+        print(f"❌ Error loading words: {e}")
+        sys.exit(1)
+
+
+def pick_random(words):
+    """Return a random word from the list."""
+    return random.choice(words)
+
+
+# ---------- TIMER THREAD ----------
+class CountdownTimer(threading.Thread):
+    """
+    Background thread that counts down for TIMER_SECONDS.
+    When it finishes, it calls an optional callback.
+    """
+    def __init__(self, seconds=TIMER_SECONDS, on_finish=None):
+        super().__init__()
+        self.seconds = seconds
+        self.on_finish = on_finish  # function to call when timer ends
+        self._running = threading.Event()
+        self._running.set()
+
+    def run(self):
+        for _ in range(self.seconds):
+            if not self._running.is_set():
+                break          # stopped early by user
+            time.sleep(1)
+        # Timer finished (or was stopped)
+        self._running.clear()
+        if self.on_finish:
+            self.on_finish()   # announce completion
+
+    def stop(self):
+        """Stop the timer before it reaches zero."""
+        self._running.clear()
+
+    @property
+    def is_running(self):
+        return self._running.is_set()
+
+
+# ---------- MAIN LOOP ----------
+def main():
+    words = load_words()
+    timer_thread = None
+
+    print("=== Catchphrase ===")
+    print("Commands:")
+    print("  start – begin the 30‑second timer and show a word immediately")
+    print("  next  – show another random word while the timer is running")
+    print("  stop  – cancel the timer early")
+    print("  exit / quit – leave the program")
+
+    # Helper that prints when the timer ends
+    def announce_finish():
+        print("\n⏰ Time’s up! Returning to menu.")
+        print("=== Catchphrase ===")
+        print("Commands:")
+        print("  start – begin the 30‑second timer and show a word immediately")
+        print("  next  – show another random word while the timer is running")
+        print("  stop  – cancel the timer early")
+        print("  exit / quit – leave the program")
+
+    while True:
+        try:
+            cmd = input("\n> ").strip().lower()
+        except EOFError:          # Ctrl‑D
+            break
+
+        if cmd in ("exit", "quit"):
+            if timer_thread and timer_thread.is_running:
+                timer_thread.stop()
+                timer_thread.join()
+            print("👋 Goodbye!")
+            break
+
+        elif cmd == "start":
+            if timer_thread and timer_thread.is_running:
+                print("[!] Timer is already running.")
+            else:
+                # Start a new timer with the finish callback
+                timer_thread = CountdownTimer(on_finish=announce_finish)
+                timer_thread.daemon = True   # exit when main thread exits
+                timer_thread.start()
+
+                # Show the first word right away
+                print(pick_random(words))
+                print(f"[+] 30‑second timer started. ({TIMER_SECONDS}s)")
+
+        elif cmd == "next":
+            if not (timer_thread and timer_thread.is_running):
+                print("[!] No active timer – use 'start' first.")
+            else:
+                print(pick_random(words))
+
+        elif cmd == "stop":
+            if timer_thread and timer_thread.is_running:
+                timer_thread.stop()
+                timer_thread.join()
+                print("[+] Timer stopped early.")
+            else:
+                print("[!] There is no running timer to stop.")
+
+        else:
+            print(f"[!] Unknown command: {cmd}")
+
+if __name__ == "__main__":
+    main()
diff --git a/words.txt b/words.txt
new file mode 100644
index 0000000..50aa695
--- /dev/null
+++ b/words.txt
@@ -0,0 +1,5 @@
+test
+bracelet
+microphone
+shoes
+moonwalk