api/pupdevices: add Powered Up Light

pybricks · Jun 8, 2020 · 8084039 · 8084039
1 parent c536081
commit 8084039
Show file tree

Hide file tree

Showing 5 changed files with 29 additions and 2 deletions.
diff --git a/doc/api/diagram_source/pupsensors.ldr b/doc/api/diagram_source/pupsensors.ldr
@@ -13,3 +13,4 @@
 1 15 600 -266 158 -1 0 0 0 -1 0 0 0 1 u9218c01.dat
 1 15 1130 -280 240 1 0 0 0 1 0 0 0 1 37316.dat
 1 15 1290 -280 220 1 0 0 0 1 0 0 0 1 37308.dat
+1 0 690 -312 530 0 0 1 0 1 0 -1 0 0 22168.dat
diff --git a/doc/api/images/light.png b/doc/api/images/light.png
diff --git a/doc/api/pupdevices.rst b/doc/api/pupdevices.rst
@@ -211,3 +211,16 @@ Force Sensor
     .. automethod:: pybricks.pupdevices::RemoteControl.light.off
 
     .. automethod:: pybricks.pupdevices::RemoteControl.buttons.pressed
+
+Light
+^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. figure:: ../api/images/light.png
+   :width: 90 %
+
+.. autoclass:: pybricks.pupdevices.Light
+    :no-members:
+
+    .. automethod:: pybricks.pupdevices.Light.on
+
+    .. automethod:: pybricks.pupdevices.Light.off
diff --git a/pybricks/_common.py b/pybricks/_common.py
@@ -393,7 +393,7 @@ class Light:
     """Control a single-color light."""
 
     def on(self, brightness=100):
-        """Turn on the light at the specified brightness.
+        """Turns on the light at the specified brightness.
 
         Arguments:
             brightness (:ref:`brightness`):

diff --git a/pybricks/pupdevices.py b/pybricks/pupdevices.py
@@ -5,7 +5,7 @@
 
 from ._common import (KeyPad as _KeyPad, Accelerometer as _Accelerometer,
                       ColorLight as _ColorLight, Motor as _Motor,
-                      LightArray as _LightArray)
+                      LightArray as _LightArray, Light as _Light)
 
 
 class Motor(_Motor):
@@ -311,3 +311,16 @@ def touched(self):
         """
 
         pass
+
+
+class Light(_Light):
+    """LEGO® Powered Up Light."""
+
+    def __init__(self, port):
+        """
+
+        Arguments:
+            port (Port): Port to which the device is connected.
+
+        """
+        pass