paces-calc


Namepaces-calc JSON
Version 0.9.0 PyPI version JSON
download
home_pageNone
Summarypace to different distances converter
upload_time2024-10-16 00:08:38
maintainerNone
docs_urlNone
authorNone
requires_python>=3.9
licenseMIT
keywords pace distance conversion command line
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            paces_calc
===============

paces to distances conversion, a command line tool.

The main use cases of the tool are:

- Converting a workout pace at a given distance to what it's splits will be at
some specified distances
- Comparing average race splits across different times at given distance in a readable format
- Converting paces from and to meters (m), miles (mi), and kilometers (km or k)

Installation
------------

To install the command line tool, run:

```shell
pip3 install paces_calc
```

The command line tool will be installed as `pace` to `bin` on
Linux (e.g. `/usr/bin`); or as `pace.exe` to `Scripts` in your
Python installation on Windows (e.g. `C:\Python39\Scripts\pace.exe`).

You may consider installing only for the current user:

```shell
pip3 install paces_calc --user
```

In this case the command line utility will be installed to
`~/.local/bin/pace` on Linux and to
`%APPDATA%\Python\Scripts\pace.exe` on Windows.

Usage
-----

From the command line, use the installed `pace` script:

```shell
pace 4:12 -a 1600m -t 200m 400m 800m
```

Shorthand for the above operation would be:

```shell
pace 4:12 1600m 200m 400m 800m
```

use `pace -h` or `pace --help` for the quick help output, or use `pace man` for the full **man page** of the utility.

    usage: pace [-h] [-v] [-g] [-a DISTANCE] [-t [DISTANCE ...]] [pace ...]

    Easy pace conversion from the command line. When stdin is 'pace' (H:M:S or M:S or S), considered mile pace, and paces (400m, distance) at other
    distances are put to stdout.

    positional arguments:
    pace               The initial pace, so 0:6:12 is 0 hourse, 6 minutes, and 12 seconds

    options:
    -h, --help         show this help message and exit
    -v, --version      show program's version number and exit
    -g, --gui          open window application for pace distance conversions outside of command line
    -a, --at DISTANCE  specify the distance pace is at (i.e. 1600m)
    -t, --to DISTANCE  specify to what distance(s) you are converting to (i.e. 200m 400m 1mi)

Subtleties
----------

When `pace` is used shorthand style (without options -a or -t), only the first argument given is taken as the given pace, teh second argument is the distance that pace was run at, and the rest of the arguments are treated as the distances to convert to:

- `pace 12:14 -a 2mi -t 400m 800m 1km` is equivalent to `pace 12:14 2mi 400m 800m 1km`

When no distance unit is included with a distance value, the distance is considered to have been given in meters:

- `pace 4:16 -a 1600 -t 400 800` is treated as `pace 4:16 -a 1600m -t 400m 800m`

Using options instead of shorthand allows for multiple paces to be given as the starting parameter before -a, meaning different converted paces can be compared.  Each starting pace to convert will be a seperate column in the printed out table:

- `pace 27:05 26:43 26:15 -a 8km -t 400m 1mi 3km 5km 10km` Will produce 3 columns for 27:05, 26:43, and 26:15, with the rows holding the conversions for each of these 8km times to the given -t distances

calc is short for calculator by the way, it's slang

Examples
--------

Default usage:
- `pace 5:22`

