Skip to content

validators

validate_time_period(period=None)

Validate a time period string.

Description:

Pass a time period (i.e. "days", "weeks", etc). If the period matches a valid time period, string is returned, otherwise a ValueError is raised.

Source code in src/red_utils/ext/time_utils/arrow_utils/validators.py 
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
def validate_time_period(period: str = None) -> str:
    """Validate a time period string.

    Description:
    ------------
    Pass a time period (i.e. "days", "weeks", etc). If the period
    matches a valid time period, string is returned, otherwise a
    ValueError is raised.
    """
    if period is None:
        raise ValueError("Missing a time period to evaluate")
    if not isinstance(period, str):
        raise TypeError(
            f"Invalid type for time period: ({type(period)}). Must be one of {VALID_TIME_PERIODS}"
        )
    if period not in VALID_TIME_PERIODS:
        raise ValueError(
            f"Invalid time period: '{period}'. Must be one of {VALID_TIME_PERIODS}"
        )

    return period