sweatstack 0.44.0__tar.gz → 0.45.0__tar.gz

{sweatstack-0.44.0 → sweatstack-0.45.0}/CHANGELOG.md

@@ -5,6 +5,14 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+
+## [0.45.0] - 2025-06-24
+
+### Added
+
+- Added a new `ss.whoami()` method that returns the authenticated user's summary information. This method is recommended over `ss.get_userinfo()` which only exists for OpenID compatibility and requires the `profile` scope.
+- Added a new `ss.Metric.display_name()` method that returns a human-readable display name for a metric. For example, `ss.Metric.heart_rate.display_name()` returns "heart rate".
+
 ## [0.44.0] - 2025-06-18
 
 ### Added

{sweatstack-0.44.0 → sweatstack-0.45.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sweatstack
-Version: 0.44.0
+Version: 0.45.0
 Summary: The official Python client for SweatStack
 Author-email: Aart Goossens <aart@gssns.io>
 Requires-Python: >=3.9

{sweatstack-0.44.0 → sweatstack-0.45.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "sweatstack"
-version = "0.44.0"
+version = "0.45.0"
 description = "The official Python client for SweatStack"
 readme = "README.md"
 authors = [

{sweatstack-0.44.0 → sweatstack-0.45.0}/src/sweatstack/client.py

@@ -1204,6 +1204,32 @@ class Client(OAuth2Mixin, DelegationMixin, TokenStorageMixin):
             self._raise_for_status(response)
             return UserInfoResponse.model_validate(response.json())
 
+    def whoami(self) -> UserSummary:
+        """Gets the authenticated user's summary information.
+
+        This method retrieves basic information about the currently authenticated user
+        by extracting the user ID from the JWT token and fetching the user details.
+
+        Returns:
+            UserSummary: A UserSummary object containing the authenticated user's information.
+
+        Raises:
+            ValueError: If no authentication token is available.
+            HTTPStatusError: If the API request fails or user is not found.
+        """
+        if not self.api_key:
+            raise ValueError("Not authenticated. Please call authenticate() or login() first.")
+
+        try:
+            jwt_body = decode_jwt_body(self.api_key)
+            user_id = jwt_body.get("sub")
+            if not user_id:
+                raise ValueError("Unable to extract user ID from token")
+        except Exception as e:
+            raise ValueError(f"Invalid authentication token: {e}")
+
+        return self._get_user_by_id(user_id)
+
 
 _default_client = Client()
 
@@ -1248,6 +1274,7 @@ _generate_singleton_methods(
         "get_user",
         "get_users",
         "get_userinfo",
+        "whoami",
 
         "get_activities",
 

{sweatstack-0.44.0 → sweatstack-0.45.0}/src/sweatstack/schemas.py

@@ -101,4 +101,15 @@ def display_name(sport: Sport) -> str:
 Sport.root_sport = root_sport
 Sport.parent_sport = parent_sport
 Sport.is_sub_sport_of = is_sub_sport_of
-Sport.display_name = display_name
+Sport.display_name = display_name
+
+
+def metric_display_name(metric: Metric) -> str:
+    """Returns a human-readable display name for a metric.
+
+    This function converts a Metric enum value into a formatted string suitable for display.
+    """
+    return metric.value.replace("_", " ")
+
+
+Metric.display_name = metric_display_name