masslos 0.2.3

Multi purpose unit conversion package

Maßlos unit conversion library

Set of functions to convert between different units including metric and imperial

< Add an optional screenshot of your project below >

Table of Contents

• Installation
• Execution / Usage
• Technologies
• Features
• Author
• Change log
• License

Installation

On macOS and Linux:

$ python -m pip install masslos

On Windows:

PS> python -m pip install masslos

Execution / Usage

Here are a few examples of using the masslos library in your code:

from masslos import DistanceUnit, SpeedUnit, WeightUnit

w = WeightUnit()
s = SpeedUnit()
d = DistanceUnit()

# without specifying the decimal digits (default = 2)
dist_in_meter = d.convert(10, "yd", "m")
weight_in_kg = w.convert(11, "lbs", "kg")

print("Speed units:")
print(s.list_units())

# with specifying the decimal digits
dist_in_meter = d.convert(value=10, from_unit="yd", to_unit="m", ndigits=3)
weight_in_kg = w.convert(value=11, from_unit="lbs", to_unit="kg", ndigits=3)

Usage exampe of the new measure classes:

from masslos import Distance, Speed, Weight

w1 = Weight(5, "kg")
w2 = Weight(5000, "g")
s = Speed(55, "mph")
d = Distance(5, "km")

# equals
print(w1 == w2) # True: 5kg is the same as 5,000g
print(w1 == d)  # False: 5kg is NOT equal to 5km

# math
print(w1 + w2)  # 10kg
print(w2 - w1)  # 0g
print(s / 5)    # 11mph
print(d * 4)    # 20km

For more examples, please refer to the project's Wiki or documentation page.

Technologies

masslos uses the following technologies and tools:

• Python:

Features

masslos currently has the following set of features:

• Converting distances including
  • metric
  • imperial
  • astronomical
• Converting weights including
  • metric
  • imperial
• Converting speeds

Author

Andreas Haberl – # – [e-mail]

Change log

• 0.2.3
  • feat: add Measure classes
  • feat: changing class names
    BREAKING CHANGE: use new class names
  • test: update/ammend
  • docs: update/complete docstrings
• 0.2.2
  • fix: packaging
• 0.2.1
  • feat: add Speed class
  • feat: changing to class based API
    BREAKING CHANGE: use instance methods instead of function calls
  • feat: add function "list_units"
  • test: updates
  • docs: update README.md
• 0.2.0
  • feat: argument for precision of conversion
• 0.1.0
  • First working version

License

masslos is distributed under the MIT license. See LICENSE for more details.