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 PyTest 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 run the application, you can use Git and the Python Interpreter, which allows you to clone and run the application, pip to create a command line application, or Docker to create a container of the application.

Git

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

pip

You can install the program from the Python Package Index through pip.

# Install via pip
$ pip install running-calculator

# Run the CLI
$ running-calculator

Docker

You can 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. 
exit             Exit the program.
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.7.0.tar.gz (43.3 kB view details)

Uploaded Source

Built Distribution

Running_Calculator-1.7.0-py3-none-any.whl (29.5 kB view details)

Uploaded Python 3

File details

Details for the file Running-Calculator-1.7.0.tar.gz.

File metadata

  • Download URL: Running-Calculator-1.7.0.tar.gz
  • Upload date:
  • Size: 43.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.6

File hashes

Hashes for Running-Calculator-1.7.0.tar.gz
Algorithm Hash digest
SHA256 cedcec1e71482c692edaaad0aa640b8d7a72f56fa5025336f9c475ecade2057d
MD5 ad9ce1ae7e63b9bb1f017db499c1dd88
BLAKE2b-256 9bc30ecb00c907c3277cc3dc8e593f8fcd705ccd3b89a90bd4ee12186650d168

See more details on using hashes here.

File details

Details for the file Running_Calculator-1.7.0-py3-none-any.whl.

File metadata

File hashes

Hashes for Running_Calculator-1.7.0-py3-none-any.whl
Algorithm Hash digest
SHA256 99b328e0f946588f5a937740e4fd944187581dfc48cb6a3f518619ee0487c2af
MD5 c9feea2c577b872f96a5818b60a01f7d
BLAKE2b-256 10a20b288fa9b7b25352b00ffcc653609d5a4b360297b63f4d0c69bec4fe691b

See more details on using hashes here.

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