Merge pull request #327 from Skydler/feature/workout-scheduling

Add workout scheduling

Author: cyberjunky

demo.py

@@ -324,6 +324,10 @@ def __init__(self):
                 "desc": "Count activities for current user",
                 "key": "count_activities",
             },
+            "s": {
+                "desc": "Schedule a workout on a date (interactive)",
+                "key": "scheduled_workout",
+            },
             "v": {
                 "desc": "Upload typed running workout (sample)",
                 "key": "upload_running_workout",
@@ -2063,7 +2067,9 @@ def clean_step_ids(workout_segments):
 
     except FileNotFoundError:
         print(f"❌ File not found: {config.workoutfile}")
-        print("ℹ️ Please ensure the workout JSON file exists in the test_data directory")
+        print(
+            "ℹ️ Please ensure the workout JSON file exists in the test_data directory"
+        )
     except json.JSONDecodeError as e:
         print(f"❌ Invalid JSON format in {config.workoutfile}: {e}")
         print("ℹ️ Please check the JSON file format")
@@ -2268,6 +2274,60 @@ def upload_hiking_workout_data(api: Garmin) -> None:
         print(f"❌ Error uploading hiking workout: {e}")
 
 
+def schedule_workout_data(api: Garmin) -> None:
+    """Schedule a workout on a specific date."""
+    try:
+        workouts = api.get_workouts()
+        if not workouts:
+            print("ℹ️ No workouts found")
+            return
+
+        print("\nAvailable workouts (most recent):")
+        for i, workout in enumerate(workouts[:10]):
+            workout_id = workout.get("workoutId")
+            workout_name = workout.get("workoutName", "Unknown")
+            print(f"  [{i}] {workout_name} (ID: {workout_id})")
+
+        try:
+            index_input = input(
+                f"\nEnter workout index (0-{min(9, len(workouts) - 1)}, or 'q' to cancel): "
+            ).strip()
+
+            if index_input.lower() == "q":
+                print("❌ Cancelled")
+                return
+
+            workout_index = int(index_input)
+            if not (0 <= workout_index < min(10, len(workouts))):
+                print("❌ Invalid index")
+                return
+
+            selected_workout = workouts[workout_index]
+            workout_id = selected_workout["workoutId"]
+            workout_name = selected_workout.get("workoutName", "Unknown")
+
+            date_input = input(
+                f"Enter date to schedule '{workout_name}' (YYYY-MM-DD, default: today): "
+            ).strip()
+            schedule_date = date_input if date_input else config.today.isoformat()
+
+            call_and_display(
+                api.schedule_workout,
+                workout_id,
+                schedule_date,
+                method_name="scheduled_workout",
+                api_call_desc=f"api.scheduled_workout({workout_id}, '{schedule_date}') - {workout_name}",
+            )
+
+            print("✅ Workout scheduled successfully!")
+
+        except ValueError:
+            print("❌ Invalid input")
+
+    except Exception as e:
+        print(f"❌ Error scheduling workout: {e}")
+
+
 def get_scheduled_workout_by_id_data(api: Garmin) -> None:
     """Get scheduled workout by ID."""
     try:
@@ -3605,8 +3665,8 @@ def execute_api_call(api: Garmin, key: str) -> None:
             ),
             "get_activity_weather": lambda: get_activity_weather_data(api),
             "get_activity_hr_in_timezones": lambda: get_activity_hr_timezones_data(api),
-            "get_activity_power_in_timezones": lambda: get_activity_power_timezones_data(
-                api
+            "get_activity_power_in_timezones": lambda: (
+                get_activity_power_timezones_data(api)
             ),
             "get_cycling_ftp": lambda: get_cycling_ftp_data(api),
             "get_activity_details": lambda: get_activity_details_data(api),
@@ -3624,6 +3684,7 @@ def execute_api_call(api: Garmin, key: str) -> None:
             "get_scheduled_workout_by_id": lambda: get_scheduled_workout_by_id_data(
                 api
             ),
+            "scheduled_workout": lambda: schedule_workout_data(api),
             "count_activities": lambda: call_and_display(
                 api.count_activities,
                 method_name="count_activities",

garminconnect/__init__.py

@@ -2316,7 +2316,7 @@ def request_reload(self, cdate: str) -> dict[str, Any]:
 
         return self.garth.post("connectapi", url, api=True).json()
 
-    def get_workouts(self, start: int = 0, limit: int = 100) -> dict[str, Any]:
+    def get_workouts(self, start: int = 0, limit: int = 100) -> list[dict[str, Any]]:
         """Return workouts starting at offset `start` with at most `limit` results."""
         url = f"{self.garmin_workouts}/workouts"
         start = _validate_non_negative_integer(start, "start")
@@ -2512,6 +2512,21 @@ def get_scheduled_workout_by_id(
         logger.debug("Requesting scheduled workout by id %d", scheduled_workout_id)
         return self.connectapi(url)
 
+    def schedule_workout(self, workout_id: int | str, date_str: str) -> dict[str, Any]:
+        """Schedule a workout on a specific date in the Garmin calendar.
+
+        Args:
+            workout_id: The workout ID returned after uploading.
+            date_str: Target date in YYYY-MM-DD format.
+
+        """
+        workout_id = _validate_positive_integer(int(workout_id), "workout_id")
+        date_str = _validate_date_format(date_str, "date_str")
+        url = f"{self.garmin_workouts_schedule_url}/{workout_id}"
+        logger.debug("Scheduling workout %s for %s", workout_id, date_str)
+        payload = {"date": date_str}
+        return self.garth.post("connectapi", url, json=payload, api=True).json()
+
     def get_menstrual_data_for_date(self, fordate: str) -> dict[str, Any]:
         """Return menstrual data for date."""
         fordate = _validate_date_format(fordate, "fordate")