Metadata-Version: 2.1
Name: ubconvert
Version: 1.24
Summary: Time, Temperature, Speed, Distance, Volume, Weight conversion module
License: MIT
Author: ZennDogg, Utility_Belt Designs, Tacoma, WA
Requires-Python: >=3.8,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Description-Content-Type: text/markdown


    ubConvert Unit Conversion Classes -

    - Temperatures()
    - Speed_Distance()
    - Weights()
    - Volumes()
    - Times()

    The functions for most classes can be called in two ways.
    First example, to convert Kelvin to Fahrenheit from class Temperatures():

        kelvin = 278.967
        kelvin_to_fahrenheit(kelvin) = 42.74059999999997

    The second way is with a number representing the rounding factor, where:
        - 0 = integer, 1 = one decimal place, 2 = two decimal places, etc.,

        kelvin = 278.967
        kelvin_to_fahrenheit(kelvin, 2) = 42.74,
        kelvin_to_fahrenheit(kelvin, 1) = 42.7,
		kelvin_to_fahrenheit(kelvin, 0) = 43

    For converting and formatting Light-Years and Astronomical Units to kilometers
    or miles, things are a little different. The first way returns an integer:

        lt_years = 2
        light_years_to_miles(lt_years) = 11758000000000

    The second instance returns a number with requested decimal places in
    scientific notation:

        lt_years = 2
        light_years_to_miles(lt_years, 4) = 1.1758e+13

    Because the answers are such large integers, the third way returns the number
    in comma separated format for easier reading (second arg = 0, third arg = 1):

        lt_years = 2
        light_years_to_miles(lt_years, 0, 1) = 11,758,000,000,000

    ..................................................................
    Example:

        import ubConvert as ub

        weights = ub.Weights()
        oz = weights.grams_to_ounces(28)
        oz = 1

    ..................................................................

    Functions: NOTE- use all lower case when calling functions, right?

    - Temperatures() function list           	 	- Weights() function list

        Kelvin_to_Fahrenheit                      	    Grams_to_Ounces
        Kelvin_to_Celsius                         	    Ounces_to_Grams
        Fahrenheit_to_Kelvin                     	    Kilograms_to_Pounds
        Fahrenheit_to_Celsius                     	    Pounds_to_Kilograms
        Celsius_to_Fahrenheit                    	    Kilograms_to_Tons
        Celsius_to_Kelvin                        	    Tons_to_Kilograms
        Rankine_to_Fahrenheit                     	    Tons_to_Metric_Tonnes
        Fahrenheit_to_Rankine                     	    Metric_Tonnes_to_Tons

    - Speed_Distance() function list         		- Volumes() function list
							     
        MPH_to_KPH                                 	    Liters_to_Gallons
        KPH_to_MPH                                	    Gallons_to_Liters
        MPH_to_Meters_per_Second                            Ounces_to_Milliliters
        Meters_per_Second_to_MPH                   	    Milliliters_to_Ounces
        Meters_per_Second_to_KPH                  	    Cubic_Centimeter_to_Cubic_Inch
        KPH_to_Meters_per_Second                  	    Cubic_Inch_to_Cubic_Centimeter
        Miles_to_Kilometers
        Kilometers_to_Miles                   		- Times() function list
        Light_Years_to_Kilometers
        Kilometers_to_Light_Years                  	    Date_to_Timestamp
        Light_Years_to_Miles                       	    Timestamp_to_Date
        Miles_to_Light_Years
        Yards_to_Meters
        Meters_to_Yards
        Inch_to_Centimeter
        Centimeter_to_Inch
        Astronomical_Unit_to_Miles
        Miles_to_Astronomical_Unit
        Astronomical_Unit_to_Kilometers
        Kilometers_to_Astronomical_Unit

