Add get_running_tolerance method (issue #328)

Author: cyberjunky

README.md

@@ -11,7 +11,7 @@
 The Garmin Connect API library comes with two examples:
 
 - **`example.py`** - Simple getting-started example showing authentication, token storage, and basic API calls
-- **`demo.py`** - Comprehensive demo providing access to **126+ API methods** organized into **13 categories** for easy navigation
+- **`demo.py`** - Comprehensive demo providing access to **127+ API methods** organized into **13 categories** for easy navigation
 
 ```bash
 $ ./demo.py
@@ -40,11 +40,11 @@ Make your selection:
 
 ## API Coverage Statistics
 
-- **Total API Methods**: 126+ unique endpoints (snapshot)
+- **Total API Methods**: 127+ unique endpoints (snapshot)
 - **Categories**: 13 organized sections
 - **User & Profile**: 4 methods (basic user info, settings)
 - **Daily Health & Activity**: 9 methods (today's health data)
-- **Advanced Health Metrics**: 11 methods (fitness metrics, HRV, VO2, training readiness)
+- **Advanced Health Metrics**: 12 methods (fitness metrics, HRV, VO2, training readiness, running tolerance)
 - **Historical Data & Trends**: 9 methods (date range queries, weekly aggregates)
 - **Activities & Workouts**: 35 methods (comprehensive activity, workout management, typed workout uploads, scheduling, import)
 - **Body Composition & Weight**: 8 methods (weight tracking, body composition)
@@ -385,7 +385,7 @@ client.schedule_workout(result["workoutId"], "2026-03-20")
 
 ### Additional Resources
 - **Simple Example**: [example.py](https://raw.githubusercontent.com/cyberjunky/python-garminconnect/master/example.py) - Getting started guide
-- **Comprehensive Demo**: [demo.py](https://raw.githubusercontent.com/cyberjunky/python-garminconnect/master/demo.py) - All 126+ API methods
+- **Comprehensive Demo**: [demo.py](https://raw.githubusercontent.com/cyberjunky/python-garminconnect/master/demo.py) - All 127+ API methods
 - **API Documentation**: Comprehensive method documentation in source code
 - **Test Cases**: Real-world usage examples in `tests/` directory
 

demo.py

@@ -202,6 +202,10 @@ def __init__(self):
                 "desc": f"Get intensity minutes for '{config.today.isoformat()}'",
                 "key": "get_intensity_minutes_data",
             },
+            "b": {
+                "desc": f"Get running tolerance from '{config.week_start.isoformat()}' to '{config.today.isoformat()}'",
+                "key": "get_running_tolerance",
+            },
         },
     },
     "4": {
@@ -3640,6 +3644,11 @@ def execute_api_call(api: Garmin, key: str) -> None:
                 api_call_desc=f"api.get_all_day_stress('{config.today.isoformat()}')",
             ),
             # Advanced Health Metrics
+            "get_running_tolerance": lambda: call_and_display(
+                api.get_running_tolerance,
+                config.week_start.isoformat(),
+                config.today.isoformat(),
+            ),
             "get_training_readiness": lambda: call_and_display(
                 api.get_training_readiness,
                 config.today.isoformat(),

garminconnect/__init__.py

@@ -208,6 +208,9 @@ def __init__(
         self.garmin_connect_endurance_score_url = (
             "/metrics-service/metrics/endurancescore"
         )
+        self.garmin_connect_running_tolerance_url = (
+            "/metrics-service/metrics/runningtolerance/stats"
+        )
         self.garmin_connect_menstrual_calendar_url = (
             "/periodichealth-service/menstrualcycle/calendar"
         )
@@ -1584,6 +1587,41 @@ def get_endurance_score(
 
         return self.connectapi(url, params=params)
 
+    def get_running_tolerance(
+        self, startdate: str, enddate: str, aggregation: str = "weekly"
+    ) -> list[dict[str, Any]]:
+        """Return running tolerance data for date range.
+
+        Args:
+            startdate: Start date in 'YYYY-MM-DD' format.
+            enddate: End date in 'YYYY-MM-DD' format.
+            aggregation: 'daily' or 'weekly' (default: 'weekly').
+
+        Returns:
+            List of running tolerance data points.
+
+        """
+        startdate = _validate_date_format(startdate, "startdate")
+        enddate = _validate_date_format(enddate, "enddate")
+        if aggregation not in ("daily", "weekly"):
+            raise ValueError(
+                f"Invalid aggregation '{aggregation}'. Must be 'daily' or 'weekly'."
+            )
+        url = self.garmin_connect_running_tolerance_url
+        params = {
+            "startDate": str(startdate),
+            "endDate": str(enddate),
+            "aggregation": aggregation,
+        }
+        logger.debug(
+            "Requesting running tolerance data (%s) from %s to %s",
+            aggregation,
+            startdate,
+            enddate,
+        )
+
+        return self.connectapi(url, params=params)
+
     def get_race_predictions(
         self,
         startdate: str | None = None,