Name | temporal-lib JSON |
Version |
0.0.12
JSON |
| download |
home_page | None |
Summary | A library for working with datetime and other temporal concepts. |
upload_time | 2025-01-18 20:49:12 |
maintainer | None |
docs_url | None |
author | None |
requires_python | >=3.9 |
license | MIT |
keywords |
datetime
cron
|
VCS |
|
bugtrack_url |
|
requirements |
No requirements were recorded.
|
Travis-CI |
No Travis.
|
coveralls test coverage |
No coveralls.
|
### temporal-lib
A library for working with datetime and other temporal concepts.
### Explanation
Originally, I created a "Temporal" [companion App](https://github.com/Datahenge/temporal) for the [Frappe Framework](https://frappeframework.com/).
Over time, more of my non-ERPNext Python projects required or benefitted from the same helper functions and classes.
So I'm splitting the project:
* All generic, reusable Python code will be stored in this package, and synchronized to PyPi.org.
* The remaining Frappe-specific code will remain on GitHub, and begin to reference this package as a requirement.
### Installation
```bash
pip3 install temporal-lib
```
### Usage
The library's namespace is `temporal_lib`. For example:
```python
""" your_code.py """
from datetime import datetime
import temporal_lib
today_date = datetime.now().date()
today_iso_string = temporal_lib.date_to_iso_string(today)
print(today_iso_string)
```
----
### Standards
* All date strings are expected to be ISO-8601 extended. Example: 2023-11-29
### Links
* To the `temporal-lib` package on PyPi [here](https://pypi.org/project/temporal-lib/).
* A helpful [Wikipedia article](https://en.wikipedia.org/wiki/ISO_8601) about ISO-8601.
* To my **Rust**-based `file-8601` project [here](https://gitlab.com/brian_pond/file8601_rust)!
* (Deprecated) My original Python `file-8601` project [here](https://gitlab.com/brian_pond/file8601)
### Further Reading
* https://blog.ganssle.io/articles/2018/03/pytz-fastest-footgun.html
* https://blog.ganssle.io/articles/2018/02/aware-datetime-arithmetic.html
* https://github.com/regebro/tzlocal/issues/90#issuecomment-699714858
* https://github.com/dateutil/dateutil
### Attributions
Hourglass image on GitLab repository by The Oxygen Team, KDE; - KDE github;, LGPL, https://commons.wikimedia.org/w/index.php?curid=18609110
Raw data
{
"_id": null,
"home_page": null,
"name": "temporal-lib",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "datetime, cron",
"author": null,
"author_email": "Datahenge LLC <brian@datahenge.com>",
"download_url": "https://files.pythonhosted.org/packages/7d/9b/6010cebaa2f8fa7dcb6209d137a6798e2485243ad0e4dedbde554fa5656a/temporal_lib-0.0.12.tar.gz",
"platform": null,
"description": "### temporal-lib\nA library for working with datetime and other temporal concepts.\n\n### Explanation\nOriginally, I created a \"Temporal\" [companion App](https://github.com/Datahenge/temporal) for the [Frappe Framework](https://frappeframework.com/).\nOver time, more of my non-ERPNext Python projects required or benefitted from the same helper functions and classes.\n\nSo I'm splitting the project:\n* All generic, reusable Python code will be stored in this package, and synchronized to PyPi.org.\n* The remaining Frappe-specific code will remain on GitHub, and begin to reference this package as a requirement.\n\n### Installation\n```bash\npip3 install temporal-lib\n```\n\n### Usage\nThe library's namespace is `temporal_lib`. For example:\n\n```python\n\"\"\" your_code.py \"\"\"\nfrom datetime import datetime\nimport temporal_lib\n\ntoday_date = datetime.now().date()\ntoday_iso_string = temporal_lib.date_to_iso_string(today)\nprint(today_iso_string)\n```\n----\n\n### Standards\n\n* All date strings are expected to be ISO-8601 extended. Example: 2023-11-29\n\n### Links\n* To the `temporal-lib` package on PyPi [here](https://pypi.org/project/temporal-lib/).\n* A helpful [Wikipedia article](https://en.wikipedia.org/wiki/ISO_8601) about ISO-8601.\n* To my **Rust**-based `file-8601` project [here](https://gitlab.com/brian_pond/file8601_rust)!\n* (Deprecated) My original Python `file-8601` project [here](https://gitlab.com/brian_pond/file8601)\n\n### Further Reading\n* https://blog.ganssle.io/articles/2018/03/pytz-fastest-footgun.html\n* https://blog.ganssle.io/articles/2018/02/aware-datetime-arithmetic.html\n* https://github.com/regebro/tzlocal/issues/90#issuecomment-699714858\n* https://github.com/dateutil/dateutil\n\n\n### Attributions\nHourglass image on GitLab repository by The Oxygen Team, KDE; - KDE github;, LGPL, https://commons.wikimedia.org/w/index.php?curid=18609110\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A library for working with datetime and other temporal concepts.",
"version": "0.0.12",
"project_urls": null,
"split_keywords": [
"datetime",
" cron"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "ec4e24688a51f86ba5ba781321269c088c88b610b3d3042d4baa58d8729ab320",
"md5": "8987bc14b1bbac565e432fafb2c804f4",
"sha256": "0aadd7e79e9b0b4bc4fa00a6a5e606f251d403e6cd10cf335377ae3a66aa785e"
},
"downloads": -1,
"filename": "temporal_lib-0.0.12-py3-none-any.whl",
"has_sig": false,
"md5_digest": "8987bc14b1bbac565e432fafb2c804f4",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 23291,
"upload_time": "2025-01-18T20:49:11",
"upload_time_iso_8601": "2025-01-18T20:49:11.731438Z",
"url": "https://files.pythonhosted.org/packages/ec/4e/24688a51f86ba5ba781321269c088c88b610b3d3042d4baa58d8729ab320/temporal_lib-0.0.12-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "7d9b6010cebaa2f8fa7dcb6209d137a6798e2485243ad0e4dedbde554fa5656a",
"md5": "2042168a376c9b29b13ff56895d79ebd",
"sha256": "4a1790f8f8f7e116fc091671d27748a81df8d2081da4ebf646f92307de8ccb91"
},
"downloads": -1,
"filename": "temporal_lib-0.0.12.tar.gz",
"has_sig": false,
"md5_digest": "2042168a376c9b29b13ff56895d79ebd",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 24119,
"upload_time": "2025-01-18T20:49:12",
"upload_time_iso_8601": "2025-01-18T20:49:12.805297Z",
"url": "https://files.pythonhosted.org/packages/7d/9b/6010cebaa2f8fa7dcb6209d137a6798e2485243ad0e4dedbde554fa5656a/temporal_lib-0.0.12.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-18 20:49:12",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "temporal-lib"
}