Update Notecard API from upstream schema changes (9ab58a6624353a7974805f64a14b8672f3f727c5) (#164)

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>

Author: github-actions[bot]

notecard/card.py

@@ -707,7 +707,7 @@ def temp(card, minutes=None, status=None, stop=None, sync=None):
 
 @validate_card_object
 def time(card):
-    """Retrieve current date and time information in UTC. Upon power-up, the Notecard must complete a sync to Notehub in order to obtain time and location data. Before the time is obtained, this request will return `{"zone":"UTC,Unknown"}`.
+    """Retrieve current date and time information in UTC. Upon power-up, the Notecard must complete a sync to Notehub in order to obtain time and location data. Before the time is obtained, this request will return `{"zone":"UTC,Unknown"}`. The Notecard's stored timezone is only updated when a new Notehub session begins.
 
     Args:
         card (Notecard): The current Notecard object.

notecard/env.py

@@ -13,7 +13,7 @@
 
 
 @validate_card_object
-def default(card, name=None, sync=None, text=None):
+def default(card, name, sync=None, text=None):
     """Use by the Notecard host to specify a default value for an environment variable until that variable is overridden by a device, project or fleet-wide setting at Notehub.
 
     Args:
@@ -76,7 +76,7 @@ def modified(card, time=None):
 
 
 @validate_card_object
-def set(card, name=None, text=None):
+def set(card, name, text=None):
     """Set a local environment variable on the Notecard. Local environment variables cannot be overridden by a Notehub variable of any scope.
 
     Args:

notecard/web.py

@@ -18,11 +18,11 @@ def delete(card, async_=None, content=None, file=None, name=None, note=None, rou
 
     Args:
         card (Notecard): The current Notecard object.
-        async_ (bool): If `true`, the Notecard performs the web request asynchronously, and returns control to the host without waiting for a response from Notehub.
+        async_ (bool): If `true`, the Notecard performs the web request asynchronously, and returns control to the host without waiting for a response from Notehub. This argument only applies when the Notecard is in `continuous` mode and currently online.
         content (str): The MIME type of the body or payload of the response. Default is `application/json`.
-        file (str): The name of the local-only Database Notefile (`.dbx`) to be used if the web request is issued asynchronously and you wish to store the response.
+        file (str): The name of a local-only Database Notefile (.dbx) where the response will be stored when the web request is executed as a queued web transaction (e.g. if the request is made when Notecard is not in continuous mode and not online). If `file` is not specified, queued web transaction responses are discarded. This argument is not used when the Notecard is in `continuous` mode and online, as responses in that case are returned directly to the host.
         name (str): A web URL endpoint relative to the host configured in the Proxy Route. URL parameters may be added to this argument as well (e.g. `/deleteReading?id=1`).
-        note (str): The unique Note ID for the local-only Database Notefile (`.dbx`). Only used with asynchronous web requests (see `file` argument above).
+        note (str): The unique Note ID within the local-only Database Notefile (.dbx) specified by the `file` argument (see above). Used with queued web transactions to identify a specific Note where the response will be stored.
         route (str): Alias for a Proxy Route in Notehub.
         seconds (int): If specified, overrides the default 90 second timeout.
 
@@ -110,7 +110,7 @@ def post(card, async_=None, binary=None, body=None, content=None, file=None, max
         route (str): Alias for a Proxy Route in Notehub.
         seconds (int): If specified, overrides the default 90 second timeout.
         status (str): A 32-character hex-encoded MD5 sum of the payload or payload fragment. Used by Notehub to perform verification upon receipt.
-        total (int): When using the `application/octet-stream` content type, you may send large payloads to Notehub in fragments spanning several `web.post` requests by using `offset` (see above) and `total`. The `total` field indicates the total size, in bytes (10MB max), of the payload across all fragments.
+        total (int): When using the `application/octet-stream` content type, you may send large payloads to Notehub in fragments spanning several `web.post` requests by using `offset` (see above) and `total`. The `total` field indicates the total size, in bytes, of the payload across all fragments.
         verify (bool): `true` to request verification from Notehub once the payload or payload fragment is received. Automatically set to `true` when `status` is supplied.
 
     Returns:
@@ -169,7 +169,7 @@ def put(card, async_=None, binary=None, body=None, content=None, file=None, max=
         route (str): Alias for a Proxy Route in Notehub.
         seconds (int): If specified, overrides the default 90 second timeout.
         status (str): A 32-character hex-encoded MD5 sum of the payload or payload fragment. Used by Notehub to perform verification upon receipt.
-        total (int): When using the `application/octet-stream` content type, you may send large payloads to Notehub in fragments spanning several `web.put` requests by using `offset` (see above) and `total`. The `total` field indicates the total size, in bytes (10MB max), of the payload across all fragments.
+        total (int): When using the `application/octet-stream` content type, you may send large payloads to Notehub in fragments spanning several `web.put` requests by using `offset` (see above) and `total`. The `total` field indicates the total size, in bytes, of the payload across all fragments.
         verify (bool): `true` to request verification from Notehub once the payload or payload fragment is received. Automatically set to `true` when `status` is supplied.
 
     Returns: