No project description provided
Project description
TimelineOMat
This project allows to streamline events in timelines. Streamlining is here to fill to adjust the event start and stop times so it fits into the gaps of the timeline and to emit an Exception if this is not possible. The timeline should be filled with the events with higher priority first and then descend in priority.
Installation
pip install timelineomat
Usage
see Code
from dataclasses import dataclass
from datetime import datetime as dt
from timelineomat import TimelineOMat, streamline_event_times, stream_line_event, NewTimesResult
@dataclass
class Event:
start: dt
stop: dt
timeline = [Event(start=dt(2024, 1, 1), stop=dt(2024, 1, 2)), Event(start=dt(2024, 1, 2), stop=dt(2024, 1, 3))]
new_event = Event(start=dt(2024, 1, 1), stop=dt(2024, 1, 4))
# one time methods
# get intermediate result of new times
streamline_event_times(new_event, timeline) == NewTimesResult(start=dt(2024, 1, 3), stop=dt(2024, 1, 4))
# update the event
timeline.append(streamline_event(new_event, timeline))
tm = TimelineOMat()
# use method instead
tm.streamline_event_times(Event(start=dt(2024, 1, 1), stop=dt(2024, 1, )), timeline) == NewTimesResult(start=dt(2024, 1, 4), stop=dt(2024, 1, 5))
Tricks to integrate in different datastructures
TimelineOMat supports out of the box all kind of dicts as well as objects. It determinates if an object is a dict and uses otherwise getattr and setattr. It even supports timelines with mixed types.
The easiest way to integrate Events in TimelineOMat with different names than start and stop is to provide
the names for start_extractor
and stop_extractor
.
When providing strings the string names are mirrored to the arguments:
start_setter
and stop_setter
. No need to set them explicitly.
Data types of start, stop
the output format is always datetime but the input is flexible. Datetimes are nearly passed through (naive datetimes can get a timezone set, more info later)
Int as well as float are also supported. In this case datetime.fromtimestamp is used.
In case of strings fromisodatestring is used.
Optional fallback timezones
All of TimelineOMat, streamline_event_times and streamline_event support an argument: fallback_timezone
If set the timezone is used in case a naive datetime is encountered (in case of int, float, the timezone is always set).
Supported are the regular timezones of python (timezone.utc or ZoneInfo).
TimelineOMat one-time overwrites
Given the code
from dataclasses import dataclass
from datetime import datetime as dt
from timelineomat import TimelineOMat
@dataclass
class Event:
start: dt
stop: dt
timeline = [Event(start=dt(2024, 1, 1), stop=dt(2024, 1, 2)), Event(start=dt(2024, 1, 2), stop=dt(2024, 1, 3))]
new_event1 = Event(start=dt(2024, 1, 1), stop=dt(2024, 1, 4))
new_event2 = dict(start=dt(2024, 1, 1), end=dt(2024, 1, 5))
it is possible to extract the data with
def one_time_overwrite_end(ev):
if isinstance(ev, dict):
return ev["end"]
else:
return ev.stop
tm = TimelineOMat()
timeline.append(tm.streamline_event(new_event1, timeline))
#
timeline.append(Event(**tm.streamline_event_times(new_event2, timeline, stop_extractor=one_time_overwrite_end)._asdict()))
Tricks to improve the performance:
Using TimelineOMat
In case of the one time methods the extractors and setters are generated all the time when using string extractors or setters -> bad performance
Building an TimelineOMat is more efficient or alternatively provide functions for extractors and setters
Only the last element (sorted timelines)
For handling unsorted timelines TimelineOMat iterates through all events all the time. In case of an ordered timeline the performance can be improved by using only the last element:
from dataclasses import dataclass
from datetime import datetime as dt
from timelineomat import TimelineOMat
@dataclass
class Event:
start: dt
stop: dt
ordered_timeline = [Event(start=dt(2024, 1, 1), stop=dt(2024, 1, 2)), Event(start=dt(2024, 1, 2), stop=dt(2024, 1, 3))]
new_event = Event(start=dt(2024, 1, 1), stop=dt(2024, 1, 4))
# here we generate the setters and extractors only onetime
tm = TimelineOMat()
tm.streamline_event_times(new_event, ordered_timeline[-1:])
#
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for timelineomat-0.2.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | a15074357f6a0fc080911dc86437158d731171eb39d7814a561848665f85676d |
|
MD5 | 0cac2036bb4c319216898c2d0bd7fcdb |
|
BLAKE2b-256 | 1088363425b1752bd456cb9c0457ac6f7e6dc5075278fccb53d2492d71d74a47 |