Running Calculator

Work out your running speed from a distance and a time, in whatever unit you measured it.

Key Features • Installation • Usage • Documentation • Support • Contributing • Credits • License

Key Features

• Enter a distance in marathons, half marathons, miles, feet, kilometres, or metres.
• Enter a time in hours, minutes, and seconds.
• Get speed in metres per second and kilometres per hour.
• Loops, so you can do several runs in one sitting.
• Pure standard library; runs anywhere Python does.

Results are always metric, whatever you entered.

Installation

git clone https://github.com/willtheorangeguy/Running-Calculator
cd Running-Calculator
python main.py

Also on PyPI and as a Docker image — see docs/installation.md.

Usage

What unit will you be inputting? miles
How far did you run? 3.1
How many hours did it take you? (if < 1, enter 0) 0
How many minutes did it take you? (if < 1, enter 0) 27
How many seconds did it take you? 14

Type license for the licence notice, or quit to leave.

Do not enter zero for all three time fields — it divides by zero and exits with a traceback. See docs/internal/known-issues.md.

Documentation

Full documentation lives in docs/: Quickstart · Installation · Units · Architecture · Development · FAQ · Troubleshooting · Roadmap

Support

Open a GitHub Discussion or file an issue.

Contributing

Please contribute using GitHub Flow. Create a branch, add commits, and open a pull request.

See the org-wide Contributing Guide and Code of Conduct.

Credits

This software uses the following open source packages, projects, services or websites:

GitHub	Python Software Foundation	PyInstaller	Carbon
Web - Plans	Web - Donate	Web - Donate	Web

Sponsor @willtheorangeguy on PayPal.

License

MIT — see LICENSE.md.