h SrSSKJr SSKJr SSKJrJrJrJ r SSK J r SSK J r SSKJr SSjrSS jrSS jr\\\\\4\4\ "\5\ "\54r\\\\\4\4\ "\5\ "\5\ "\54r\ SS j5r\ SS j5rSS jr\\\\\4\4\ "\54rSSjrSSjrSSjr\"S\\5rSSSjjr\\\\\4\4\ "\5\ "\"SS55\ "\54r\\\\\4\4\ "\5\ "\"SS554r \\\\\4\4\ "\5\ "\"SS55\ "\54r!\\\\4\ "\"SS55\ "\5\ "\54r"g)aModule containing Pydantic validation utilities for Albumentations. This module provides a collection of validators and utility functions used for validating parameters in the Pydantic models throughout the Albumentations library. It includes functions for ensuring numeric ranges are valid, handling type conversions, and creating standardized validation patterns that are reused across the codebase. ) annotations)Callable) AnnotatedTypeVarUnionoverload)AfterValidator)Numberto_tuplec<USUS::d[SUS35eU$)aEnsure a tuple of two numbers is in non-decreasing order. Args: value (tuple[Number, Number]): Tuple of two numeric values to validate. Returns: tuple[Number, Number]: The original tuple if valid. Raises: ValueError: If the first value is greater than the second value. rz6First value should be less than the second value, got z instead) ValueErrorvalues V/var/www/fran/franai/venv/lib/python3.13/site-packages/albumentations/core/pydantic.py nondecreasingrs1 8uQx QRWQXX`abb Lcp[UbUOSS5n[SU55(d Sn[U5eU$)awProcess and validate a non-negative range. Args: value (tuple[float, float] | float | None): Value to process. Can be: - A tuple of two floats - A single float (converted to symmetric range) - None (defaults to 0) Returns: tuple[float, float]: Validated non-negative range. Raises: ValueError: If any values in the range are negative. rc3*# UH oS:v M g7f)rN).0xs r -process_non_negative_range..7s&v!Avvsz;All values in the non negative range should be non negative)r allr)rresultmsgs rprocess_non_negative_ranger&s< u0ea ;F &v& & &Ko Mrc:[US5[US54$)zConvert a tuple of floats to a tuple of integers. Args: value (tuple[float, float]): Tuple of two float values. Returns: tuple[int, int]: Tuple of two integer values. rr)intrs r float2intr"=s uQx=#eAh- ''rcgNrrs rcreate_symmetric_ranger%XsMPrcgr$rrs rr%r%\sWZrc[U5$)aCreate a symmetric range around zero or use provided range. Args: value (tuple[float, float] | float): Input value, either: - A tuple of two floats (used directly) - A single float (converted to (-value, value)) Returns: tuple[float, float]: Symmetric range. r rs rr%r%`s E?rc[USS9$)zConvert value to a range with lower bound of 1. Args: value (tuple[float, float] | float): Input value. Returns: tuple[float, float]: Range with minimum value of at least 1. rlowr rs rconvert_to_1plus_ranger+r Eq !!rc[USS9$)zConvert value to a range with lower bound of 0. Args: value (tuple[float, float] | float): Input value. Returns: tuple[float, float]: Range with minimum value of at least 0. rr)r rs rconvert_to_0plus_ranger.r,rcB[U[[45(aX4$U$)aConvert a scalar value to a tuple by repeating it, or return the tuple as is. Args: value (tuple[float, float] | float): Input value, either a scalar or tuple. Returns: tuple[float, float]: If input is scalar, returns (value, value), otherwise returns input unchanged. ) isinstancer!floatrs rrepeat_if_scalarr2s!(U|<G%GrTNc$^^^^SUUUU4SjjnU$)aLValidates that all values in a tuple are within specified bounds. Args: min_val (int | float): Minimum allowed value. max_val (int | float | None): Maximum allowed value. If None, only lower bound is checked. min_inclusive (bool): If True, min_val is inclusive (>=). If False, exclusive (>). max_inclusive (bool): If True, max_val is inclusive (<=). If False, exclusive (<). Returns: Callable[[tuple[T, ...] | None], tuple[T, ...] | None]: Validator function that checks if all values in tuple are within bounds. Returns None if input is None. Raises: ValueError: If any value in tuple is outside the allowed range Examples: >>> validator = check_range_bounds(0, 1) # For [0, 1] range >>> validator((0.1, 0.5)) # Valid 2D (0.1, 0.5) >>> validator((0.1, 0.5, 0.7)) # Valid 3D (0.1, 0.5, 0.7) >>> validator((1.1, 0.5)) # Raises ValueError - outside range >>> validator = check_range_bounds(0, 1, max_inclusive=False) # For [0, 1) range >>> validator((0, 1)) # Raises ValueError - 1 not included c b>^^UcgT(aSOSmT(aSOSmTc=[UU 4SjU55(dT(aSOSn[SUS US T 35eU$T(aSOSnT(aS OS n[UUUU 4S jU55(d[SUS US T SUS T3 5eU$)Nc X:$r$rrys r7check_range_bounds..validator..qvrc X:$r$rr7s rr9r:15rc X:*$r$rr7s rr9r:r;rc X:$r$rr7s rr9r:r=rc36># UHnT"UT5v M g7fr$r)rrmin_opmin_vals rr8check_range_bounds..validator..s95ava))5sz>=>zAll values in z must be  z<=# UHnT"UT5=(a T"UT5v M g7fr$r)rrmax_opmax_valrArBs rrrCs'P%Qva)@fQ.@@%s&)z and )rr) r op_symbol min_symbol max_symbolrHrA max_inclusiverI min_inclusiverBs @@r validator%check_range_bounds..validators =*7%>P*7%>P ?95999$1Ds  >% )AgY!WXX: "/CJ!.CJP%PPP >% *QwiW\]g\hhijqir!stt r)rtuple[T, ...] | NonereturnrQr)rBrIrNrMrOs```` rcheck_range_boundsrSsJ$ rr)rtuple[Number, Number]rRrT)rz"tuple[float, float] | float | NonerRtuple[float, float])rrUrRtuple[int, int])rztuple[int, int] | intrRrV)rztuple[float, float] | floatrRrU)NTT) rBr rIz Number | NonerNboolrMrWrRz6Callable[[tuple[T, ...] | None], tuple[T, ...] | None])#__doc__ __future__rcollections.abcrtypingrrrrpydantic.functional_validatorsr $albumentations.core.type_definitionsr albumentations.core.utilsr rrr"tupler1NonNegativeFloatRangeTyper!NonNegativeIntRangeTyper%SymmetricRangeTyper+r.r2r3rSZeroOneRangeTypeOnePlusFloatRangeTypeOnePlusIntRangeType OnePlusIntNonDecreasingRangeTyperrrrgsh#$6697.$. (& %u u $%-.=!# $ %S/3 -.=!9 P P Z Z uU5%<%8%%?@.QgBhhi " " H Ce " 7 7 77 7 < 7t %u u $%)*%a+,=!#" %u u $%)*%a./1   %u u $%)*%a./9$- #s(O%a./=!9$ r