Release 1.1.0

Author: fern-api[bot]

README.md

@@ -35,7 +35,7 @@ client.integrations.fetch()
 
 ## Async Client
 
-The SDK also exports an `async` client so that you can make non-blocking calls to our API.
+The SDK also exports an `async` client so that you can make non-blocking calls to our API. Note that if you are constructing an Async httpx client class to pass into this client, use `httpx.AsyncClient()` instead of `httpx.Client()` (e.g. for the `httpx_client` parameter of this client).
 
 ```python
 import asyncio

pyproject.toml

@@ -3,7 +3,7 @@ name = "terra-python"
 
 [tool.poetry]
 name = "terra-python"
-version = "1.0.13"
+version = "1.1.0"
 description = ""
 readme = "README.md"
 authors = []

reference.md

@@ -457,7 +457,10 @@ client = Terra(
     dev_id="YOUR_DEV_ID",
     api_key="YOUR_API_KEY",
 )
-client.user.getinfoforuserid()
+client.user.getinfoforuserid(
+    user_id="user_id",
+    reference_id="reference_id",
+)
 
 ```
 </dd>
@@ -534,7 +537,10 @@ client = Terra(
     dev_id="YOUR_DEV_ID",
     api_key="YOUR_API_KEY",
 )
-client.user.getalluserids()
+client.user.getalluserids(
+    page=1,
+    per_page=1,
+)
 
 ```
 </dd>
@@ -686,6 +692,9 @@ client = Terra(
 client.activity.fetch(
     user_id="user_id",
     start_date=1,
+    end_date=1,
+    to_webhook=True,
+    with_samples=True,
 )
 
 ```
