bear-epoch-time


Namebear-epoch-time JSON
Version 1.1.8 PyPI version JSON
download
home_pageNone
SummaryElegant epoch timestamp handling with timezone-aware operations, fluent API, and smart defaults for Python developers who hate datetime complexity.
upload_time2025-07-23 03:23:43
maintainerNone
docs_urlNone
authorNone
requires_python>=3.11
licenseNone
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # Bear Epoch Time v1.1.4

Bear Epoch Time is a lightweight helper library for working with epoch timestamps. It provides timezone-aware
conversion utilities and an optional fluent API for manipulating times without having to remember all of the
`datetime` quirks. Supports Python 3.10+, trying to update things so it supports Python 3.9.

## WIP

README will need to be expanded and elaborated upon.

## Installation

Install from PyPI using `uv`:

```bash
uv pip install bear-epoch-time
```

## Quick Start

### EpochTimestamp

```python
from bear_epoch_time import EpochTimestamp

# current UTC timestamp in milliseconds
now = EpochTimestamp.now()
print(now) # Will print the epoch timestamp as an int
print(now.to_seconds)  # convert to seconds
print(now.date_str())  # "06-12-2025"
```

### TimeTools

```python
from bear_epoch_time import TimeTools

# helper for day ranges and conversions
utils = TimeTools()
start, end = utils.get_day_range()
print(start.to_string())
print(end.to_string())
```

### Limitations

The EpochTimestamp class is designed to work with UTC timestamps in the recent past and future. It is not really meant to work with historical dates or times before the Unix epoch (1970-01-01). It is also not meant to be used for very high precision timing. This is more of a utility library for working with epoch timestamps in a more human-friendly way.

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "bear-epoch-time",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.11",
    "maintainer_email": null,
    "keywords": null,
    "author": null,
    "author_email": "chaz <bright.lid5647@fastmail.com>",
    "download_url": "https://files.pythonhosted.org/packages/29/ef/ccda34eec18e1cbd90a1fe3a823e03a28df0f762e7c0cb62ea26669b4602/bear_epoch_time-1.1.8.tar.gz",
    "platform": null,
    "description": "# Bear Epoch Time v1.1.4\n\nBear Epoch Time is a lightweight helper library for working with epoch timestamps. It provides timezone-aware\nconversion utilities and an optional fluent API for manipulating times without having to remember all of the\n`datetime` quirks. Supports Python 3.10+, trying to update things so it supports Python 3.9.\n\n## WIP\n\nREADME will need to be expanded and elaborated upon.\n\n## Installation\n\nInstall from PyPI using `uv`:\n\n```bash\nuv pip install bear-epoch-time\n```\n\n## Quick Start\n\n### EpochTimestamp\n\n```python\nfrom bear_epoch_time import EpochTimestamp\n\n# current UTC timestamp in milliseconds\nnow = EpochTimestamp.now()\nprint(now) # Will print the epoch timestamp as an int\nprint(now.to_seconds)  # convert to seconds\nprint(now.date_str())  # \"06-12-2025\"\n```\n\n### TimeTools\n\n```python\nfrom bear_epoch_time import TimeTools\n\n# helper for day ranges and conversions\nutils = TimeTools()\nstart, end = utils.get_day_range()\nprint(start.to_string())\nprint(end.to_string())\n```\n\n### Limitations\n\nThe EpochTimestamp class is designed to work with UTC timestamps in the recent past and future. It is not really meant to work with historical dates or times before the Unix epoch (1970-01-01). It is also not meant to be used for very high precision timing. This is more of a utility library for working with epoch timestamps in a more human-friendly way.\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "Elegant epoch timestamp handling with timezone-aware operations, fluent API, and smart defaults for Python developers who hate datetime complexity.",
    "version": "1.1.8",
    "project_urls": null,
    "split_keywords": [],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "3f115d5de6eb8792e2ec8a13ec9b4061603a22e904eb51b3fb5fff2a28cc8253",
                "md5": "df1b44fb4a97217b284375734b557738",
                "sha256": "1d8bb22129c39b19b8ca85f5a511d22d3bc237a28108df636346aba3ffc1cd24"
            },
            "downloads": -1,
            "filename": "bear_epoch_time-1.1.8-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "df1b44fb4a97217b284375734b557738",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.11",
            "size": 22322,
            "upload_time": "2025-07-23T03:23:42",
            "upload_time_iso_8601": "2025-07-23T03:23:42.240583Z",
            "url": "https://files.pythonhosted.org/packages/3f/11/5d5de6eb8792e2ec8a13ec9b4061603a22e904eb51b3fb5fff2a28cc8253/bear_epoch_time-1.1.8-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "29efccda34eec18e1cbd90a1fe3a823e03a28df0f762e7c0cb62ea26669b4602",
                "md5": "e6bfdff7e3ea80f420443baa30ff61f0",
                "sha256": "482dd60285f5c3554a772cab65f518dcffcf9127cbf10a184bec12b2c08c4a02"
            },
            "downloads": -1,
            "filename": "bear_epoch_time-1.1.8.tar.gz",
            "has_sig": false,
            "md5_digest": "e6bfdff7e3ea80f420443baa30ff61f0",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.11",
            "size": 68069,
            "upload_time": "2025-07-23T03:23:43",
            "upload_time_iso_8601": "2025-07-23T03:23:43.402301Z",
            "url": "https://files.pythonhosted.org/packages/29/ef/ccda34eec18e1cbd90a1fe3a823e03a28df0f762e7c0cb62ea26669b4602/bear_epoch_time-1.1.8.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-07-23 03:23:43",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "lcname": "bear-epoch-time"
}
        
Elapsed time: 0.87482s