PR #21: Pomodoro-Timer

Pomodoro timer
Merge pull request #21 from adedayoprcs/pomodoro-timer

Author: iamwatchdogs

Pomodoro-Timer/README.md

@@ -0,0 +1,17 @@
+Pomodoro Timer
+This Python script provides a simple Pomodoro timer to help you manage your work or study sessions effectively. The Pomodoro Technique is a time management method that encourages focused work periods followed by short breaks. This script allows you to specify a task and the duration of your work session in hours, minutes, and seconds.
+
+How to Use
+Run the script in a Python environment.
+
+You will be prompted to enter the task you want to work on.
+
+Next, enter the duration of your work session in hours, minutes, and seconds.
+
+The timer will start, and you'll see the time remaining for your work session.
+
+During the work session, you'll receive a short break (5 minutes) after every 25 minutes of work. After four work sessions, you'll get a longer break (20 minutes).
+
+Once the timer runs out, you'll be prompted to enter a new task and duration to continue working.
+
+To exit the script, simply close the terminal or interrupt it using Ctrl+C.

Pomodoro-Timer/pomodoro.py

@@ -0,0 +1,43 @@
+import time
+import datetime
+
+# Create a function that acts as a countdown
+def pomodoro_timer(task, h, m, s):
+    # Calculate the total number of seconds
+    total_seconds = h * 3600 + m * 60 + s
+
+    # Counter to keep track of the breaks
+    break_count = 0
+
+    while total_seconds > 0:
+        # Timer represents time left on the countdown
+        timer = datetime.timedelta(seconds=total_seconds)
+        # Prints the time left on the timer
+        print(f"Focusing on {task}... Session time left: {timer}", end="\r")
+
+        # Delays the program one second
+        time.sleep(1)
+
+        # Reduces total time by one second
+        total_seconds -= 1
+
+        # Check if it's time for a break (only for the first 4 breaks)
+        if total_seconds > 0 and break_count < 4 and total_seconds % 1500 == 0:
+            print("\nNow on a short break!")
+            time.sleep(300)  # Short break for 5 minutes
+            break_count += 1
+
+        # Check if it's time for a long break (after 4 sessions)
+        elif total_seconds > 0 and break_count == 4 and total_seconds % 1500 == 0:
+            print("\nNow on a long break!")
+            time.sleep(1200)  # Long break for 20 minutes
+            break_count = 0  # Reset the break count for the next cycle
+
+    print("\nTask Completed")
+
+# Inputs for hours, minutes, and seconds on the timer
+task = input("Enter the task to focus on: ")
+h = int(input("Enter the time in hours: "))
+m = int(input("Enter the time in minutes: "))
+s = int(input("Enter the time in seconds: "))
+pomodoro_timer(task, h, m, s)