mirror of
https://github.com/TheAlgorithms/Python.git
synced 2024-11-30 16:31:08 +00:00
23f43afee5
* Added volume conversions This is a file which has relevant function which helps in conversion between volume units. Available Units:- Cubic metre,Litre,KiloLitre,Gallon,Cubic yard,Cubic foot,cup The file is also written in a way that , adding a new unit can easily be done by modifying tuple available in the source code * Formatted file The file was formatted to follow the syntax formatting rules of the repo * Formatted file further
80 lines
2.9 KiB
Python
80 lines
2.9 KiB
Python
"""
|
|
Conversion of volume units.
|
|
Available Units:- Cubic metre,Litre,KiloLitre,Gallon,Cubic yard,Cubic foot,cup
|
|
USAGE :
|
|
-> Import this file into their respective project.
|
|
-> Use the function length_conversion() for conversion of volume units.
|
|
-> Parameters :
|
|
-> value : The number of from units you want to convert
|
|
-> from_type : From which type you want to convert
|
|
-> to_type : To which type you want to convert
|
|
REFERENCES :
|
|
-> Wikipedia reference: https://en.wikipedia.org/wiki/Cubic_metre
|
|
-> Wikipedia reference: https://en.wikipedia.org/wiki/Litre
|
|
-> Wikipedia reference: https://en.wiktionary.org/wiki/kilolitre
|
|
-> Wikipedia reference: https://en.wikipedia.org/wiki/Gallon
|
|
-> Wikipedia reference: https://en.wikipedia.org/wiki/Cubic_yard
|
|
-> Wikipedia reference: https://en.wikipedia.org/wiki/Cubic_foot
|
|
-> Wikipedia reference: https://en.wikipedia.org/wiki/Cup_(unit)
|
|
"""
|
|
|
|
from collections import namedtuple
|
|
|
|
from_to = namedtuple("from_to", "from_ to")
|
|
|
|
METRIC_CONVERSION = {
|
|
"cubicmeter": from_to(1, 1),
|
|
"litre": from_to(0.001, 1000),
|
|
"kilolitre": from_to(1, 1),
|
|
"gallon": from_to(0.00454, 264.172),
|
|
"cubicyard": from_to(0.76455, 1.30795),
|
|
"cubicfoot": from_to(0.028, 35.3147),
|
|
"cup": from_to(0.000236588, 4226.75),
|
|
}
|
|
|
|
|
|
def volume_conversion(value: float, from_type: str, to_type: str) -> float:
|
|
"""
|
|
Conversion between volume units.
|
|
>>> volume_conversion(4, "cubicmeter", "litre")
|
|
4000
|
|
>>> volume_conversion(1, "litre", "gallon")
|
|
0.264172
|
|
>>> volume_conversion(1, "kilolitre", "cubicmeter")
|
|
1
|
|
>>> volume_conversion(3, "gallon", "cubicyard")
|
|
0.017814279
|
|
>>> volume_conversion(2, "cubicyard", "litre")
|
|
1529.1
|
|
>>> volume_conversion(4, "cubicfoot", "cup")
|
|
473.396
|
|
>>> volume_conversion(1, "cup", "kilolitre")
|
|
0.000236588
|
|
>>> volume_conversion(4, "wrongUnit", "litre")
|
|
Traceback (most recent call last):
|
|
File "/usr/lib/python3.8/doctest.py", line 1336, in __run
|
|
exec(compile(example.source, filename, "single",
|
|
File "<doctest __main__.volume_conversion[7]>", line 1, in <module>
|
|
volume_conversion(4, "wrongUnit", "litre")
|
|
File "<string>", line 62, in volume_conversion
|
|
ValueError: Invalid 'from_type' value: 'wrongUnit' Supported values are:
|
|
cubicmeter, litre, kilolitre, gallon, cubicyard, cubicfoot, cup
|
|
"""
|
|
if from_type not in METRIC_CONVERSION:
|
|
raise ValueError(
|
|
f"Invalid 'from_type' value: {from_type!r} Supported values are:\n"
|
|
+ ", ".join(METRIC_CONVERSION)
|
|
)
|
|
if to_type not in METRIC_CONVERSION:
|
|
raise ValueError(
|
|
f"Invalid 'to_type' value: {to_type!r}. Supported values are:\n"
|
|
+ ", ".join(METRIC_CONVERSION)
|
|
)
|
|
return value * METRIC_CONVERSION[from_type].from_ * METRIC_CONVERSION[to_type].to
|
|
|
|
|
|
if __name__ == "__main__":
|
|
import doctest
|
|
|
|
doctest.testmod()
|