o $i%@sddlZddlZddlmZmZmZmZmZdedeefddZ dedee dee fd d Z ed Z hd Z d eddfddZ  d(d edee dee deee gefdeedee f ddZd edeedeefddZd edeedeefddZd edeedeefddZd edee dee fddZd edee dee fddZd edee dee fd d!Zd edeedeefd"d#Zd ededefd$d%Zd eddfd&d'ZdS))N)CallableListOptionalTypeTypeVarsreturncCsdddd|dDDS)z`Return a list from a comma-separated string. Trims whitespace and skips empty entries. cSsg|]}|r|qSr .0partr r _/home/ubuntu/veenaModal/venv/lib/python3.10/site-packages/ray/serve/_private/constants_utils.py szstr_to_list..css|]}|VqdS)N)stripr r r r zstr_to_list..,)split)rr r r str_to_listsr bucket_strdefault_bucketsc Cs|dkr|Sz,dd|dD}|stdtdd|Dr&tdtt||kr2td |WStyM}z td |d t||d }~ww) a}Parse a comma-separated string of latency bucket values. Args: bucket_str: A comma-separated string of positive numbers in ascending order. default_buckets: Default bucket values to use if bucket_str is empty. Returns: A list of parsed float values. Raises: ValueError: If the format is invalid or values don't meet requirements. cSsg|]}t|qSr )floatrr xr r r rsz)parse_latency_buckets..rzEmpty bucket listcss|]}|dkVqdS)rNr rr r r r#rz(parse_latency_buckets..zBucket values must be positivez1Bucket values must be in strictly ascending orderzInvalid format for `zH`. Expected comma-separated positive numbers in ascending order. Error: N)rr ValueErroranysortedset Exceptionstr)rrbucketser r r parse_latency_bucketss* r#T>MAX_CACHED_HANDLESCONTROLLER_MAX_CONCURRENCYREQUEST_LATENCY_BUCKETS_MSMAX_PER_REPLICA_RETRY_COUNTMODEL_LOAD_LATENCY_BUCKETS_MS"SERVE_REQUEST_PROCESSING_TIMEOUT_S&MAX_DEPLOYMENT_CONSTRUCTOR_RETRY_COUNTnamecCs4d}||s|tvr dStd|d|ddS)z-Validate Ray Serve environment variable name. RAY_SERVE_Nz*Got unexpected environment variable name `z3`! Ray Serve environment variables require prefix `z`. ) startswith_wrong_names_white_listr)r,required_prefixr r r _validate_name>s r1default value_typevalidation_funcexpected_value_descriptionc Cst|tj|}|dur|durdS|}nt||}z||}Wnty?}ztd|d|d|jd|d}~ww|rX||sXtd|d|d|d |jd |S) aGet environment variable with type conversion and validation. This function retrieves an environment variable, converts it to the specified type, and optionally validates the converted value. Args: name: The name of the environment variable. default: Default value to use if the environment variable is not set. If None, the function will return None without validation. value_type: Type to convert the environment variable value to (e.g., int, float, str). validation_func: Optional function that takes the converted value and returns a boolean indicating whether the value is valid. expected_value_description: Description of the expected value characteristics (e.g., "positive", "non-negative") used in error messages. Optional, expected only if validation_func is provided. Returns: The environment variable value converted to the specified type and validated, or the default value if the environment variable is not set. Raises: ValueError: If the environment variable value cannot be converted to the specified type, or if it fails the optional validation check. Also, if name validation fails. NzEnvironment variable `z ` value `z` cannot be converted to `z`!zGot unexpected value `z` for `z!` environment variable! Expected z `z`.)r1osenvironget_deprecation_warningr__name__) r,r2r3r4r5explicitly_defined_valuerawvaluer"r r r _get_env_valueLs6   r>cC t||tS)aNGet environment variable as an integer. Args: name: The name of the environment variable. default: Default value to use if the environment variable is not set. Returns: The environment variable value as an integer. Raises: ValueError: If the value cannot be converted to an integer. r>intr,r2r r r get_env_int rCcCt||tdddS)aqGet environment variable as a positive integer. Args: name: The name of the environment variable. default: Default value to use if the environment variable is not set. Returns: The environment variable value as a positive integer. Raises: ValueError: If the value cannot be converted to an integer or is not positive. cS|dkSNrr rr r r z&get_env_int_positive..positiver@rBr r r get_env_int_positive rLcCrE)auGet environment variable as a non-negative integer. Args: name: The name of the environment variable. default: Default value to use if the environment variable is not set. Returns: The environment variable value as a non-negative integer. Raises: ValueError: If the value cannot be converted to an integer or is negative. cS|dkSrGr rHr r r rIrJz*get_env_int_non_negative.. non negativer@rBr r r get_env_int_non_negativerMrPcCr?)aEGet environment variable as a float. Args: name: The name of the environment variable. default: Default value to use if the environment variable is not set. Returns: The environment variable value as a float. Raises: ValueError: If the value cannot be converted to a float. r>rrBr r r get_env_floatrDrRcCrE)ajGet environment variable as a positive float. Args: name: The name of the environment variable. default: Default value to use if the environment variable is not set. Returns: The environment variable value as a positive float. Raises: ValueError: If the value cannot be converted to a float or is not positive. cSrFrGr rHr r r rIrJz(get_env_float_positive..rKrQrBr r r get_env_float_positiverMrScCrE)anGet environment variable as a non-negative float. Args: name: The name of the environment variable. default: Default value to use if the environment variable is not set. Returns: The environment variable value as a non-negative float. Raises: ValueError: If the value cannot be converted to a float or is negative. cSrNrGr rHr r r rIrJz,get_env_float_non_negative..rOrQrBr r r get_env_float_non_negativerMrTcCr?)a:Get environment variable as a string. Args: name: The name of the environment variable. default: Default value to use if the environment variable is not set. Returns: The environment variable value as a string. Returns `None` if default is `None` and value not found. r>r rBr r r get_env_strs rVcCst||t}|dkS)aGet environment variable as a boolean. Environment variable values of "1" are interpreted as True, all others as False. Args: name: The name of the environment variable. default: Default value to use if the environment variable is not set. Expects "0" or "1". Returns: True if the environment variable value is "1", False otherwise. 1rU)r,r2 env_value_strr r r get_env_bools rYcsbdtdtffdd }d}d|tvs|dkr/||}tjd|d |d |d td d dSdS)zLog replacement warning for wrong or legacy environment variables. TODO: remove this function for the '3.0.0' release. :param name: environment variable name r,rcs$|dkrdS|dkr dS|S)N'RAY_SERVE_HANDLE_METRIC_PUSH_INTERVAL_S3RAY_SERVE_HANDLE_AUTOSCALING_METRIC_PUSH_INTERVAL_Sr*&RAY_SERVE_REQUEST_PROCESSING_TIMEOUT_Sr )r,r0r r get_new_names  z*_deprecation_warning..get_new_namez3.0.0r-rZzStarting from version `z` environment variable `z"` will be deprecated. Please use `z ` instead.) stacklevelN)r r/warningswarn FutureWarning)r,r^change_versionnew_namer r]r r9s  r9)NN)r6ratypingrrrrrr rrr#r$r/r1boolr>rArCrLrPrRrSrTrVrYr9r r r r s@"  ;