mirror of https://github.com/astral-sh/ruff
150 lines
2.9 KiB
Python
150 lines
2.9 KiB
Python
class FasterThanLightError(Exception):
|
|
...
|
|
|
|
|
|
# DOC502
|
|
def calculate_speed(distance: float, time: float) -> float:
|
|
"""
|
|
Calculate speed as distance divided by time.
|
|
|
|
Parameters
|
|
----------
|
|
distance : float
|
|
Distance traveled.
|
|
time : float
|
|
Time spent traveling.
|
|
|
|
Returns
|
|
-------
|
|
float
|
|
Speed as distance divided by time.
|
|
|
|
Raises
|
|
------
|
|
FasterThanLightError
|
|
If speed is greater than the speed of light.
|
|
"""
|
|
return distance / time
|
|
|
|
|
|
# DOC502
|
|
def calculate_speed(distance: float, time: float) -> float:
|
|
"""
|
|
Calculate speed as distance divided by time.
|
|
|
|
Parameters
|
|
----------
|
|
distance : float
|
|
Distance traveled.
|
|
time : float
|
|
Time spent traveling.
|
|
|
|
Returns
|
|
-------
|
|
float
|
|
Speed as distance divided by time.
|
|
|
|
Raises
|
|
------
|
|
FasterThanLightError
|
|
If speed is greater than the speed of light.
|
|
DivisionByZero
|
|
If attempting to divide by zero.
|
|
"""
|
|
return distance / time
|
|
|
|
|
|
# DOC502
|
|
def calculate_speed(distance: float, time: float) -> float:
|
|
"""
|
|
Calculate speed as distance divided by time.
|
|
|
|
Parameters
|
|
----------
|
|
distance : float
|
|
Distance traveled.
|
|
time : float
|
|
Time spent traveling.
|
|
|
|
Returns
|
|
-------
|
|
float
|
|
Speed as distance divided by time.
|
|
|
|
Raises
|
|
------
|
|
FasterThanLightError
|
|
If speed is greater than the speed of light.
|
|
DivisionByZero
|
|
If attempting to divide by zero.
|
|
"""
|
|
try:
|
|
return distance / time
|
|
except ZeroDivisionError as exc:
|
|
raise FasterThanLightError from exc
|
|
|
|
|
|
# This is fine
|
|
def calculate_speed(distance: float, time: float) -> float:
|
|
"""Calculate speed as distance divided by time.
|
|
|
|
ACalculate speed as distance divided by time.
|
|
|
|
Parameters
|
|
----------
|
|
distance : float
|
|
Distance traveled.
|
|
time : float
|
|
Time spent traveling.
|
|
|
|
Returns
|
|
-------
|
|
float
|
|
Speed as distance divided by time.
|
|
|
|
Raises
|
|
------
|
|
TypeError
|
|
If one or both of the parameters is not a number.
|
|
ZeroDivisionError
|
|
If attempting to divide by zero.
|
|
"""
|
|
try:
|
|
return distance / time
|
|
except ZeroDivisionError:
|
|
print("Oh no, why would you divide something by zero?")
|
|
raise
|
|
except TypeError:
|
|
print("Not a number? Shame on you!")
|
|
raise
|
|
|
|
|
|
# DOC502 regression for Sphinx directive after Raises (issue #18959)
|
|
def foo():
|
|
"""First line.
|
|
|
|
Raises
|
|
------
|
|
ValueError
|
|
some text
|
|
|
|
.. versionadded:: 0.7.0
|
|
The ``init_kwargs`` argument.
|
|
"""
|
|
raise ValueError
|
|
|
|
# Make sure we don't bail out on a Sphinx directive in the description of one
|
|
# of the exceptions
|
|
def foo():
|
|
"""First line.
|
|
|
|
Raises
|
|
------
|
|
ValueError
|
|
some text
|
|
.. math:: e^{xception}
|
|
ZeroDivisionError
|
|
Will not be raised, DOC502
|
|
"""
|
|
raise ValueError
|