Skip to main content

A command line tool and import library for performing unit conversions.

Project description

# Unitconvert: Unit conversion tool - Version 1.0.4

## Synopsis

A command line tool and import library for performing unit conversions.

## Testing

There is a “tests” directory containing some unit tests for some of the classes and functions in this application.

Additionally, the application has been tested on the following systems and python versions:

  • Ubuntu 16.04 (python 3.5.2, python 2.7.12)

## Known Issues

  • Fully untested on Windows, Mac, and BSD at this time

## Installation

Install with pip:

pip install unitconvert

## Usage

After installation is completed, you may run the unitconvert tool in a terminal using the following command:

unitconvert -a AMOUNT -f UNIT_FROM -t UNIT_TO

To print version information:

unitconvert -v

To print help:

unitconvert -h

The unit libraries may also be imported and used in Python scripts to perform conversions. Example:

` # Filename: from unitconvert import digitalunits print(digitalunits.DigitalUnit(500, 'GB', 'MB').doconvert()) `


` $ python 500000.0 `

Command line arguments: * -a AMOUNT: Amount to convert * -f UNIT_FROM: Unit to convert from * -t UNIT_TO: Unit to convert to * -v VERSION: Optional, print version info * -h with no other arguments: print help info

Available unit types with associated class (in brackets) and arguments (in parentheses):

  • Digital [DigitalUnit]: - Decimal: Byte (B), Kilobyte (kB), Megabyte (MB), Gigabyte (GB), Terabyte (TB), Petabyte (PB), Exabyte (EB), Zettabyte (ZB), Yottabyte (YB) - Binary: Kibibyte (KiB), Mebibyte (MiB), Gibibyte (GiB), Tebibyte (TiB), Pebibyte (PiB), Exbibyte (EiB), Zebibyte (ZiB), Yobibyte (YiB)
  • Length [LengthUnit]: Millimeter (mm), Centimeter (cm), Inch (in), Foot (ft), Yard (yd), Meter (m), Kilometer (km), Mile (mi)
  • Time [TimeUnit]: Millisecond (ms), second (sec), Minute (min), Hour (hr), Day (day), Week (wk), Month (mo), Year (yr)
  • Volume [VolumeUnit]: - Metric: Milliliter (ml), Liter (l) - US customary: Teaspoon (tsp), Tablespoon (tbsp), fluid Ounces (floz), Cup (cup), Pint (pt), Quart (qt), Gallon (gal) - US legal: Cup (lcup) - Cubic: Cubic Inch (in3), Cubic Foot (ft3)
  • Mass [MassUnit]: Milligram (mg), Gram (g), Ounce (oz), Pound (lb), Kilogram (kg)
  • Temperature [TemperatureUnit]: Fahrenheit (F), Celsius (C), Kelvin (K)

## Updating

If you want to update the application currently installed, just run the following to upgrade with pip:

pip install unitconvert –upgrade

## Uninstalling

If you want to uninstall the application, run the following to uninstall with pip:

pip uninstall unitconvert

## To Do

  • Add support for more units

## Contributors

Get in touch with me if you’d like to contribute.

## License

The code contained within this repository is released under the MIT license.

## Changelog

### Version 1.0.4 * 12/09/2017: Converted individual class methods to single dict for simplicity. Added new module to hold parent classes. Updated and with new version.

### Version 1.0.3 * 10/21/2017: Updated README with import instructions. Updated and with updated description.

### Version 1.0.2 * 10/21/2017: Updated README

### Version 1.0.1 * 06/17/2017: Added fluid ounces

### Version 1.0.0 * 06/10/2017: Initial release

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

unitconvert-1.0.4.tar.gz (7.8 kB view hashes)

Uploaded source

Built Distribution

unitconvert-1.0.4-py2.py3-none-any.whl (12.4 kB view hashes)

Uploaded py2 py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page