![](https://github.com/Vladimir-Herdman/Pace-Calculator/raw/main/documentation/default_usage.png)

Multiple 8km race times and their avergae splits at specified distances:
- `pace 27:05 26:30 26:05 25:45 -a 8km -t 400m 1mi 2mi 5km 10km`

![](https://github.com/Vladimir-Herdman/Pace-Calculator/raw/main/documentation/8km_race.png)

A 5 minute 12 second 1600m workout time and the splits to hit it:
- `pace 5:12 1600m 200m 400m 800m`

![](https://github.com/Vladimir-Herdman/Pace-Calculator/raw/main/documentation/1600m_workout.png)

Elian Kipchoge's 2022 Berlin marathon time compared to a 2:36:42 time:
-  `pace 2:01:09 2:36:42 -a 26.2mi -t 400m 5km 8km 13.1mi`

![](https://github.com/Vladimir-Herdman/Pace-Calculator/raw/main/documentation/Kipchoge_marathon.png)

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "paces-calc",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.9",
    "maintainer_email": null,
    "keywords": "pace, distance, conversion, command line",
    "author": null,
    "author_email": "Vladimir Herdman <vovaherdman@gmail.com>",
    "download_url": "https://files.pythonhosted.org/packages/40/29/edb7bc55c2893ca81db4aa4c0583a596adf9ffb126b971750de88d32ea3a/paces_calc-0.9.0.tar.gz",
    "platform": null,
    "description": "paces_calc\n===============\n\npaces to distances conversion, a command line tool.\n\nThe main use cases of the tool are:\n\n- Converting a workout pace at a given distance to what it's splits will be at\nsome specified distances\n- Comparing average race splits across different times at given distance in a readable format\n- Converting paces from and to meters (m), miles (mi), and kilometers (km or k)\n\nInstallation\n------------\n\nTo install the command line tool, run:\n\n```shell\npip3 install paces_calc\n```\n\nThe command line tool will be installed as `pace` to `bin` on\nLinux (e.g. `/usr/bin`); or as `pace.exe` to `Scripts` in your\nPython installation on Windows (e.g. `C:\\Python39\\Scripts\\pace.exe`).\n\nYou may consider installing only for the current user:\n\n```shell\npip3 install paces_calc --user\n```\n\nIn this case the command line utility will be installed to\n`~/.local/bin/pace` on Linux and to\n`%APPDATA%\\Python\\Scripts\\pace.exe` on Windows.\n\nUsage\n-----\n\nFrom the command line, use the installed `pace` script:\n\n```shell\npace 4:12 -a 1600m -t 200m 400m 800m\n```\n\nShorthand for the above operation would be:\n\n```shell\npace 4:12 1600m 200m 400m 800m\n```\n\nuse `pace -h` or `pace --help` for the quick help output, or use `pace man` for the full **man page** of the utility.\n\n    usage: pace [-h] [-v] [-g] [-a DISTANCE] [-t [DISTANCE ...]] [pace ...]\n\n    Easy pace conversion from the command line. When stdin is 'pace' (H:M:S or M:S or S), considered mile pace, and paces (400m, distance) at other\n    distances are put to stdout.\n\n    positional arguments:\n    pace               The initial pace, so 0:6:12 is 0 hourse, 6 minutes, and 12 seconds\n\n    options:\n    -h, --help         show this help message and exit\n    -v, --version      show program's version number and exit\n    -g, --gui          open window application for pace distance conversions outside of command line\n    -a, --at DISTANCE  specify the distance pace is at (i.e. 1600m)\n    -t, --to DISTANCE  specify to what distance(s) you are converting to (i.e. 200m 400m 1mi)\n\nSubtleties\n----------\n\nWhen `pace` is used shorthand style (without options -a or -t), only the first argument given is taken as the given pace, teh second argument is the distance that pace was run at, and the rest of the arguments are treated as the distances to convert to:\n\n- `pace 12:14 -a 2mi -t 400m 800m 1km` is equivalent to `pace 12:14 2mi 400m 800m 1km`\n\nWhen no distance unit is included with a distance value, the distance is considered to have been given in meters:\n\n- `pace 4:16 -a 1600 -t 400 800` is treated as `pace 4:16 -a 1600m -t 400m 800m`\n\nUsing options instead of shorthand allows for multiple paces to be given as the starting parameter before -a, meaning different converted paces can be compared.  Each starting pace to convert will be a seperate column in the printed out table:\n\n- `pace 27:05 26:43 26:15 -a 8km -t 400m 1mi 3km 5km 10km` Will produce 3 columns for 27:05, 26:43, and 26:15, with the rows holding the conversions for each of these 8km times to the given -t distances\n\ncalc is short for calculator by the way, it's slang\n\nExamples\n--------\n\nDefault usage:\n- `pace 5:22`\n\n![](https://github.com/Vladimir-Herdman/Pace-Calculator/raw/main/documentation/default_usage.png)\n\nMultiple 8km race times and their avergae splits at specified distances:\n- `pace 27:05 26:30 26:05 25:45 -a 8km -t 400m 1mi 2mi 5km 10km`\n\n![](https://github.com/Vladimir-Herdman/Pace-Calculator/raw/main/documentation/8km_race.png)\n\nA 5 minute 12 second 1600m workout time and the splits to hit it:\n- `pace 5:12 1600m 200m 400m 800m`\n\n![](https://github.com/Vladimir-Herdman/Pace-Calculator/raw/main/documentation/1600m_workout.png)\n\nElian Kipchoge's 2022 Berlin marathon time compared to a 2:36:42 time:\n-  `pace 2:01:09 2:36:42 -a 26.2mi -t 400m 5km 8km 13.1mi`\n\n![](https://github.com/Vladimir-Herdman/Pace-Calculator/raw/main/documentation/Kipchoge_marathon.png)\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "pace to different distances converter",
    "version": "0.9.0",
    "project_urls": {
        "homepage": "https://github.com/Vladimir-Herdman/Pace-Calculator.git",
        "repository": "https://github.com/Vladimir-Herdman/Pace-Calculator.git"
    },
    "split_keywords": [
        "pace",
        " distance",
        " conversion",
        " command line"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "baad7735a5474212849f74baee075295fcc33b7f5f5074890e008cbde8c0c172",
                "md5": "40b2c19fa04ff20f55b6e4fb0b6c529b",
                "sha256": "abb9e5fb31a1d152028664a073cd28459be17a2254147e1181d8a00e3928285d"
            },
            "downloads": -1,
            "filename": "paces_calc-0.9.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "40b2c19fa04ff20f55b6e4fb0b6c529b",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.9",
            "size": 9514,
            "upload_time": "2024-10-16T00:08:37",
            "upload_time_iso_8601": "2024-10-16T00:08:37.092069Z",
            "url": "https://files.pythonhosted.org/packages/ba/ad/7735a5474212849f74baee075295fcc33b7f5f5074890e008cbde8c0c172/paces_calc-0.9.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "4029edb7bc55c2893ca81db4aa4c0583a596adf9ffb126b971750de88d32ea3a",
                "md5": "0e77bc0b02a9014a0f96c2fd1486cb29",
                "sha256": "0d64d3cd45b4f176cae4e1af8ea6e00e00b85ef7954fd385051edfd31e654f60"
            },
            "downloads": -1,
            "filename": "paces_calc-0.9.0.tar.gz",
            "has_sig": false,
            "md5_digest": "0e77bc0b02a9014a0f96c2fd1486cb29",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.9",
            "size": 9754,
            "upload_time": "2024-10-16T00:08:38",
            "upload_time_iso_8601": "2024-10-16T00:08:38.490230Z",
            "url": "https://files.pythonhosted.org/packages/40/29/edb7bc55c2893ca81db4aa4c0583a596adf9ffb126b971750de88d32ea3a/paces_calc-0.9.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-10-16 00:08:38",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "Vladimir-Herdman",
    "github_project": "Pace-Calculator",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "lcname": "paces-calc"
}
        
Elapsed time: 0.53313s