pace-converter/README.md

Universal running pace converter. Minutes per kilometer, Kilometers per hour, Minutes per mile, Miles per hour.

# pace-converter

Universal running pace converter. Minutes per kilometer, Kilometers per hour, Minutes per mile, Miles per hour.

[![tested with jest](https://img.shields.io/badge/tested_with-jest-99424f.svg)](https://github.com/facebook/jest)

## How to use the Library

```bash
➜ ~ npm i -S pace-converter
```

```javascript
const convert = require('pace-converter').convert;

const model = convert('4:50', 'minkm');

console.log('model:', JSON.stringify(model, null, 2));
```

## How to use the CLI

```bash
➜ ~ npm i -g pace-converter
➜ ~ pace-converter-convert -p '5:00' -u 'minkm'
{ minkm: '5:00', kmh: 12, minmi: '08:02.76', mih: 7.457 }
```

## Convert

- [X] Minutes per kilometer: 'minkm'

- [X] Kilometers per hour: 'kmh'

- [X] Minutes per mile: 'minmi'

- [X] Miles per hour: 'mih'

## Converters

![converters - v1.0.1](converters_-_v1.0.1.png "converters - v1.0.1")

- [X] Minutes per kilometer to Kilometers per hour (minkm2kmh)

- [X] Kilometers per hour to Minutes per kilometer (kmh2minkm)

- [X] Minutes per kilometer to Minutes per mile (minkm2minmi)

- [X] Minutes per mile to Minutes per kilometer (minmi2minkm)

- [X] Minutes per kilometer to Miles per hour (minkm2mih)

- [X] Miles per hour to Minutes per kilometer (mih2minkm)

- [X] Kilometers per hour to Minutes per mile (kmh2minmi)

- [X] Minutes per mile to Kilometers per hour (minmi2kmh)

- [X] Kilometers per hour to Miles per hour (kmh2mih)

- [X] Miles per hour to Kilometers per hour (mih2kmh)

- [X] Miles per hour to Minutes per mile (mih2minmi)

- [X] Minutes per mile to Miles per hour (minmi2mih)