Skip to main content

A running distance and speed command line interface. Measures in metric and imperial units, as well as marathons and half-marathons.

Project description

Running Calculator
Running Calculator

A running distance and speed command line interface! Measures in metric and imperial units, as well as marathons and half-marathons.

PyPI Build State Docker State Pylint State CodeQL State Gitleaks State GitHub Version GitHub Issues GitHub Pull Requests Discord Server ID Downloads GitHub Languages

Key FeaturesDownloadHow To UseSupportContributingChangelogCredits & Contributors

screenshot

Key Features

  • Easily input distance of a run.
  • Input distance can be in marathons, half-marathons, miles, feet, kilometers and meters.
  • Easily input run time.
  • Displays speeds in meters per second and kilometers per hour.
  • Cross platform.

Download

You can download the source code to run the script from the command line on Windows, macOS and Linux. This will require Python.

You can download the latest executable version of Running-Calculator for Windows. This does not require Python.

How To Use

To clone and run this application, you'll need Git and Python installed on your computer. If you would rather not use Git, you can just download the script from GitHub above. From your command line:

# Clone this repository
$ git clone https://github.com/willtheorangeguy/Running-Calculator

# Go into the repository
$ cd Running-Calculator

# Run the CLI
$ python main.py

You can also pull the Docker image from GitHub Packages. From your command line:

# Pull image
$ docker pull ghcr.io/willtheorangeguy/running-calculator:main

# Run container
$ docker run -i -t ghcr.io/willtheorangeguy/running-calculator:main python main.py

Support

The following units are available (can be generated by using the help command):

Marathons        42195m
Half Marathons   21907.5m
Miles            1069.3m
Feet             0.38m
Kilometers       1000m
Meters           1m
license          View the license file. 
quit             Exit the program.

More documentation is available in the Documentation and on the Wiki. If more support is required, please open a GitHub Discussion or join our Discord.

Contributing

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

Please read CONTRIBUTING for details on our CODE OF CONDUCT, and the process for submitting pull requests to us.

Changelog

See the CHANGELOG file for details.

Credits

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

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

Contributors

You may also like...

  • PyWorkout - A minimal CLI to keep you inspired during your workout!
  • PyAvatar - Easily display all of your creative avatars to keep them consistent across websites.
  • Python Logo Widgets - Python Powered Logo widgets that can be added to any GUI project.

License

This project is licensed under the GNU General Public License - see the LICENSE file for details. See the Privacy Policy and Terms and Conditions for legal information.

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

Running-Calculator-1.6.0.tar.gz (42.4 kB view hashes)

Uploaded Source

Built Distribution

Running_Calculator-1.6.0-py3-none-any.whl (29.4 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page