-
Notifications
You must be signed in to change notification settings - Fork 0
/
date_range.py
111 lines (86 loc) · 3.72 KB
/
date_range.py
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
from __future__ import annotations
import datetime as dt
import operator
from collections.abc import Iterator
from typing import override
from attrs import Attribute, field, frozen
from dateutil.relativedelta import relativedelta
def _date_set_day_one(date: dt.date) -> dt.date:
return date.replace(day=1)
def _relativedelta_normalize(delta: relativedelta) -> relativedelta:
return delta.normalized()
@frozen
class DayRange:
"""Produces a sequence of `datetime.date` objects for every calendar day from `start` (inclusive) to `stop` (inclusive) by `step`."""
start: dt.date
stop: dt.date
step: dt.timedelta = field(default=dt.timedelta(days=1))
@step.validator # pyright: ignore[reportAttributeAccessIssue, reportUntypedFunctionDecorator, reportUnknownMemberType]
def _check_step(self, attr: Attribute[dt.timedelta], value: dt.timedelta) -> None:
if not value:
raise ValueError(f"`{attr.name}` must not be zero")
elif value % dt.timedelta(days=1):
raise ValueError(
f"`{attr.name}` must be a `dt.timedelta` object with only integer `weeks` and `days` values"
)
def __bool__(self) -> bool:
try:
next(iter(self))
except StopIteration:
return False
else:
return True
def __contains__(self, key: object) -> bool:
return isinstance(key, dt.date) and (self.start <= key <= self.stop or self.start >= key >= self.stop)
def __iter__(self) -> Iterator[dt.date]:
increasing = self.step > dt.timedelta()
comp = operator.le if increasing else operator.ge
if not comp(self.start, self.stop):
return
yield (date := self.start)
while comp((date := date + self.step), self.stop):
yield date
@override
def __str__(self) -> str:
return f"{self.start:%Y/%m/%d)}-{self.stop:%Y/%m/%d)}"
@frozen
class MonthRange:
"""Produces a sequence of `datetime.date` objects for every calendar month from `start` (inclusive) to `stop` (inclusive) by `step`.
Each `datetime.date` object is set to the 1st day of the month.
"""
start: dt.date = field(converter=_date_set_day_one)
stop: dt.date = field(converter=_date_set_day_one)
step: relativedelta = field(default=relativedelta(months=+1), converter=_relativedelta_normalize)
@step.validator # pyright: ignore[reportAttributeAccessIssue, reportUntypedFunctionDecorator, reportUnknownMemberType]
def _check_step(self, attr: Attribute[relativedelta], value: relativedelta) -> None:
if not value:
raise ValueError(f"`{attr.name}` must not be zero")
elif value != relativedelta(years=value.years, months=value.months):
raise ValueError(f"`{attr.name}` must be a `relativedelta` object with only `years` and `months` values")
def __bool__(self) -> bool:
try:
next(iter(self))
except StopIteration:
return False
else:
return True
def __contains__(self, key: object) -> bool:
return (
isinstance(key, dt.date)
and (self.start <= key <= self.stop or self.start >= key >= self.stop)
and key.day == 1
)
def __iter__(self) -> Iterator[dt.date]:
increasing = self.step.years * 12 + self.step.months > 0
comp = operator.le if increasing else operator.ge
if not comp(self.start, self.stop):
return
date = self.start
assert date.day == 1
yield date
while comp((date := date + self.step), self.stop):
assert date.day == 1
yield date
@override
def __str__(self) -> str:
return f"{self.start:%Y/%m)}-{self.stop:%Y/%m)}"