pybricks.robotics.DriveBase: Add brake.

doc/main/robotics.rst

@@ -39,6 +39,8 @@
 
     .. automethod:: pybricks.robotics.DriveBase.stop
 
+    .. automethod:: pybricks.robotics.DriveBase.brake
+
     .. rubric:: Measuring
 
     .. automethod:: pybricks.robotics.DriveBase.distance

jedi/tests/test_get_signature.py

@@ -985,6 +985,7 @@ METHOD_PARAMS = [
         [(["speed: Number", "turn_rate: Number"], "None")],
     ),
     pytest.param("pybricks.robotics", "DriveBase", "stop", [([], "None")]),
+    pytest.param("pybricks.robotics", "DriveBase", "brake", [([], "None")]),
     pytest.param("pybricks.robotics", "DriveBase", "distance", [([], "int")]),
     pytest.param("pybricks.robotics", "DriveBase", "angle", [([], "int")]),
     pytest.param(

src/pybricks/robotics.py

@@ -86,6 +86,12 @@ class DriveBase:
 
         Stops the robot by letting the motors spin freely."""
 
+    def brake(self) -> None:
+        """brake()
+
+        Stops the robot by passively braking the motors.
+        """
+
     def distance(self) -> int:
         """distance() -> int: mm