Metadata-Version: 2.4
Name: bear-epoch-time
Version: 1.1.4
Summary: Elegant epoch timestamp handling with timezone-aware operations, fluent API, and smart defaults for Python developers who hate datetime complexity.
Author-email: chaz <bright.lid5647@fastmail.com>
Requires-Python: >=3.11
Requires-Dist: python-dateutil>=2.9.0.post0
Requires-Dist: pytz>=2025.2
Requires-Dist: rich>=14.0.0
Requires-Dist: tzlocal>=5.3.1
Description-Content-Type: text/markdown

# 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.
