Debian Codegraph @

cron_descriptor/ExpressionValidator.py

raw
1 from __future__ import annotations
2
3 import re
4 from typing import ClassVar
5
6 from cron_descriptor import FormatError
7
8
9 class ExpressionValidator:
10 _cron_days: ClassVar[dict[int, str]] = {
11 0: "SUN",
12 1: "MON",
13 2: "TUE",
14 3: "WED",
15 4: "THU",
16 5: "FRI",
17 6: "SAT",
18 }
19
20 _cron_months: ClassVar[dict[int, str]] = {
21 1: "JAN",
22 2: "FEB",
23 3: "MAR",
24 4: "APR",
25 5: "MAY",
26 6: "JUN",
27 7: "JUL",
28 8: "AUG",
29 9: "SEP",
30 10: "OCT",
31 11: "NOV",
32 12: "DEC",
33 }
34
35 def validate(self, expression: str) -> None:
36 """Parses the cron expression string
37 Returns:
38 A 7 part string array, one part for each component of the cron expression (seconds, minutes, etc.)
39
40 Raises:
41 MissingFieldException: if _expression is empty or None
42 FormatException: if _expression has wrong format
43
44 """
45 # Initialize all elements of parsed array to empty strings
46 parsed = ["", "", "", "", "", "", ""]
47
48
49 expression_parts_temp = expression.split()
50 expression_parts_temp_length = len(expression_parts_temp)
51 if expression_parts_temp_length < 5:
52 msg = f"Error: Expression only has {expression_parts_temp_length} parts. At least 5 part are required."
53 raise FormatError(msg)
54 if expression_parts_temp_length == 5:
55 # 5 part cron so shift array past seconds element
56 for i, expression_part_temp in enumerate(expression_parts_temp):
57 parsed[i + 1] = expression_part_temp
58 elif expression_parts_temp_length == 6:
59 # We will detect if this 6 part expression has a year specified and if so we will shift the parts and treat the
60 # first part as a minute part rather than a second part.
61 # Ways we detect:
62 # 1. Last part is a literal year (i.e. 2020)
63 # 2. 3rd or 5th part is specified as "?" (DOM or DOW)
64 year_regex = re.compile(r"\d{4}$")
65 is_year_with_no_seconds_part = bool(year_regex.search(expression_parts_temp[5])) or "?" in [
66 expression_parts_temp[4], expression_parts_temp[2]]
67 for i, expression_part_temp in enumerate(expression_parts_temp):
68 if is_year_with_no_seconds_part:
69 # Shift parts over by one
70 parsed[i + 1] = expression_part_temp
71 else:
72 parsed[i] = expression_part_temp
73
74 elif expression_parts_temp_length == 7:
75 parsed = expression_parts_temp
76 else:
77 msg = f"Error: Expression has too many parts ({expression_parts_temp_length}). Expression must not have more than 7 parts."
78 raise FormatError(msg)
79
80 self._validate_expression(parsed, expression_parts_temp_length)
81
82 def _validate_expression(self, expression_parts: list[str], expr_length: int) -> None:
83 """Validation for each expression fields
84 Args:
85 expression_parts: expression list
86 expr_length: length of the list
87 """
88
89 """
90 Apply different index for varying length of the expression parts as it is mutated by parse().
91 Does not validate the case for having both DOW,DOM value because it is already causing exception.
92 """
93 if expr_length == 5:
94 self.second_minute(expression_parts[1], "Second and Minute")
95 self.hour(expression_parts[2], "Hour")
96 self.dayofmonth(expression_parts[3], "DayOfMonth")
97 self.month(expression_parts[4], "Month")
98 self.dayofweek(expression_parts[5], "DayOfWeek")
99 elif expr_length == 6:
100 year_regex = re.compile(r"\d{4}$")
101 if year_regex.search(expression_parts[6]) is None:
102 if expression_parts[0]:
103 self.second_minute(expression_parts[0], "Second and Minute")
104 self.second_minute(expression_parts[1], "Second and Minute")
105 self.hour(expression_parts[2], "Hour")
106 self.dayofmonth(expression_parts[3], "DayOfMonth")
107 self.month(expression_parts[4], "Month")
108 self.dayofweek(expression_parts[5], "DayOfWeek")
109 else:
110 self.second_minute(expression_parts[1], "Second and Minute")
111 self.hour(expression_parts[2], "Hour")
112 self.dayofmonth(expression_parts[3], "DayOfMonth")
113 self.month(expression_parts[4], "Month")
114 self.dayofweek(expression_parts[5], "DayOfWeek")
115 self.year(expression_parts[6], "Year")
116 else:
117 if expression_parts[0]:
118 self.second_minute(expression_parts[0], "Second and Minute")
119 self.second_minute(expression_parts[1], "Second and Minute")
120 self.hour(expression_parts[2], "Hour")
121 self.dayofmonth(expression_parts[3], "DayOfMonth")
122 self.month(expression_parts[4], "Month")
123 self.dayofweek(expression_parts[5], "DayOfWeek")
124 if expression_parts[6]:
125 self.year(expression_parts[6], "Year")
126
127 def second_minute(self, expr: str, prefix: str) -> None:
128 """ sec/min expressions (n : Number, s: String)
129 *
130 nn (1~59)
131 nn-nn
132 nn/nn
133 nn-nn/nn
134 */nn
135 nn,nn,nn (Maximum 24 elements)
136 """
137 mi, mx = (0, 59)
138 if re.match(r"\d{1,2}$", expr):
139 self.check_range(expr=expr, mi=mi, mx=mx, prefix=prefix)
140
141 elif re.search(r"[-*,/]", expr):
142 if expr == "*":
143 pass
144
145 elif re.match(r"\d{1,2}-\d{1,2}$", expr):
146 parts = expr.split("-")
147 self.check_range(expr=parts[0], mi=mi, mx=mx, prefix=prefix)
148 self.check_range(expr=parts[1], mi=mi, mx=mx, prefix=prefix)
149 self.compare_range(st=parts[0], ed=parts[1], mi=mi, mx=mx, prefix=prefix)
150
151 elif re.match(r"\d{1,2}/\d{1,2}$", expr):
152 parts = expr.split("/")
153 self.check_range(expr=parts[0], mi=mi, mx=mx, prefix=prefix)
154 self.check_range(type_="interval", expr=parts[1], mi=mi, mx=mx, prefix=prefix)
155
156 elif re.match(r"\d{1,2}-\d{1,2}/\d{1,2}$", expr):
157 parts = expr.split("/")
158 fst_parts = parts[0].split("-")
159 self.check_range(expr=fst_parts[0], mi=mi, mx=mx, prefix=prefix)
160 self.check_range(expr=fst_parts[1], mi=mi, mx=mx, prefix=prefix)
161 self.compare_range(st=fst_parts[0], ed=fst_parts[1], mi=mi, mx=mx, prefix=prefix)
162 self.check_range(type_="interval", expr=parts[1], mi=mi, mx=mx, prefix=prefix)
163
164 elif re.match(r"\*/\d{1,2}$", expr):
165 parts = expr.split("/")
166 self.check_range(type_="interval", expr=parts[1], mi=mi, mx=mx, prefix=prefix)
167
168 elif re.match(r"^(\d{1,2}|\d{1,2}-\d{1,2})(,\d{1,2}|,\d{1,2}-\d{1,2})+$", expr):
169 limit = 60
170 expr_ls = expr.split(",")
171 if len(expr_ls) > limit:
172 msg = f"({prefix}) Exceeded maximum number({limit}) of specified value. '{len(expr_ls)}' is provided"
173 raise FormatError(msg)
174 for n in expr_ls:
175 if "-" in n:
176 parts = n.split("-")
177 self.check_range(expr=parts[0], mi=mi, mx=mx, prefix=prefix)
178 self.check_range(expr=parts[1], mi=mi, mx=mx, prefix=prefix)
179 self.compare_range(st=parts[0], ed=parts[1], mi=mi, mx=mx, prefix=prefix)
180 else:
181 self.check_range(expr=n, mi=mi, mx=mx, prefix=prefix)
182 else:
183 msg = f"({prefix}) Illegal Expression Format '{expr}'"
184 raise FormatError(msg)
185
186 else:
187 msg = f"({prefix}) Illegal Expression Format '{expr}'"
188 raise FormatError(msg)
189
190 def hour(self, expr: str, prefix: str) -> None:
191 """ hour expressions (n : Number, s: String)
192 *
193 nn (1~23)
194 nn-nn
195 nn/nn
196 nn-nn/nn
197 */nn
198 nn,nn,nn (Maximum 24 elements)
199 """
200 mi, mx = (0, 23)
201 if re.match(r"\d{1,2}$", expr):
202 self.check_range(expr=expr, mi=mi, mx=mx, prefix=prefix)
203
204 elif re.search(r"[-*,/]", expr):
205 if expr == "*":
206 pass
207
208 elif re.match(r"\d{1,2}-\d{1,2}$", expr):
209 parts = expr.split("-")
210 self.check_range(expr=parts[0], mi=mi, mx=mx, prefix=prefix)
211 self.check_range(expr=parts[1], mi=mi, mx=mx, prefix=prefix)
212 self.compare_range(st=parts[0], ed=parts[1], mi=mi, mx=mx, prefix=prefix)
213
214 elif re.match(r"\d{1,2}/\d{1,2}$", expr):
215 parts = expr.split("/")
216 self.check_range(expr=parts[0], mi=mi, mx=mx, prefix=prefix)
217 self.check_range(type_="interval", expr=parts[1], mi=mi, mx=mx, prefix=prefix)
218
219 elif re.match(r"\d{1,2}-\d{1,2}/\d{1,2}$", expr):
220 parts = expr.split("/")
221 fst_parts = parts[0].split("-")
222 self.check_range(expr=fst_parts[0], mi=mi, mx=mx, prefix=prefix)
223 self.check_range(expr=fst_parts[1], mi=mi, mx=mx, prefix=prefix)
224 self.compare_range(st=fst_parts[0], ed=fst_parts[1], mi=mi, mx=mx, prefix=prefix)
225 self.check_range(type_="interval", expr=parts[1], mi=mi, mx=mx, prefix=prefix)
226
227 elif re.match(r"\*/\d{1,2}$", expr):
228 parts = expr.split("/")
229 self.check_range(type_="interval", expr=parts[1], mi=mi, mx=mx, prefix=prefix)
230
231 elif re.match(r"^(\d{1,2}|\d{1,2}-\d{1,2})(,\d{1,2}|,\d{1,2}-\d{1,2})+$", expr):
232 limit = 24
233 expr_ls = expr.split(",")
234 if len(expr_ls) > limit:
235 msg = f"({prefix}) Exceeded maximum number({limit}) of specified value. '{len(expr_ls)}' is provided"
236 raise FormatError(msg)
237 for n in expr_ls:
238 if "-" in n:
239 parts = n.split("-")
240 self.check_range(expr=parts[0], mi=mi, mx=mx, prefix=prefix)
241 self.check_range(expr=parts[1], mi=mi, mx=mx, prefix=prefix)
242 self.compare_range(st=parts[0], ed=parts[1], mi=mi, mx=mx, prefix=prefix)
243 else:
244 self.check_range(expr=n, mi=mi, mx=mx, prefix=prefix)
245 else:
246 msg = f"({prefix}) Illegal Expression Format '{expr}'"
247 raise FormatError(msg)
248 else:
249 msg = f"({prefix}) Illegal Expression Format '{expr}'"
250 raise FormatError(msg)
251
252 def dayofmonth(self, expr: str, prefix: str) -> None:
253 """ DAYOfMonth expressions (n : Number, s: String)
254 *
255 ?
256 nn (1~31)
257 nn-nn
258 nn/nn
259 nn-nn/nn
260 */nn
261 nn,nn,nn (Maximum 31 elements)
262 L-nn
263 LW
264 nW
265 """
266 mi, mx = (1, 31)
267 if re.match(r"\d{1,2}$", expr):
268 self.check_range(expr=expr, mi=mi, mx=mx, prefix=prefix)
269 elif re.search(r"[-*,/?]", expr):
270 if expr in ("*", "?"):
271 pass
272
273 elif re.match(r"\d{1,2}-\d{1,2}$", expr):
274 parts = expr.split("-")
275 self.check_range(expr=parts[0], mi=mi, mx=mx, prefix=prefix)
276 self.check_range(expr=parts[1], mi=mi, mx=mx, prefix=prefix)
277 self.compare_range(st=parts[0], ed=parts[1], mi=mi, mx=mx, prefix=prefix)
278
279 elif re.match(r"\d{1,2}/\d{1,2}$", expr):
280 parts = expr.split("/")
281 self.check_range(expr=parts[0], mi=mi, mx=mx, prefix=prefix)
282 self.check_range(type_="interval", expr=parts[1], mi=0, mx=mx, prefix=prefix)
283
284 elif re.match(r"\d{1,2}-\d{1,2}/\d{1,2}$", expr):
285 parts = expr.split("/")
286 fst_parts = parts[0].split("-")
287 self.check_range(expr=fst_parts[0], mi=mi, mx=mx, prefix=prefix)
288 self.check_range(expr=fst_parts[1], mi=mi, mx=mx, prefix=prefix)
289 self.compare_range(st=fst_parts[0], ed=fst_parts[1], mi=mi, mx=mx, prefix=prefix)
290 self.check_range(type_="interval", expr=parts[1], mi=0, mx=mx, prefix=prefix)
291
292 elif re.match(r"\*/\d{1,2}$", expr):
293 parts = expr.split("/")
294 self.check_range(type_="interval", expr=parts[1], mi=0, mx=mx, prefix=prefix)
295
296 elif re.match(r"^\d{1,2}(,\d{1,2})+$", expr):
297 limit = 31
298 expr_ls = expr.split(",")
299 if len(expr_ls) > 31:
300 msg = f"({prefix}) Exceeded maximum number({limit}) of specified value. '{len(expr_ls)}' is provided"
301 raise FormatError(msg)
302 for dayofmonth in expr_ls:
303 self.check_range(expr=dayofmonth, mi=mi, mx=mx, prefix=prefix)
304 elif re.match(r"^([Ll])-(\d{1,2})$", expr):
305 parts = expr.split("-")
306 self.check_range(expr=parts[1], mi=mi, mx=mx, prefix=prefix)
307 else:
308 msg = f"Illegal Expression Format '{expr}'"
309 raise FormatError(msg)
310
311 elif re.match(r"^([Ll])([Ww])?$", expr) or re.match(r"^([Ww])([Ll])?$", expr):
312 pass
313
314 elif re.match(r"^(\d{1,2})([wW])$", expr):
315 self.check_range(expr=expr[:-1], mi=mi, mx=mx, prefix=prefix)
316
317 elif re.match(r"^([wW])(\d{1,2})$", expr):
318 self.check_range(expr=expr[1:], mi=mi, mx=mx, prefix=prefix)
319
320 else:
321 msg = f"({prefix}) Illegal Expression Format '{expr}'"
322 raise FormatError(msg)
323
324 def month(self, expr: str, prefix: str) -> None:
325 """ month expressions (n : Number, s: String)
326 *
327 nn (1~12)
328 sss (JAN~DEC)
329 nn-nn
330 sss-sss
331 nn/nn
332 nn-nn/nn
333 */nn
334 nn,nn,nn,nn-nn,sss-sss (Maximum 12 elements)
335 """
336 mi, mx = (1, 12)
337 if re.match(r"\d{1,2}$", expr):
338 self.check_range(expr=expr, mi=mi, mx=mx, prefix=prefix)
339
340 elif re.match(r"\D{3}$", expr):
341 matched_month = [m for m in self._cron_months.values() if expr == m]
342 if len(matched_month) == 0:
343 msg = f"Invalid Month value '{expr}'"
344 raise FormatError(msg)
345
346 elif re.search(r"[-*,/]", expr):
347 if expr == "*":
348 pass
349
350 elif re.match(r"\d{1,2}-\d{1,2}$", expr):
351 parts = expr.split("-")
352 self.check_range(expr=parts[0], mi=mi, mx=mx, prefix=prefix)
353 self.check_range(expr=parts[1], mi=mi, mx=mx, prefix=prefix)
354 self.compare_range(st=parts[0], ed=parts[1], mi=mi, mx=mx, prefix=prefix)
355
356 elif re.match(r"\D{3}-\D{3}$", expr):
357 parts = expr.split("-")
358 cron_months = {v: k for (k, v) in self._cron_months.items()}
359 st_not_exist = parts[0] not in cron_months
360 ed_not_exist = parts[1] not in cron_months
361 if st_not_exist or ed_not_exist:
362 msg = f"Invalid Month value '{expr}'"
363 raise FormatError(msg)
364 self.compare_range(st=cron_months[parts[0]], ed=cron_months[parts[1]], mi=mi, mx=mx, prefix=prefix)
365
366 elif re.match(r"\d{1,2}/\d{1,2}$", expr):
367 parts = expr.split("/")
368 self.check_range(expr=parts[0], mi=mi, mx=mx, prefix=prefix)
369 self.check_range(type_="interval", expr=parts[1], mi=0, mx=mx, prefix=prefix)
370
371 elif re.match(r"\d{1,2}-\d{1,2}/\d{1,2}$", expr):
372 parts = expr.split("/")
373 fst_parts = parts[0].split("-")
374 self.check_range(expr=fst_parts[0], mi=mi, mx=mx, prefix=prefix)
375 self.check_range(expr=fst_parts[1], mi=mi, mx=mx, prefix=prefix)
376 self.compare_range(st=fst_parts[0], ed=fst_parts[1], mi=mi, mx=mx, prefix=prefix)
377 self.check_range(type_="interval", expr=parts[1], mi=0, mx=12, prefix=prefix)
378
379 elif re.match(r"\*/\d{1,2}$", expr):
380 parts = expr.split("/")
381 self.check_range(type_="interval", expr=parts[1], mi=0, mx=12, prefix=prefix)
382
383 elif re.match(r"^\d{1,2}(,\d{1,2})+$", expr):
384 limit = 12
385 expr_ls = expr.split(",")
386 if len(expr_ls) > limit:
387 msg = f"({prefix}) Exceeded maximum number({limit}) of specified value. '{len(expr_ls)}' is provided"
388 raise FormatError(msg)
389 for month in expr_ls:
390 self.check_range(expr=month, mi=mi, mx=mx, prefix=prefix)
391
392 elif re.match(r"^((\d{1,2}|\D{3})|(\D{3}-\D{3})|(\d{1,2}-\d{1,2}))((,\d{1,2})+"
393 r"|(,\D{3})*|(,\d{1,2}-\d{1,2})*|(,\D{3}-\D{3})*)*$", expr):
394 """
395 1st Capture group : digit{1~2}|nondigit{3}|nondigit{3}-nondigit{3}|digit{3}-digit{3}
396 2nd Capture group : same with 1st capture group but repeated.
397 """
398 limit = 12
399 expr_ls = expr.split(",")
400 if len(expr_ls) > limit:
401 msg = f"({prefix}) Exceeded maximum number({limit}) of specified value. '{len(expr_ls)}' is provided"
402 raise FormatError(msg)
403 cron_months = {v: k for (k, v) in self._cron_months.items()}
404 for month in expr_ls:
405 if "-" in month:
406 parts = month.split("-")
407 if len(parts[0]) == 3:
408 self.check_range(expr=cron_months[parts[0].upper()], mi=mi, mx=mx, prefix=prefix)
409 self.check_range(expr=cron_months[parts[1].upper()], mi=mi, mx=mx, prefix=prefix)
410 else:
411 self.check_range(expr=parts[0], mi=mi, mx=mx, prefix=prefix)
412 self.check_range(expr=parts[1], mi=mi, mx=mx, prefix=prefix)
413 self.compare_range(st=parts[0], ed=parts[1], mi=mi, mx=mx, prefix=prefix)
414 else:
415 cron_month = cron_months[month.upper()] if len(month) == 3 else month
416 self.check_range(expr=cron_month, mi=mi, mx=mx, prefix=prefix)
417 else:
418 msg = f"({prefix}) Illegal Expression Format '{expr}'"
419 raise FormatError(msg)
420 else:
421 msg = f"({prefix}) Illegal Expression Format '{expr}'"
422 raise FormatError(msg)
423
424 def dayofweek(self, expr: str, prefix: str) -> None:
425 """ DAYOfWeek expressions (n : Number, s: String)
426 *
427 ?
428 n (0~7) - 0 and 7 used interchangeable as Sunday
429 sss (SUN~SAT)
430 n/n
431 n-n/n
432 */n
433 n-n
434 sss-sss
435 n|sss,n|sss,n|sss,n-n,sss-sss (maximum 7 elements)
436 nL
437 n#n
438 """
439 mi, mx = (0, 7)
440
441 if expr in ("*", "?"):
442 pass
443
444 elif re.match(r"\d{1}$", expr):
445 self.check_range(expr=expr, mi=mi, mx=mx, prefix=prefix)
446
447 elif re.match(r"\D{3}$", expr):
448 cron_days = {v: k for (k, v) in self._cron_days.items()}
449 if expr.upper() in cron_days:
450 pass
451 else:
452 msg = f"Invalid value '{expr}'"
453 raise FormatError(msg)
454
455 elif re.match(r"\d{1}/\d{1}$", expr):
456 parts = expr.split("/")
457 self.check_range(expr=parts[0], mi=mi, mx=mx, prefix=prefix)
458 self.check_range(type_="interval", expr=parts[1], mi=0, mx=mx, prefix=prefix)
459
460 elif re.match(r"\d{1}-\d{1}/\d{1}$", expr):
461 parts = expr.split("/")
462 fst_parts = parts[0].split("-")
463 self.check_range(expr=fst_parts[0], mi=mi, mx=mx, prefix=prefix)
464 self.check_range(expr=fst_parts[1], mi=mi, mx=mx, prefix=prefix)
465 self.compare_range(st=fst_parts[0], ed=fst_parts[1], mi=mi, mx=mx, prefix=prefix)
466 self.check_range(type_="interval", expr=parts[1], mi=0, mx=mx, prefix=prefix)
467
468 elif re.match(r"[*]/\d{1}$", expr):
469 parts = expr.split("/")
470 self.check_range(type_="interval", expr=parts[1], mi=0, mx=mx, prefix=prefix)
471
472 elif re.match(r"\d{1}-\d{1}$", expr):
473 parts = expr.split("-")
474 self.check_range(expr=parts[0], mi=mi, mx=mx, prefix=prefix)
475 self.check_range(expr=parts[1], mi=mi, mx=mx, prefix=prefix)
476 self.compare_range(st=parts[0], ed=parts[1], mi=mi, mx=mx, prefix=prefix)
477
478 elif re.match(r"\D{3}-\D{3}$", expr):
479 parts = expr.split("-")
480 cron_days = {v: k for (k, v) in self._cron_days.items()}
481 try:
482 st_day = cron_days[parts[0].upper()]
483 ed_day = cron_days[parts[1].upper()]
484 except KeyError as e:
485 msg = f"({prefix}) Invalid value '{expr}'"
486 raise FormatError(msg) from e
487 self.compare_range(st=st_day, ed=ed_day, mi=mi, mx=mx, prefix=prefix, type_="dow")
488
489 elif re.match(r"^((\d{1}|\D{3})|(\D{3}-\D{3})|(\d{1}-\d{1}))"
490 r"((,\d{1})+|(,\D{3})*|(,\d{1}-\d{1})*|(,\D{3}-\D{3})*)*$", expr):
491 limit = 7
492 expr_ls = expr.split(",")
493 if len(expr_ls) > limit:
494 msg = f"({prefix}) Exceeded maximum number({limit}) of specified value. '{len(expr_ls)}' is provided"
495 raise FormatError(msg)
496 cron_days = {v: k for (k, v) in self._cron_days.items()}
497 for day in expr_ls:
498 if "-" in day:
499 parts = day.split("-")
500 if len(parts[0]) == 3:
501 self.check_range(expr=cron_days[parts[0].upper()], mi=mi, mx=mx, prefix=prefix)
502 self.check_range(expr=cron_days[parts[1].upper()], mi=mi, mx=mx, prefix=prefix)
503 else:
504 self.check_range(expr=parts[0], mi=mi, mx=mx, prefix=prefix)
505 self.check_range(expr=parts[1], mi=mi, mx=mx, prefix=prefix)
506 self.compare_range(st=parts[0], ed=parts[1], mi=mi, mx=mx, prefix=prefix)
507 else:
508 # syncronize by add 1 to cron_days index
509 cron_day = cron_days[day.upper()] + 1 if len(day) == 3 else day
510 self.check_range(expr=cron_day, mi=mi, mx=mx, prefix=prefix)
511
512 elif re.match(r"\d{1}([lL])$", expr):
513 parts = expr.upper().split("L")
514 self.check_range(expr=parts[0], mi=mi, mx=mx, prefix=prefix)
515
516 elif re.match(r"\d#\d$", expr):
517 parts = expr.split("#")
518 self.check_range(expr=parts[0], mi=mi, mx=mx, prefix=prefix)
519 self.check_range(expr=parts[1], mi=mi, mx=5, prefix=prefix, type_="dow")
520 elif re.match(r"\D{3}#\d$", expr):
521 parts = expr.split("#")
522 cron_days = {v: k for (k, v) in self._cron_days.items()}
523 try:
524 st_day = cron_days[parts[0].upper()]
525 except KeyError as e:
526 msg = f"({prefix}) Invalid value '{expr}'"
527 raise FormatError(msg) from e
528 self.check_range(expr=parts[1], mi=mi, mx=5, prefix=prefix, type_="dow")
529 else:
530 msg = f"({prefix}) Illegal Expression Format '{expr}'"
531 raise FormatError(msg)
532
533 def year(self, expr: str, prefix: str) -> None:
534 """ Year - valid expression (n : Number)
535 *
536 nnnn(1970~2099) - 4 digits number
537 nnnn-nnnn(1970~2099)
538 nnnn/nnn(0~129)
539 */nnn(0~129)
540 nnnn,nnnn,nnnn(1970~2099) - maximum 86 elements
541 """
542 mi, mx = (1970, 2099)
543 if re.match(r"\d{4}$", expr):
544 self.check_range(expr=expr, mi=mi, mx=mx, prefix=prefix)
545
546 elif re.search(r"[-*,/]", expr):
547
548 if expr == "*":
549 pass
550
551 elif re.match(r"\d{4}-\d{4}$", expr):
552 parts = expr.split("-")
553 self.check_range(expr=parts[0], mi=mi, mx=mx, prefix=prefix)
554 self.check_range(expr=parts[1], mi=mi, mx=mx, prefix=prefix)
555 self.compare_range(st=parts[0], ed=parts[1], mi=mi, mx=mx, prefix=prefix)
556
557 elif re.match(r"\d{4}/\d{1,3}$", expr):
558 parts = expr.split("/")
559 self.check_range(expr=parts[0], mi=mi, mx=mx, prefix=prefix)
560 self.check_range(type_="interval", expr=parts[1], mi=0, mx=129, prefix=prefix)
561
562 elif re.match(r"\d{4}-\d{4}/\d{1,3}$", expr):
563 parts = expr.split("/")
564 fst_parts = parts[0].split("-")
565 self.check_range(expr=fst_parts[0], mi=mi, mx=mx, prefix=prefix)
566 self.check_range(expr=fst_parts[1], mi=mi, mx=mx, prefix=prefix)
567 self.compare_range(st=fst_parts[0], ed=fst_parts[1], mi=mi, mx=mx, prefix=prefix)
568 self.check_range(type_="interval", expr=parts[1], mi=0, mx=129, prefix=prefix)
569
570 elif re.match(r"\*/\d{1,3}$", expr):
571 parts = expr.split("/")
572 self.check_range(type_="interval", expr=parts[1], mi=0, mx=129, prefix=prefix)
573
574 elif re.match(r"\d{1}/\d{1,3}$", expr):
575 parts = expr.split("/")
576 self.check_range(expr=parts[0], mi=0, mx=129, prefix=prefix)
577 self.check_range(type_="interval", expr=parts[1], mi=0, mx=129, prefix=prefix)
578
579 elif re.match(r"^(\d{4}|\d{4}-\d{4})(,\d{4}|,\d{4}-\d{4})+$", expr):
580 limit = 84
581 expr_ls = expr.split(",")
582 if len(expr_ls) > limit:
583 msg = f"({prefix}) Exceeded maximum number({limit}) of specified value. '{len(expr_ls)}' is provided"
584 raise FormatError(msg)
585 for year in expr_ls:
586 if "-" in year:
587 parts = year.split("-")
588 self.check_range(expr=parts[0], mi=mi, mx=mx, prefix=prefix)
589 self.check_range(expr=parts[1], mi=mi, mx=mx, prefix=prefix)
590 self.compare_range(st=parts[0], ed=parts[1], mi=mi, mx=mx, prefix=prefix)
591 else:
592 self.check_range(expr=year, mi=mi, mx=mx, prefix=prefix)
593 else:
594 msg = f"({prefix}) Illegal Expression Format '{expr}'"
595 raise FormatError(msg)
596 else:
597 msg = f"({prefix}) Illegal Expression Format '{expr}'"
598 raise FormatError(msg)
599
600 def check_range(self, prefix: str, mi: int, mx: int, expr: str | int, type_: str| None=None) -> None:
601 """
602 check if expression value within range of specified limit
603 """
604 if int(expr) < mi or mx < int(expr):
605 if type_ is None:
606 msg = f"{prefix} values must be between {mi} and {mx} but '{expr}' is provided"
607 elif type_ == "interval":
608 msg = f"({prefix}) Accepted increment value range is {mi}~{mx} but '{expr}' is provided"
609 elif type_ == "dow":
610 msg = f"({prefix}) Accepted week value is {mi}~{mx} but '{expr}' is provided"
611 else:
612 msg = ""
613 raise FormatError(msg)
614
615 def compare_range(self, prefix: str, st: str | int, ed: str | int, mi:int, mx: int, type_: str | None=None) -> None:
616 """ check 2 expression values size
617 does not allow {st} value to be greater than {ed} value
618 """
619 st_int = int(st)
620 ed_int = int(ed)
621 if st_int > ed_int:
622 if type_ is None:
623 msg = f"({prefix}) Invalid range '{st}-{ed}'. Accepted range is {mi}-{mx}"
624 elif type_ == "dow":
625 msg = f"({prefix}) Invalid range '{self._cron_days[st_int]}-{self._cron_days[ed_int]}'. Accepted range is {mi}-{mx}"
626 else:
627 msg = ""
628 raise FormatError(msg)