]>
Commit | Line | Data |
---|---|---|
2244b271 DM |
1 | package PVE::CalendarEvent; |
2 | ||
3 | use strict; | |
4 | use warnings; | |
5 | use Data::Dumper; | |
6 | use Time::Local; | |
55c6e2cd | 7 | use PVE::JSONSchema; |
a5ffa49f | 8 | use PVE::Tools qw(trim); |
2244b271 DM |
9 | |
10 | # Note: This class implements a parser/utils for systemd like calender exents | |
11 | # Date specification is currently not implemented | |
12 | ||
13 | my $dow_names = { | |
14 | sun => 0, | |
15 | mon => 1, | |
16 | tue => 2, | |
17 | wed => 3, | |
18 | thu => 4, | |
19 | fri => 5, | |
20 | sat => 6, | |
21 | }; | |
22 | ||
55c6e2cd DM |
23 | PVE::JSONSchema::register_format('pve-calendar-event', \&pve_verify_calendar_event); |
24 | sub pve_verify_calendar_event { | |
25 | my ($text, $noerr) = @_; | |
26 | ||
27 | eval { parse_calendar_event($text); }; | |
28 | if (my $err = $@) { | |
29 | return undef if $noerr; | |
05477bfe | 30 | die "invalid calendar event '$text' - $err\n"; |
55c6e2cd DM |
31 | } |
32 | return $text; | |
33 | } | |
34 | ||
2244b271 DM |
35 | # The parser. |
36 | # returns a $calspec hash which can be passed to compute_next_event() | |
37 | sub parse_calendar_event { | |
38 | my ($event) = @_; | |
39 | ||
a5ffa49f DC |
40 | $event = trim($event); |
41 | ||
42 | if ($event eq '') { | |
43 | die "unable to parse calendar event - event is empty\n"; | |
44 | } | |
45 | ||
2244b271 DM |
46 | my $parse_single_timespec = sub { |
47 | my ($p, $max, $matchall_ref, $res_hash) = @_; | |
48 | ||
49 | if ($p =~ m/^((?:\*|[0-9]+))(?:\/([1-9][0-9]*))?$/) { | |
50 | my ($start, $repetition) = ($1, $2); | |
51 | if (defined($repetition)) { | |
52 | $repetition = int($repetition); | |
53 | $start = $start eq '*' ? 0 : int($start); | |
54 | die "value '$start' out of range\n" if $start >= $max; | |
55 | die "repetition '$repetition' out of range\n" if $repetition >= $max; | |
56 | while ($start < $max) { | |
57 | $res_hash->{$start} = 1; | |
58 | $start += $repetition; | |
59 | } | |
60 | } else { | |
61 | if ($start eq '*') { | |
62 | $$matchall_ref = 1; | |
63 | } else { | |
64 | $start = int($start); | |
057c619a | 65 | die "value '$start' out of range\n" if $start >= $max; |
2244b271 DM |
66 | $res_hash->{$start} = 1; |
67 | } | |
68 | } | |
69 | } elsif ($p =~ m/^([0-9]+)\.\.([1-9][0-9]*)$/) { | |
70 | my ($start, $end) = (int($1), int($2)); | |
71 | die "range start '$start' out of range\n" if $start >= $max; | |
72 | die "range end '$end' out of range\n" if $end >= $max || $end < $start; | |
73 | for (my $i = $start; $i <= $end; $i++) { | |
74 | $res_hash->{$i} = 1; | |
75 | } | |
76 | } else { | |
77 | die "unable to parse calendar event '$p'\n"; | |
78 | } | |
79 | }; | |
80 | ||
81 | my $h = undef; | |
82 | my $m = undef; | |
83 | ||
84 | my $matchall_minutes = 0; | |
85 | my $matchall_hours = 0; | |
86 | my $minutes_hash = {}; | |
87 | my $hours_hash = {}; | |
88 | ||
89 | my $dowsel = join('|', keys %$dow_names); | |
90 | ||
91 | my $dow_hash; | |
92 | ||
93 | my $parse_dowspec = sub { | |
94 | my ($p) = @_; | |
95 | ||
96 | if ($p =~ m/^($dowsel)$/i) { | |
97 | $dow_hash->{$dow_names->{lc($1)}} = 1; | |
98 | } elsif ($p =~ m/^($dowsel)\.\.($dowsel)$/i) { | |
99 | my $start = $dow_names->{lc($1)}; | |
100 | my $end = $dow_names->{lc($2)} || 7; | |
101 | die "wrong order in range '$p'\n" if $end < $start; | |
102 | for (my $i = $start; $i <= $end; $i++) { | |
103 | $dow_hash->{($i % 7)} = 1; | |
104 | } | |
105 | } else { | |
106 | die "unable to parse weekday specification '$p'\n"; | |
107 | } | |
108 | }; | |
109 | ||
110 | my @parts = split(/\s+/, $event); | |
111 | ||
112 | if ($parts[0] =~ m/$dowsel/i) { | |
113 | my $dow_spec = shift @parts; | |
114 | foreach my $p (split(',', $dow_spec)) { | |
115 | $parse_dowspec->($p); | |
116 | } | |
117 | } else { | |
118 | $dow_hash = { 0 => 1, 1 => 1, 2 => 1, 3 => 1, 4 => 1, 5=> 1, 6 => 1 }; | |
119 | } | |
120 | ||
121 | if (scalar(@parts) && $parts[0] =~ m/\-/) { | |
122 | my $date_spec = shift @parts; | |
123 | die "date specification not implemented"; | |
124 | } | |
125 | ||
126 | my $time_spec = shift(@parts) // "00:00"; | |
127 | my $chars = '[0-9*/.,]'; | |
128 | ||
129 | if ($time_spec =~ m/^($chars+):($chars+)$/) { | |
130 | my ($p1, $p2) = ($1, $2); | |
e2c29de7 DC |
131 | foreach my $p (split(',', $p1)) { |
132 | $parse_single_timespec->($p, 24, \$matchall_hours, $hours_hash); | |
133 | } | |
134 | foreach my $p (split(',', $p2)) { | |
135 | $parse_single_timespec->($p, 60, \$matchall_minutes, $minutes_hash); | |
136 | } | |
2244b271 DM |
137 | } elsif ($time_spec =~ m/^($chars)+$/) { # minutes only |
138 | $matchall_hours = 1; | |
139 | foreach my $p (split(',', $time_spec)) { | |
140 | $parse_single_timespec->($p, 60, \$matchall_minutes, $minutes_hash); | |
141 | } | |
142 | ||
143 | } else { | |
144 | die "unable to parse calendar event\n"; | |
145 | } | |
146 | ||
147 | die "unable to parse calendar event - unused parts\n" if scalar(@parts); | |
148 | ||
149 | if ($matchall_hours) { | |
150 | $h = '*'; | |
151 | } else { | |
a4200306 | 152 | $h = [ sort { $a <=> $b } keys %$hours_hash ]; |
2244b271 DM |
153 | } |
154 | ||
155 | if ($matchall_minutes) { | |
156 | $m = '*'; | |
157 | } else { | |
a4200306 | 158 | $m = [ sort { $a <=> $b } keys %$minutes_hash ]; |
2244b271 DM |
159 | } |
160 | ||
161 | return { h => $h, m => $m, dow => [ sort keys %$dow_hash ]}; | |
162 | } | |
163 | ||
164 | sub compute_next_event { | |
165 | my ($calspec, $last, $utc) = @_; | |
166 | ||
167 | my $hspec = $calspec->{h}; | |
168 | my $mspec = $calspec->{m}; | |
169 | my $dowspec = $calspec->{dow}; | |
170 | ||
171 | $last += 60; # at least one minute later | |
172 | ||
173 | while (1) { | |
174 | ||
175 | my ($min, $hour, $mday, $mon, $year, $wday); | |
176 | my $startofday; | |
177 | ||
178 | if ($utc) { | |
179 | (undef, $min, $hour, $mday, $mon, $year, $wday) = gmtime($last); | |
180 | $startofday = timegm(0, 0, 0, $mday, $mon, $year); | |
181 | } else { | |
182 | (undef, $min, $hour, $mday, $mon, $year, $wday) = localtime($last); | |
183 | $startofday = timelocal(0, 0, 0, $mday, $mon, $year); | |
184 | } | |
185 | ||
186 | $last = $startofday + $hour*3600 + $min*60; | |
187 | ||
188 | my $check_dow = sub { | |
189 | foreach my $d (@$dowspec) { | |
190 | return $last if $d == $wday; | |
191 | if ($d > $wday) { | |
192 | return $startofday + ($d-$wday)*86400; | |
193 | } | |
194 | } | |
195 | return $startofday + (7-$wday)*86400; # start of next week | |
196 | }; | |
197 | ||
198 | if ((my $next = $check_dow->()) != $last) { | |
199 | $last = $next; | |
200 | next; # repeat | |
201 | } | |
202 | ||
203 | my $check_hour = sub { | |
204 | return $last if $hspec eq '*'; | |
205 | foreach my $h (@$hspec) { | |
206 | return $last if $h == $hour; | |
207 | if ($h > $hour) { | |
208 | return $startofday + $h*3600; | |
209 | } | |
210 | } | |
211 | return $startofday + 24*3600; # test next day | |
212 | }; | |
213 | ||
214 | if ((my $next = $check_hour->()) != $last) { | |
215 | $last = $next; | |
216 | next; # repeat | |
217 | } | |
218 | ||
219 | my $check_minute = sub { | |
220 | return $last if $mspec eq '*'; | |
221 | foreach my $m (@$mspec) { | |
222 | return $last if $m == $min; | |
223 | if ($m > $min) { | |
224 | return $startofday +$hour*3600 + $m*60; | |
225 | } | |
226 | } | |
227 | return $startofday + ($hour + 1)*3600; # test next hour | |
228 | }; | |
229 | ||
230 | if ((my $next = $check_minute->()) != $last) { | |
231 | $last = $next; | |
232 | next; # repeat | |
233 | } else { | |
234 | return $last; | |
235 | } | |
236 | } | |
237 | ||
238 | die "unable to compute next calendar event\n"; | |
239 | } | |
240 | ||
241 | 1; |