"""Robotics module for the Pybricks API."""

from .parameters import Stop


class DriveBase():
    """Class representing a robotic vehicle with two powered wheels and
    optional wheel caster(s)."""

    def __init__(self, left_motor, right_motor, wheel_diameter, axle_track):
        """DriveBase(left_motor, right_motor, wheel_diameter, axle_track)

        Arguments:
            left_motor (Motor):
                The motor that drives the left wheel.
            right_motor (Motor):
                The motor that drives the right wheel.
            wheel_diameter (:ref:`dimension`): Diameter of the wheels.
            axle_track (:ref:`dimension`): Distance between the midpoints of
                                           the two wheels.

        """

    def drive(self, speed, steering):
        """Start driving at the specified speed and turn rate, both measured at
        the center point between the wheels of the robot.

        Arguments:
            speed (:ref:`linspeed`): Forward speed of the robot.
            steering (:ref:`speed`): Turn rate of the robot.
        """
        pass

    def arc(self, speed, radius):
        """Start driving along an arc/circle with a given radius.

        Arguments:
            drive_speed (:ref:`linspeed`): Speed of the robot along the arc.
            radius (:ref:`dimension`): Radius of the arc. A positive radius
                value makes your robot go right. A negative radius value makes
                it go left.
        """
        pass

    def stop(self, stop_type=Stop.COAST):
        """stop(stop_type=Stop.COAST)

        Stop the robot.

        Arguments:
            stop_type (Stop): Whether to coast, brake, or hold (*Default*:
                              :class:`Stop.COAST <.parameters.Stop>`).
        """
        pass

    def distance(self):
        """Get the estimated driven distance.

        Returns:
            :ref:`distance`: Driven distance since last reset.
        """
        pass

    def angle(self):
        """Get the estimated rotation angle of the drive base.

        Returns:
            :ref:`angle`: Accumulated angle since last reset.
        """
        pass

    def reset(self):
        """Reset the estimated driven distance and angle to 0."""
        pass

    def set_drive_settings(self, drive_speed, drive_acceleration, turn_rate,
                           turn_acceleration, stop_type):
        """Configure the default speed and acceleration.

        Arguments:
            drive_speed (:ref:`linspeed`): Drive speed of the robot.
            drive_acceleration (:ref:`linacceleration`): Linear acceleration
                of the robot.
            turn_rate (:ref:`speed`): Turn rate of the robot.
            turn_acceleration (:ref:`acceleration`): Angular acceleration of
                the robot.
            stop_type (Stop): Whether to coast, brake, or hold after
                a given command is complete.
        """
        pass

    def straight(self, distance):
        """Drive straight for a given distance.

        Arguments:
            distance (:ref:`distance`): Distance to travel.
        """
        pass

    def turn(self, angle):
        """Turn in place by a given angle.

        Arguments:
            angle (:ref:`angle`): Angle of the turn.
        """
        pass