| 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) |