Metadata-Version: 2.1
Name: emitime
Version: 0.2.12
Summary: UNKNOWN
Home-page: https://github.com/rilshok/emitime
Author: Vladislav A. Proskurov
Author-email: rilshok@pm.me
License: MIT
Platform: UNKNOWN
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE

# emiTime

The __emiTime__ library is designed to simplify the work with objects describing calendar time points and intervals between them.
All algorithms presented in the library are based on two entities `Moment` and `Inerval`.
Each of them can be fired from anything that looks like a calendar time point or a time interval.

## Installation

```
pip install emitime
```

Or from GitHub

```
git clone https://github.com/rilshok/emitime.git
cd emitime
pip install -e .
```

## Usage

A `Moment` object can be created by a `str`, datetime module objects such as `date` and `datetime`, or another `Moment`.
In turn, `Interval` can also be derived from a `str`, `datetime.time` or another `Interval`.

```python
import datetime as dt

from emitime import Moment

d1 = Moment("1970-01-01")
d2 = Moment(dt.datetime(1970, 1, 1))
d3 = Moment(dt.date(1970, 1, 1))
d4 = Moment(d3)

print(f"{d1=}, {d2=}, {d3=}, {d4=}")
print(f"{d1 == d2 == d3 == d4 = }")
```
```
d1=1970-01-01, d2=1970-01-01, d3=1970-01-01, d4=1970-01-01
d1 == d2 == d3 == d4 = True
```

```python
import datetime as dt

from emitime import Interval

t1 = Interval("2d")
t2 = Interval("12:00")
t3 = Interval(dt.timedelta(hours=5))
t4 = Interval(t3)

print(f"{t1=}, {t2=}, {t3=}, {t4=}")
print(f"{t1 > t2 > t3 >= t4 = }")
```
```
t1=+2^00:00, t2=+12:00, t3=+05:00, t4=+05:00
t1 > t2 > t3 >= t4 = True
```

`Moment` and `Interval` can participate in natural mathematical operations and be compared with each other.
Also, whenever possible, depending on the context, __emiTime__ promotes the type of one of the operands of the operation to `Moment` or `Interval`

```python
import datetime as dt

from emitime import Interval, Moment

m1 = Moment("1970-01-01") + "2d"
m2 = dt.timedelta(hours=5) + Moment("01.01.1970")
m3 = "1970-01-01" + Interval("12:00")

i1 = Moment("2020-01-01") - "2019-01-01"
i2 = "12:00" - Interval("1d")
i3 = dt.date(2021, 1, 1) - Moment("2020-01-01")

print(f"{m1=}, {m2=}, {m3=}")
print(f"{i1=}, {i2=}, {i3=}")
print(f"{m1 > m2=}")
print(f"{m2 < m3 <= m1 =}")
print(f"{m3+i2 == m1 - i3+i1 - i3+i1 = }")
```
```
m1=1970-01-03, m2=1970-01-01d05:00, m3=1970-01-01d12:00
i1=+365^00:00, i2=-12:00, i3=+366^00:00
m1 > m2=True
m2 < m3 <= m1 =True
m3+i2 == m1 - i3+i1 - i3+i1 = True
```

`Moment` is based on the standard `datetime.datetime` and `Interval` is based on `datetime.timedelta`. Which can be accessed as follows.

```python
from emitime import Interval, Moment

m = Moment("1970-01-01")
i = Interval("02:10")
mdt = m.datetime
itd = i.timedelta

print(f"{mdt = }")
print(f"{itd = }")
```
```
mdt = datetime.datetime(1970, 1, 1, 0, 0)
itd = datetime.timedelta(seconds=7800)
```


---
Emit and enjoy.


