# Python-ms
A Python equivalent to the JavaScript `ms` package.
This port of the original project supports some additional string-to-ms
conversions, but otherwise the functionality is identical. This version
also uses integers for everything to avoid rounding errors with
floating-point numbers when using large values.
Using the project's unit tests as examples is recommended, as they cover
everything.
| Type | Badges |
|--------------|---|
| PyPI |     [](https://pypi.org/project/python-ms/) |
| Tests | [](https://codecov.io/gh/Diapolo10/python-ms)    |
| Activity |        |
| QA | [](https://www.codefactor.io/repository/github/diapolo10/python-ms) [](https://libraries.io/github/Diapolo10/python-ms/sourcerank) |
| Other | [](https://opensource.org/licenses/MIT) [](https://app.fossa.com/projects/git%2Bgithub.com%2FDiapolo10%2Fpython-ms?ref=badge_shield) [](https://snyk.io/test/github/diapolo10/python-ms)    |
## Installation
The project is available via PyPI:
```sh
pip install python_ms
```
## Examples
### Convert from strings
```python
import python_ms as ms
ms('2 days') # 172_800_000
ms('1d') # 86_400_000
ms('10h') # 36_000_000
ms('2.5 hrs') # 9_000_000
ms('2h') # 7_200_000
ms('1m') # 60_000
ms('5s') # 5_000
ms('1y') # 31_557_600_000
ms('100') # 100
ms('-3 days') # -259_200_000
ms('-1h') # -3_600_000
ms('-200') # -200
```
### Convert from milliseconds
```python
import python_ms as ms
ms(60_000) # "1m"
ms(2 * 60_000) # "2m"
ms(-3 * 60_000) # "-3m"
ms(ms('10 hours')) # "10h"
```
### Time format written out
```python
import python_ms as ms
ms(60_000, long=True) # "1 minute"
ms(2 * 60_000, long=True) # "2 minutes"
ms(-3 * 60_000, long=True) # "-3 minutes"
ms(ms('10 hours'), long=True) # "10 hours"
```
## Features
- Has no dependencies aside from the standard library
- If a number is supplied to `python_ms`, a string with a unit is returned
- If a string that contains the number is supplied, it returns it as a number (e.g.: it returns `100` for `'100'`)
- If you pass a string with a number and a valid unit, the number of equivalent milliseconds is returned
## Related Packages
- [ms](https://github.com/vercel/ms) - The original JavaScript `ms` package
## Caught a Bug?
1. [Fork](https://help.github.com/articles/fork-a-repo/) this repository to your own GitHub account and then [clone](https://help.github.com/articles/cloning-a-repository/) it to your local device
2. Install `poetry` (if it isn't already installed)
3. Run `poetry install` in the project directory. This fetches development dependencies like `pytest` and sets up everything for you to start debugging
As always, you can run the tests using: `poetry run pytest`
Raw data
{
"_id": null,
"home_page": "https://pypi.org/project/python-ms/",
"name": "python_ms",
"maintainer": "Lari Liuhamo",
"docs_url": null,
"requires_python": "<4.0,>=3.10",
"maintainer_email": "lari.liuhamo+pypi@gmail.com",
"keywords": "package, python3, time",
"author": "Lari Liuhamo",
"author_email": "lari.liuhamo+pypi@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/18/c3/df826eb3438d0fdd87e4b6569c6c0a177c6b60f96462d572ac254d63da0d/python_ms-1.1.1.tar.gz",
"platform": null,
"description": "# Python-ms\n\nA Python equivalent to the JavaScript `ms` package.\n\nThis port of the original project supports some additional string-to-ms\nconversions, but otherwise the functionality is identical. This version\nalso uses integers for everything to avoid rounding errors with\nfloating-point numbers when using large values.\n\nUsing the project's unit tests as examples is recommended, as they cover\neverything.\n\n| Type | Badges |\n|--------------|---|\n| PyPI |     [](https://pypi.org/project/python-ms/) |\n| Tests | [](https://codecov.io/gh/Diapolo10/python-ms)    |\n| Activity |        |\n| QA | [](https://www.codefactor.io/repository/github/diapolo10/python-ms) [](https://libraries.io/github/Diapolo10/python-ms/sourcerank) |\n| Other | [](https://opensource.org/licenses/MIT) [](https://app.fossa.com/projects/git%2Bgithub.com%2FDiapolo10%2Fpython-ms?ref=badge_shield) [](https://snyk.io/test/github/diapolo10/python-ms)    |\n\n## Installation\n\nThe project is available via PyPI:\n\n```sh\npip install python_ms\n```\n\n## Examples\n\n### Convert from strings\n\n```python\nimport python_ms as ms\n\nms('2 days') # 172_800_000\nms('1d') # 86_400_000\nms('10h') # 36_000_000\nms('2.5 hrs') # 9_000_000\nms('2h') # 7_200_000\nms('1m') # 60_000\nms('5s') # 5_000\nms('1y') # 31_557_600_000\nms('100') # 100\nms('-3 days') # -259_200_000\nms('-1h') # -3_600_000\nms('-200') # -200\n```\n\n### Convert from milliseconds\n\n```python\nimport python_ms as ms\n\nms(60_000) # \"1m\"\nms(2 * 60_000) # \"2m\"\nms(-3 * 60_000) # \"-3m\"\nms(ms('10 hours')) # \"10h\"\n```\n\n### Time format written out\n\n```python\nimport python_ms as ms\n\nms(60_000, long=True) # \"1 minute\"\nms(2 * 60_000, long=True) # \"2 minutes\"\nms(-3 * 60_000, long=True) # \"-3 minutes\"\nms(ms('10 hours'), long=True) # \"10 hours\"\n```\n\n## Features\n\n- Has no dependencies aside from the standard library\n- If a number is supplied to `python_ms`, a string with a unit is returned\n- If a string that contains the number is supplied, it returns it as a number (e.g.: it returns `100` for `'100'`)\n- If you pass a string with a number and a valid unit, the number of equivalent milliseconds is returned\n\n## Related Packages\n\n- [ms](https://github.com/vercel/ms) - The original JavaScript `ms` package\n\n## Caught a Bug?\n\n1. [Fork](https://help.github.com/articles/fork-a-repo/) this repository to your own GitHub account and then [clone](https://help.github.com/articles/cloning-a-repository/) it to your local device\n2. Install `poetry` (if it isn't already installed)\n3. Run `poetry install` in the project directory. This fetches development dependencies like `pytest` and sets up everything for you to start debugging\n\nAs always, you can run the tests using: `poetry run pytest`\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A Python equivalent to the JavaScript ms package.",
"version": "1.1.1",
"project_urls": {
"Changelog": "https://github.com/Diapolo10/python-ms/blob/main/CHANGELOG.md",
"Documentation": "https://github.com/Diapolo10/python-ms/tree/main/docs",
"Homepage": "https://pypi.org/project/python-ms/",
"Repository": "https://github.com/Diapolo10/python-ms",
"Tracker": "https://github.com/Diapolo10/python-ms/issues"
},
"split_keywords": [
"package",
" python3",
" time"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "a9e52b5092e75502ce71aa110e03acf2cbaecdebdac3341271251f0460911d0d",
"md5": "d7c6e785e7f43070fa9b8ccac9677413",
"sha256": "bb25fd90dd5ed38d674fcfc455ed8e3141db835fb915d2f01c584e4ce1a0fbb4"
},
"downloads": -1,
"filename": "python_ms-1.1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d7c6e785e7f43070fa9b8ccac9677413",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.10",
"size": 6762,
"upload_time": "2024-10-23T18:36:54",
"upload_time_iso_8601": "2024-10-23T18:36:54.101537Z",
"url": "https://files.pythonhosted.org/packages/a9/e5/2b5092e75502ce71aa110e03acf2cbaecdebdac3341271251f0460911d0d/python_ms-1.1.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "18c3df826eb3438d0fdd87e4b6569c6c0a177c6b60f96462d572ac254d63da0d",
"md5": "73346bb6af9ee13b1a0ab5e72c755d1c",
"sha256": "70ab0087c89d33da08c3e95f72faac965968a6ef4189fe4f158f1df5c0d8400d"
},
"downloads": -1,
"filename": "python_ms-1.1.1.tar.gz",
"has_sig": false,
"md5_digest": "73346bb6af9ee13b1a0ab5e72c755d1c",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.10",
"size": 7462,
"upload_time": "2024-10-23T18:36:55",
"upload_time_iso_8601": "2024-10-23T18:36:55.024332Z",
"url": "https://files.pythonhosted.org/packages/18/c3/df826eb3438d0fdd87e4b6569c6c0a177c6b60f96462d572ac254d63da0d/python_ms-1.1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-23 18:36:55",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Diapolo10",
"github_project": "python-ms",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "python_ms"
}
JSON
