temporal-lib


Nametemporal-lib JSON
Version 0.0.6 PyPI version JSON
download
home_page
SummaryA library for working with datetime and other temporal concepts.
upload_time2023-04-07 20:38:31
maintainer
docs_urlNone
author
requires_python>=3.7
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": "",
    "name": "temporal-lib",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.7",
    "maintainer_email": "",
    "keywords": "datetime,cron",
    "author": "",
    "author_email": "Datahenge LLC <brian@datahenge.com>",
    "download_url": "https://files.pythonhosted.org/packages/0a/46/0a942d0e3457987217c62168f0e2c374fc3383e0a52fc08ba1af15763765/temporal-lib-0.0.6.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.6",
    "split_keywords": [
        "datetime",
        "cron"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "ca7efa722ebf34d131c2049985b57befc035ddd2a96d42c030e08874c0c1aae2",
                "md5": "23bd0ee5c850de4b9a8321f56ca935ed",
                "sha256": "60f519e09fc6c69c9edd3bb33f9913cfe686b63093100302337ec692f6e3ba48"
            },
            "downloads": -1,
            "filename": "temporal_lib-0.0.6-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "23bd0ee5c850de4b9a8321f56ca935ed",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.7",
            "size": 21897,
            "upload_time": "2023-04-07T20:38:26",
            "upload_time_iso_8601": "2023-04-07T20:38:26.347467Z",
            "url": "https://files.pythonhosted.org/packages/ca/7e/fa722ebf34d131c2049985b57befc035ddd2a96d42c030e08874c0c1aae2/temporal_lib-0.0.6-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "0a460a942d0e3457987217c62168f0e2c374fc3383e0a52fc08ba1af15763765",
                "md5": "482078622cddcb68ba189cdaa7d5df25",
                "sha256": "75f6b4b34ac20c8c0dcb7572edd4c0daba36c9865df071017bba1400fdb53f96"
            },
            "downloads": -1,
            "filename": "temporal-lib-0.0.6.tar.gz",
            "has_sig": false,
            "md5_digest": "482078622cddcb68ba189cdaa7d5df25",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.7",
            "size": 21961,
            "upload_time": "2023-04-07T20:38:31",
            "upload_time_iso_8601": "2023-04-07T20:38:31.050740Z",
            "url": "https://files.pythonhosted.org/packages/0a/46/0a942d0e3457987217c62168f0e2c374fc3383e0a52fc08ba1af15763765/temporal-lib-0.0.6.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-04-07 20:38:31",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "lcname": "temporal-lib"
}
        
Elapsed time: 0.05756s