Made the typing of the pins more explicit, so it's clear where they come from.

Author: BiffoBear

adafruit_rgbled.py

@@ -20,6 +20,14 @@
 
 * Adafruit's SimpleIO library: https://github.com/adafruit/Adafruit_CircuitPython_SimpleIO
 """
+try:
+    from typing import Union
+    import adafruit_pca9685 as pca9685
+    import pwmio
+    import microcontroller
+except ImportError:
+    pass
+
 from pwmio import PWMOut
 from simpleio import map_range
 
@@ -31,21 +39,6 @@ class RGBLED:
     """
     Creates a RGBLED object given three physical pins or PWMOut objects.
 
-    :param red_pin: The physical pin connected to a red LED anode.
-    :type ~microcontroller.Pin: Microcontroller's red_pin.
-    :type pwmio.PWMOut: PWMOut object associated with red_pin.
-    :type PWMChannel: PCA9685 PWM channel associated with red_pin.
-    :param green_pin: The physical pin connected to a green LED anode.
-    :type ~microcontroller.Pin: Microcontroller's green_pin.
-    :type pwmio.PWMOut: PWMOut object associated with green_pin.
-    :type PWMChannel: PCA9685 PWM channel associated with green_pin.
-    :param blue_pin: The physical pin connected to a blue LED anode.
-    :type ~microcontroller.Pin: Microcontroller's blue_pin.
-    :type pwmio.PWMOut: PWMOut object associated with blue_pin.
-    :type PWMChannel: PCA9685 PWM channel associated with blue_pin.
-    :param bool invert_pwm: False if the RGB LED is common cathode,
-        true if the RGB LED is common anode.
-
     Example for setting a RGB LED using a RGB Tuple (Red, Green, Blue):
 
     .. code-block:: python
@@ -96,7 +89,23 @@ class RGBLED:
 
     """
 
-    def __init__(self, red_pin, green_pin, blue_pin, invert_pwm=False):
+    def __init__(
+        self,
+        red_pin: Union[microcontroller.Pin, pwmio.PWMOut, pca9685.PWMChannel],
+        green_pin: Union[microcontroller.Pin, pwmio.PWMOut, pca9685.PWMChannel],
+        blue_pin: Union[microcontroller.Pin, pwmio.PWMOut, pca9685.PWMChannel],
+        invert_pwm: bool = False,
+    ) -> None:
+        """
+        :param Union[microcontroller.Pin, pwmio.PWMOut, pca9685.PWMChannel] red_pin:
+        The connection to the red LED.
+        :param Union[microcontroller.Pin, pwmio.PWMOut, pca9685.PWMChannel] green_pin:
+        The connection to the green LED.
+        :param Union[microcontroller.Pin, pwmio.PWMOut, pca9685.PWMChannel] blue_pin:
+        The connection to the blue LED.
+        :param bool invert_pwm: False if the RGB LED is common cathode,
+        True if the RGB LED is common anode.
+        """
         self._rgb_led_pins = [red_pin, green_pin, blue_pin]
         for i in range(  # pylint: disable=consider-using-enumerate
             len(self._rgb_led_pins)
@@ -112,27 +121,34 @@ def __init__(self, red_pin, green_pin, blue_pin, invert_pwm=False):
         self._current_color = (0, 0, 0)
         self.color = self._current_color
 
-    def __enter__(self):
+    def __enter__(self) -> "RGBLED":
         return self
 
-    def __exit__(self, exception_type, exception_value, traceback):
+    def __exit__(self, exception_type, exception_value, traceback) -> None:
         self.deinit()
 
-    def deinit(self):
+    def deinit(self) -> None:
         """Turn the LEDs off, deinit pwmout and release hardware resources."""
         for pin in self._rgb_led_pins:
             pin.deinit()  # pylint: disable=no-member
         self._current_color = (0, 0, 0)
 
     @property
-    def color(self):
-        """Returns the RGB LED's current color."""
+    def color(self) -> Union[int, tuple]:
+        """Return the RGB LED's current color.
+
+        :return Union[int, tuple]: The currently set color.
+        """
         return self._current_color
 
     @color.setter
-    def color(self, value):
+    def color(self, value: Union[int, tuple]):
         """Sets the RGB LED to a desired color.
-        :param type value: RGB LED desired value - can be a RGB tuple or a 24-bit integer.
+        :param Union[int, tuple] value: RGB LED desired value - can be a RGB tuple of values
+        0 - 255 or a 24-bit integer. e.g. (255, 64, 35) and 0xff4023 are equivalent.
+
+        :raises ValueError: If the input is an int > 0xffffff.
+        :raises TypeError: If the input is not an integer or a tuple.
         """
         self._current_color = value
         if isinstance(value, tuple):
@@ -154,4 +170,4 @@ def color(self, value):
                     rgb[color] -= 65535
                 self._rgb_led_pins[color].duty_cycle = abs(rgb[color])
         else:
-            raise ValueError("Color must be a tuple or 24-bit integer value.")
+            raise TypeError("Color must be a tuple or 24-bit integer value.")