@@ -726,7 +735,7 @@ client.activity.fetch(
 <dl>
 <dd>
 
-**to_webhook:** `typing.Optional[bool]` — Boolean flag specifying whether to send the data retrieved to the webhook instead of in the response (default: false)
+**to_webhook:** `typing.Optional[bool]` — Boolean flag specifying whether to send the data retrieved to the webhook instead of in the response (default: true if not provided)
 
 </dd>
 </dl>
@@ -871,6 +880,7 @@ client = Terra(
 )
 client.athlete.fetch(
     user_id="user_id",
+    to_webhook=True,
 )
 
 ```
@@ -895,7 +905,7 @@ client.athlete.fetch(
 <dl>
 <dd>
 
-**to_webhook:** `typing.Optional[bool]` — Boolean flag specifying whether to send the data retrieved to the webhook instead of in the response (default: false)
+**to_webhook:** `typing.Optional[bool]` — Boolean flag specifying whether to send the data retrieved to the webhook instead of in the response (default: true if not provided)
 
 </dd>
 </dl>
@@ -952,6 +962,9 @@ client = Terra(
 client.body.fetch(
     user_id="user_id",
     start_date=1,
+    end_date=1,
+    to_webhook=True,
+    with_samples=True,
 )
 
 ```
@@ -992,7 +1005,7 @@ client.body.fetch(
 <dl>
 <dd>
 
-**to_webhook:** `typing.Optional[bool]` — Boolean flag specifying whether to send the data retrieved to the webhook instead of in the response (default: false)
+**to_webhook:** `typing.Optional[bool]` — Boolean flag specifying whether to send the data retrieved to the webhook instead of in the response (default: true if not provided)
 
 </dd>
 </dl>
@@ -1214,6 +1227,9 @@ client = Terra(
 client.daily.fetch(
     user_id="user_id",
     start_date=1,
+    end_date=1,
+    to_webhook=True,
+    with_samples=True,
 )
 
 ```
@@ -1254,7 +1270,7 @@ client.daily.fetch(
 <dl>
 <dd>
 
-**to_webhook:** `typing.Optional[bool]` — Boolean flag specifying whether to send the data retrieved to the webhook instead of in the response (default: false)
+**to_webhook:** `typing.Optional[bool]` — Boolean flag specifying whether to send the data retrieved to the webhook instead of in the response (default: true if not provided)
 
 </dd>
 </dl>
@@ -1319,6 +1335,9 @@ client = Terra(
 client.menstruation.fetch(
     user_id="user_id",
     start_date=1,
+    end_date=1,
+    to_webhook=True,
+    with_samples=True,
 )
 
 ```
@@ -1359,7 +1378,7 @@ client.menstruation.fetch(
 <dl>
 <dd>
 
-**to_webhook:** `typing.Optional[bool]` — Boolean flag specifying whether to send the data retrieved to the webhook instead of in the response (default: false)
+**to_webhook:** `typing.Optional[bool]` — Boolean flag specifying whether to send the data retrieved to the webhook instead of in the response (default: true if not provided)
 
 </dd>
 </dl>
@@ -1424,6 +1443,9 @@ client = Terra(
 client.nutrition.fetch(
     user_id="user_id",
     start_date=1,
+    end_date=1,
+    to_webhook=True,
+    with_samples=True,
 )
 
 ```
@@ -1464,7 +1486,7 @@ client.nutrition.fetch(
 <dl>
 <dd>
 
-**to_webhook:** `typing.Optional[bool]` — Boolean flag specifying whether to send the data retrieved to the webhook instead of in the response (default: false)
+**to_webhook:** `typing.Optional[bool]` — Boolean flag specifying whether to send the data retrieved to the webhook instead of in the response (default: true if not provided)
 
 </dd>
 </dl>
@@ -1686,6 +1708,9 @@ client = Terra(
 client.sleep.fetch(
     user_id="user_id",
     start_date=1,
+    end_date=1,
+    to_webhook=True,
+    with_samples=True,
 )
 
 ```
@@ -1726,7 +1751,7 @@ client.sleep.fetch(
 <dl>
 <dd>
 
-**to_webhook:** `typing.Optional[bool]` — Boolean flag specifying whether to send the data retrieved to the webhook instead of in the response (default: false)
+**to_webhook:** `typing.Optional[bool]` — Boolean flag specifying whether to send the data retrieved to the webhook instead of in the response (default: true if not provided)
 
 </dd>
 </dl>
@@ -1791,6 +1816,8 @@ client = Terra(
 client.plannedworkout.fetch(
     user_id="user_id",
     start_date=1,
+    end_date=1,
+    to_webhook=True,
 )
 
 ```
@@ -1831,7 +1858,7 @@ client.plannedworkout.fetch(
 <dl>
 <dd>
 
-**to_webhook:** `typing.Optional[bool]` — Boolean flag specifying whether to send the data retrieved to the webhook instead of in the response (default: false)
+**to_webhook:** `typing.Optional[bool]` — Boolean flag specifying whether to send the data retrieved to the webhook instead of in the response (default: true if not provided)
 
 </dd>
 </dl>
@@ -1885,6 +1912,7 @@ client = Terra(
     api_key="YOUR_API_KEY",
 )
 client.plannedworkout.write(
+    user_id="user_id",
     data=[PlannedWorkout()],
 )
 
@@ -1902,6 +1930,14 @@ client.plannedworkout.write(
 <dl>
 <dd>
 
+**user_id:** `str` — Terra user ID (UUID format) to retrieve data for
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
 **data:** `typing.Sequence[PlannedWorkout]` — PlannedWorkout entry to post to data provider
 
 </dd>
@@ -2096,7 +2132,9 @@ client = Terra(
     dev_id="YOUR_DEV_ID",
     api_key="YOUR_API_KEY",
 )
-client.integrations.detailedfetch()
+client.integrations.detailedfetch(
+    sdk=True,
+)
 
 ```
 </dd>

src/terra/__init__.py

@@ -25,17 +25,17 @@
     "AsyncTerra": ".client",
     "Terra": ".client",
     "__version__": ".version",
-    "activity": ".",
-    "athlete": ".",
-    "authentication": ".",
-    "body": ".",
-    "daily": ".",
-    "integrations": ".",
-    "menstruation": ".",
-    "nutrition": ".",
-    "plannedworkout": ".",
-    "sleep": ".",
-    "user": ".",
+    "activity": ".activity",
+    "athlete": ".athlete",
+    "authentication": ".authentication",
+    "body": ".body",
+    "daily": ".daily",
+    "integrations": ".integrations",
+    "menstruation": ".menstruation",
+    "nutrition": ".nutrition",
+    "plannedworkout": ".plannedworkout",
+    "sleep": ".sleep",
+    "user": ".user",
 }
 
 
@@ -45,8 +45,10 @@ def __getattr__(attr_name: str) -> typing.Any:
         raise AttributeError(f"No {attr_name} found in _dynamic_imports for module name -> {__name__}")
     try:
         module = import_module(module_name, __package__)
-        result = getattr(module, attr_name)
-        return result
+        if module_name == f".{attr_name}":
+            return module
+        else:
+            return getattr(module, attr_name)
     except ImportError as e:
         raise ImportError(f"Failed to import {attr_name} from {module_name}: {e}") from e
     except AttributeError as e:

src/terra/activity/client.py

@@ -55,7 +55,7 @@ def fetch(
             End date for data query - either ISO8601 date (YYYY-MM-DD) or unix timestamp in seconds (10-digit)
 
         to_webhook : typing.Optional[bool]
-            Boolean flag specifying whether to send the data retrieved to the webhook instead of in the response (default: false)
+            Boolean flag specifying whether to send the data retrieved to the webhook instead of in the response (default: true if not provided)
 
         with_samples : typing.Optional[bool]
             Boolean flag specifying whether to include detailed samples in the returned payload (default: false)
@@ -79,6 +79,9 @@ def fetch(
         client.activity.fetch(
             user_id="user_id",
             start_date=1,
+            end_date=1,
+            to_webhook=True,
+            with_samples=True,
         )
         """
         _response = self._raw_client.fetch(
@@ -176,7 +179,7 @@ async def fetch(
             End date for data query - either ISO8601 date (YYYY-MM-DD) or unix timestamp in seconds (10-digit)
 
         to_webhook : typing.Optional[bool]
-            Boolean flag specifying whether to send the data retrieved to the webhook instead of in the response (default: false)
+            Boolean flag specifying whether to send the data retrieved to the webhook instead of in the response (default: true if not provided)
 
         with_samples : typing.Optional[bool]
             Boolean flag specifying whether to include detailed samples in the returned payload (default: false)
@@ -205,6 +208,9 @@ async def main() -> None:
             await client.activity.fetch(
                 user_id="user_id",
                 start_date=1,
+                end_date=1,
+                to_webhook=True,
+                with_samples=True,
             )
 
 

src/terra/activity/raw_client.py

@@ -51,7 +51,7 @@ def fetch(
             End date for data query - either ISO8601 date (YYYY-MM-DD) or unix timestamp in seconds (10-digit)
 
         to_webhook : typing.Optional[bool]
-            Boolean flag specifying whether to send the data retrieved to the webhook instead of in the response (default: false)
+            Boolean flag specifying whether to send the data retrieved to the webhook instead of in the response (default: true if not provided)
 
         with_samples : typing.Optional[bool]
             Boolean flag specifying whether to include detailed samples in the returned payload (default: false)
@@ -224,7 +224,7 @@ async def fetch(
             End date for data query - either ISO8601 date (YYYY-MM-DD) or unix timestamp in seconds (10-digit)
 
         to_webhook : typing.Optional[bool]
-            Boolean flag specifying whether to send the data retrieved to the webhook instead of in the response (default: false)
+            Boolean flag specifying whether to send the data retrieved to the webhook instead of in the response (default: true if not provided)
 
         with_samples : typing.Optional[bool]
             Boolean flag specifying whether to include detailed samples in the returned payload (default: false)

src/terra/athlete/client.py

@@ -39,7 +39,7 @@ def fetch(
             Terra user ID (UUID format) to retrieve data for
 
         to_webhook : typing.Optional[bool]
-            Boolean flag specifying whether to send the data retrieved to the webhook instead of in the response (default: false)
+            Boolean flag specifying whether to send the data retrieved to the webhook instead of in the response (default: true if not provided)
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -59,6 +59,7 @@ def fetch(
         )
         client.athlete.fetch(
             user_id="user_id",
+            to_webhook=True,
         )
         """
         _response = self._raw_client.fetch(user_id=user_id, to_webhook=to_webhook, request_options=request_options)
@@ -96,7 +97,7 @@ async def fetch(
             Terra user ID (UUID format) to retrieve data for
 
         to_webhook : typing.Optional[bool]
-            Boolean flag specifying whether to send the data retrieved to the webhook instead of in the response (default: false)
+            Boolean flag specifying whether to send the data retrieved to the webhook instead of in the response (default: true if not provided)
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -121,6 +122,7 @@ async def fetch(
         async def main() -> None:
             await client.athlete.fetch(
                 user_id="user_id",
+                to_webhook=True,
             )
 
 

src/terra/athlete/raw_client.py

@@ -34,7 +34,7 @@ def fetch(
             Terra user ID (UUID format) to retrieve data for
 
         to_webhook : typing.Optional[bool]
-            Boolean flag specifying whether to send the data retrieved to the webhook instead of in the response (default: false)
+            Boolean flag specifying whether to send the data retrieved to the webhook instead of in the response (default: true if not provided)
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -122,7 +122,7 @@ async def fetch(
             Terra user ID (UUID format) to retrieve data for
 
         to_webhook : typing.Optional[bool]
-            Boolean flag specifying whether to send the data retrieved to the webhook instead of in the response (default: false)
+            Boolean flag specifying whether to send the data retrieved to the webhook instead of in the response (default: true if not provided)
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.