docs(tracker): add examples to docstrings

Author: ddkasa

toggl_api/tracker.py

@@ -16,7 +16,12 @@
 
 @dataclass
 class TrackerBody(BaseBody):
-    """JSON body dataclass for PUT, POST & PATCH requests."""
+    """JSON body dataclass for PUT, POST & PATCH requests.
+
+    Examples:
+        >>> TrackerBody(description="What a wonderful tracker description!", project_id=2123132)
+        TrackerBody(description='What a wonderful tracker description!', project_id=2123132)
+    """
 
     description: Optional[str] = field(default=None)
     duration: Optional[int | timedelta] = field(default=None)
@@ -89,6 +94,16 @@ class TrackerEndpoint(TogglCachedEndpoint):
     See the [UserEndpoint][toggl_api.UserEndpoint] for _GET_ specific requests.
 
     [Official Documentation](https://engineering.toggl.com/docs/api/time_entries)
+
+    Examples:
+        >>> tracker_endpoint = TrackerEndpoint(324525, BasicAuth(...), JSONCache(Path("cache")))
+
+        >>> body = TrackerBody(description="What a wonderful tracker description!", project_id=2123132)
+        >>> tracker = tracker_endpoint.add(body)
+        TogglTracker(id=58687689, name="What a wonderful tracker description!", project=2123132, ...)
+
+        >>> tracker_endpoint.delete(tracker)
+        None
     """
 
     TRACKER_ALREADY_STOPPED: Final[int] = 409
@@ -100,6 +115,11 @@ def edit(self, tracker: TogglTracker | int, body: TrackerBody) -> TogglTracker |
 
         [Official Documentation](https://engineering.toggl.com/docs/api/time_entries#put-timeentries)
 
+        Examples:
+            >>> body = TrackerBody(description="What a wonderful tracker description!", project_id=2123132)
+            >>> tracker_endpoint.edit(58687684, body)
+            TogglTracker(id=58687684, name="What a wonderful tracker description!", project=2123132, ...)
+
         Args:
             tracker: Target tracker model or id to edit.
             body: Updated content to add.
@@ -132,6 +152,10 @@ def delete(self, tracker: TogglTracker | int) -> None:
 
         [Official Documentation](https://engineering.toggl.com/docs/api/time_entries#delete-timeentries)
 
+        Examples:
+            >>> tracker_endpoint.delete(58687684)
+            None
+
         Args:
             tracker: Tracker object with ID to delete.
 
@@ -165,8 +189,15 @@ def stop(self, tracker: TogglTracker | int) -> TogglTracker | None:
 
         [Official Documentation](https://engineering.toggl.com/docs/api/time_entries#patch-stop-timeentry)
 
+        Examples:
+            >>> tracker_endpoint.stop(58687684)
+            TogglTracker(id=58687684, name="What a wonderful tracker description!", ...)
+
         Args:
-            tracker: Tracker object with IP to stop.
+            tracker: Tracker id to stop. An integer or model.
+
+        Raises:
+            HTTPStatusError: For anything thats not 'ok' or a '409' status code.
 
         Returns:
             TogglTracker | None: If the tracker was stopped or if the tracker
@@ -193,6 +224,11 @@ def add(self, body: TrackerBody) -> TogglTracker | None:
 
         [Official Documentation](https://engineering.toggl.com/docs/api/time_entries#post-timeentries)
 
+        Examples:
+            >>> body = TrackerBody(description="Tracker description!", project_id=2123132)
+            >>> tracker_endpoint.edit(body)
+            TogglTracker(id=78895400, name="Tracker description!", project=2123132, ...)
+
         Args:
             body: Body of the request. Description must be set. If start date
                 is not set it will be set to current time with duration set