Skip to content

API Documentation

celsius_to_fahrenheit(celsius)

Converts a temperature from Celsius to Fahrenheit.

Parameters:

Name Type Description Default
celsius float

The temperature in Celsius.

 required

Returns:

Type Description
float

The temperature in Fahrenheit.
Source code in temperature_conversion.py 
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
def celsius_to_fahrenheit(celsius: float) -> float:
    """
    Converts a temperature from Celsius to Fahrenheit.

    Args:
        celsius: The temperature in Celsius.

    Returns:
        The temperature in Fahrenheit.
    """
    return (celsius * (9 / 5)) + 32

celsius_to_kelvin(celsius)

Converts a temperature from Celsius to Kelvin.

Parameters:

Name Type Description Default
celsius float

The temperature in Celsius.

 required

Returns:

Type Description
float

The temperature in Kelvin.
Source code in temperature_conversion.py 
27
28
29
30
31
32
33
34
35
36
37
def celsius_to_kelvin(celsius: float) -> float:
    """
    Converts a temperature from Celsius to Kelvin.

    Args:
        celsius: The temperature in Celsius.

    Returns:
        The temperature in Kelvin.
    """
    return celsius + 273.15

check_temperature_validity(temperature, unit)

Checks if a temperature is valid for a given unit.

Parameters:

Name Type Description Default
temperature float

The temperature to check.

 required
unit str

The unit of the temperature. Must be "C", "F", or "K".

 required

Returns:

Type Description
bool

True if the temperature is valid, False otherwise.
Source code in temperature_conversion.py 
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
def check_temperature_validity(temperature: float, unit: str) -> bool:
    """
    Checks if a temperature is valid for a given unit.

    Args:
        temperature: The temperature to check.
        unit: The unit of the temperature. Must be "C", "F", or "K".

    Returns:
        True if the temperature is valid, False otherwise.
    """
    abs_zero = {"C": -273.15, "F": -459.67, "K": 0}
    if temperature < abs_zero[unit]:
        return False
    return True

check_unit_validity(unit)

Checks if a unit is valid.

Parameters:

Name Type Description Default
unit str

The unit to check. Must be "C", "F", or "K".

 required

Returns:

Type Description
bool

True if the unit is valid, False otherwise.
Source code in temperature_conversion.py 
70
71
72
73
74
75
76
77
78
79
80
81
82
def check_unit_validity(unit: str) -> bool:
    """
    Checks if a unit is valid.

    Args:
        unit: The unit to check. Must be "C", "F", or "K".

    Returns:
        True if the unit is valid, False otherwise.
    """
    if not unit in ["C", "F", "K"]:
        return False
    return True

convert_temperature(temperature, unit)

Converts a temperature from one unit to another.

Parameters:

Name Type Description Default
temperature float

The temperature to convert.

 required
unit str

The unit of the temperature. Must be "C", "F", or "K".

 required

Returns:

Type Description
tuple

A tuple containing the converted temperature in Celsius and Kelvin units.

Raises:

Type Description
ValueError

If the unit is not "C", "F", or "K".
ValueError

If the temperature is below absolute zero for the given unit.

Examples:

>>> convert_temperature(32, "F")
(0.0, 273.15)
>>> convert_temperature(0, "C")
(32.0, 273.15)
>>> convert_temperature(273.15, "K")
(0.0, -459.67)
Source code in temperature_conversion.py 
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
def convert_temperature(temperature: float, unit: str) -> tuple:
    """
    Converts a temperature from one unit to another.

    Args:
        temperature: The temperature to convert.
        unit: The unit of the temperature. Must be "C", "F", or "K".

    Returns:
        A tuple containing the converted temperature in Celsius and Kelvin units.

    Raises:
        ValueError: If the unit is not "C", "F", or "K".
        ValueError: If the temperature is below absolute zero for the given unit.

    Examples:
        >>> convert_temperature(32, "F")
        (0.0, 273.15)
        >>> convert_temperature(0, "C")
        (32.0, 273.15)
        >>> convert_temperature(273.15, "K")
        (0.0, -459.67)
    """
    if not check_unit_validity(unit):
        raise ValueError("Invalid unit")
    if not check_temperature_validity(temperature, unit):
        raise ValueError("Invalid temperature")
    if unit == "F":
        celsius = fahrenheit_to_celsius(temperature)
        kelvin = celsius_to_kelvin(celsius)
        return celsius, kelvin
    if unit == "C":
        fahrenheit = celsius_to_fahrenheit(temperature)
        kelvin = celsius_to_kelvin(temperature)
        return fahrenheit, kelvin
    if unit == "K":
        celsius = kelvin_to_celsius(temperature)
        fahrenheit = celsius_to_fahrenheit(celsius)
        return celsius, fahrenheit

fahrenheit_to_celsius(fahrenheit)

Converts a temperature from Fahrenheit to Celsius.

Parameters:

Name Type Description Default
fahrenheit float

The temperature in Fahrenheit.

 required

Returns:

Type Description
float

The temperature in Celsius.
Source code in temperature_conversion.py 
14
15
16
17
18
19
20
21
22
23
24
def fahrenheit_to_celsius(fahrenheit: float) -> float:
    """
    Converts a temperature from Fahrenheit to Celsius.

    Args:
        fahrenheit: The temperature in Fahrenheit.

    Returns:
        The temperature in Celsius.
    """
    return (fahrenheit - 32) * (5 / 9)

kelvin_to_celsius(kelvin)

Converts a temperature from Kelvin to Celsius.

Parameters:

Name Type Description Default
kelvin float

The temperature in Kelvin.

 required

Returns:

Type Description
float

The temperature in Celsius.
Source code in temperature_conversion.py 
40
41
42
43
44
45
46
47
48
49
50
def kelvin_to_celsius(kelvin: float) -> float:
    """
    Converts a temperature from Kelvin to Celsius.

    Args:
        kelvin: The temperature in Kelvin.

    Returns:
        The temperature in Celsius.
    """
    return kelvin - 273.15