temporal-lib


Nametemporal-lib JSON
Version 0.0.12 PyPI version JSON
download
home_pageNone
SummaryA library for working with datetime and other temporal concepts.
upload_time2025-01-18 20:49:12
maintainerNone
docs_urlNone
authorNone
requires_python>=3.9
licenseMIT
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"
}
        
Elapsed time: 2.32868s