Update module docstrings and regenerate api.md

Co-Authored-By: abucknall@blues.com <abucknall@blues.com>

Author: devin-ai-integration[bot]

docs/api.md

@@ -1,4 +1,8 @@
-"""Helper methods for doing binary transfers to/from a Notecard."""
+"""Helper methods for performing binary transfers to and from a Notecard.
+
+This module provides functions for working with the Notecard's binary data store,
+including reading, writing, and managing binary data with CRC verification.
+"""
 
 import sys
 from notecard.cobs import cobs_encode, cobs_decode

notecard/binary_helpers.py

@@ -1,4 +1,9 @@
-"""Methods for COBS encoding and decoding arbitrary bytearrays."""
+"""Functions for COBS encoding and decoding of bytearrays.
+
+This module implements Consistent Overhead Byte Stuffing (COBS), an encoding
+that eliminates zero bytes from arbitrary binary data. The Notecard uses this
+for binary data transfers to ensure reliable transmission.
+"""
 
 
 def cobs_encode(data: bytearray, eop: int) -> bytearray:

notecard/cobs.py

@@ -1,4 +1,8 @@
-"""Module for computing the CRC32 of arbitrary data."""
+"""Functions for computing CRC32 checksums.
+
+This module provides a lightweight implementation of the CRC32 algorithm
+for verifying data integrity in Notecard communications.
+"""
 
 crc32_lookup_table = [
     0x00000000, 0x1DB71064, 0x3B6E20C8, 0x26D930AC, 0x76DC4190, 0x6B6B51F4,

notecard/crc32.py

@@ -1,4 +1,9 @@
-"""Module for computing MD5 hash for MicroPython and CircuitPython."""
+"""Functions for computing MD5 hashes.
+
+This module provides a lightweight implementation of the MD5 algorithm
+for MicroPython and CircuitPython platforms, used for data verification
+in Notecard binary transfers.
+"""
 
 """
 Copyright [2018] [Mauro Riva <lemariva@mail.com> <lemariva.com>]

notecard/md5.py

@@ -402,21 +402,40 @@ def Command(self, req):
         self.Transaction(req)
 
     def GetUserAgent(self):
-        """Return the User Agent String for the host for debug purposes."""
+        """Return the User Agent String for the host for debug purposes.
+        
+        Returns:
+            dict: A dictionary containing user agent information including OS details
+                 and any application-specific user agent information.
+        """
         ua_copy = self._user_agent.copy()
         ua_copy.update(self._user_agent_app or {})
         return ua_copy
 
     def SetAppUserAgent(self, app_user_agent):
-        """Set the User Agent info for the app."""
+        """Set the User Agent info for the app.
+        
+        Args:
+            app_user_agent (dict): Dictionary containing application-specific 
+                                  user agent information.
+        """
         self._user_agent_app = app_user_agent
 
     def UserAgentSent(self):
-        """Return true if the User Agent has been sent to the Notecard."""
+        """Return true if the User Agent has been sent to the Notecard.
+        
+        Returns:
+            bool: True if the User Agent has been sent to the Notecard, False otherwise.
+        """
         return self._user_agent_sent
 
     def SetTransactionPins(self, rtx_pin, ctx_pin):
-        """Set the pins used for RTX and CTX."""
+        """Set the pins used for RTX and CTX.
+        
+        Args:
+            rtx_pin: The pin to use for Ready To Transact (RTX) signaling.
+            ctx_pin: The pin to use for Clear To Transact (CTX) signaling.
+        """
         self._transaction_manager = TransactionManager(rtx_pin, ctx_pin)
 
 

notecard/notecard.py

@@ -1,4 +1,8 @@
-"""Module for managing timeouts in note-python."""
+"""Functions for managing timeouts.
+
+This module provides cross-platform timeout management for Notecard communications,
+supporting different timing mechanisms for CPython, MicroPython, and CircuitPython.
+"""
 
 import sys
 import time

notecard/timeout.py

@@ -1,4 +1,9 @@
-"""TransactionManager-related code for note-python."""
+"""Classes for managing Notecard transactions.
+
+This module provides transaction management for Notecard communications,
+implementing the RTX/CTX protocol for reliable data exchange between
+the host and Notecard.
+"""
 
 import sys
 import time