Improve the documentation of canio.Message & RemoteTransmissionRequest

Author: jepler

adafruit_mcp2515/canio/__init__.py

@@ -14,23 +14,26 @@ class Message:
     def __init__(self, id, data, extended=False):
         """Create a `Message` to send
 
-        Args:
-            id (int): The numeric ID of the message
-            data (bytes): The content of the message
-            extended (bool): True if the
-        Raises:
-            AttributeError: If `data` of type `bytes` is not provided for a non-RTR message
-            AttributeError: If `data` is larger than 8 bytes
+        :param int id: The numeric ID of the message
+        :param bytes data: The content of the message, from 0 to 8 bytes of data
+        :param bool extended: True if the message has an extended identifier,
+            False if it has a standard identifier
         """
 
         self._data = None
         self.id = id
         self.data = data
         self.extended = extended
 
+    id: int
+    """The numeric ID of the message"""
+
+    extended: bool
+    """Indicates whether the the message has an extended identifier"""
+
     @property
     def data(self):
-        """The content of the message, or dummy content in the case of an rtr"""
+        """The content of the message"""
         return self._data
 
     @data.setter
@@ -56,16 +59,24 @@ def __init__(self, id: int, length: int, *, extended: bool = False):
         """Construct a RemoteTransmissionRequest to send on a CAN bus
 
         Args:
-            id (int): The numeric ID of the requested message
-            length (int): The length of the requested message
-            extended (bool, optional): True if the message has an extended identifier, False if it\
-                has a standard identifier. Defaults to False.
-
+        :param int id: The numeric ID of the message
+        :param length int: The length of the requested message
+        :param bool extended: True if the message has an extended identifier,
+            False if it has a standard identifier
         """
         self.id = id
         self.length = length
         self.extended = extended
 
+    id: int
+    """The numeric ID of the message"""
+
+    extended: bool
+    """Indicates whether the the message has an extended identifier"""
+
+    length: int
+    """The length of the requested message, from 0 to 8"""
+
 
 # Replace the above implementation with core canio implementation if it is available
 try: