AHjddlmZddlmZmZddlmZmZddlm Z hdZ ddZ ddZ ddZ dd ZeGd d Ze e e f dd Zy )) annotations) dataclassfield)ListOptional)SENTINEL>()[]{}cv|D]4}t|dkst|dkDs |tvs(t|dy)zEnsure value contains only printable ASCII without spaces or braces. This mirrors the constraints enforced by other Redis clients for values that will appear in CLIENT LIST / CLIENT INFO output. !~zG must not contain spaces, newlines, non-printable characters, or bracesN)ord_BRACES ValueError)value field_namechs I/root/tools/cai/cai_env/lib/python3.12/site-packages/redis/driver_info.py_validate_no_invalid_charsr sF r7T>SWt^rW},ef c^ddl}t|d|jd|s tdy)aoValidate an upstream driver name. The name should look like a typical Python distribution or package name, following a simplified form of PEP 503 normalisation rules: * start with a lowercase ASCII letter * contain only lowercase letters, digits, hyphens and underscores Examples of valid names: ``"django-redis"``, ``"celery"``, ``"rq"``. rNz Driver namez^[a-z][a-z0-9_-]*$zUpstream driver name must use a Python package-style name: start with a lowercase letter and contain only lowercase letters, digits, hyphens, and underscores (e.g., 'django-redis').)rermatchr)namers r_validate_driver_namers8t]3 88)4 0 G   1rct|dy)NzDriver version)r)versions r_validate_driver_versionr"1s w(89rc|d|S)N_v) driver_namedriver_versions r_format_driver_entryr(5s]"^, --rceZdZUdZeZded<eZded<ee Z ded<dZ e d d Z dd Ze dd Zy ) DriverInfoaDriver information used to build the CLIENT SETINFO LIB-NAME and LIB-VER values. This class consolidates all driver metadata (redis-py version and upstream drivers) into a single object that is propagated through connection pools and connections. The formatted name follows the pattern:: name(driver1_vVersion1;driver2_vVersion2) Parameters ---------- name : str, optional The base library name. If omitted, defaults to "redis-py". If None, LIB-NAME will not be sent. lib_version : str, optional The redis-py library version. If omitted, the version will be determined automatically from the installed package. If None, LIB-VER will not be sent. Examples -------- >>> info = DriverInfo() >>> info.formatted_name 'redis-py' >>> info = DriverInfo().add_upstream_driver("django-redis", "5.4.0") >>> info.formatted_name 'redis-py(django-redis_v5.4.0)' >>> info = DriverInfo(lib_version="5.0.0") >>> info.lib_version '5.0.0' Optional[str] | objectr lib_version)default_factory List[str] _upstreamc|jturd|_|jturddlm}||_yy)z7Initialize default metadata if not explicitly provided.zredis-pyr)get_lib_versionN)rrr, redis.utilsr1)selfr1s r __post_init__zDriverInfo.__post_init__`s6 99 "DI   x ' 3.0D  (rc,t|jS)zuReturn a copy of the upstream driver entries. Each entry is in the form ``"driver-name_vversion"``. )listr/)r3s rupstream_driverszDriverInfo.upstream_driversisDNN##rc| td| tdt|t|t||}|jj d||S)zAdd an upstream driver to this instance and return self. The most recently added driver appears first in :pyattr:`formatted_name`. zDriver name must not be NonezDriver version must not be Noner)rrr"r(r/insert)r3r&r'entrys radd_upstream_driverzDriverInfo.add_upstream_driverrs]  ;< <  !>? ?k* 0$[.A a' rc|j}t|tr|sy|js|S|ddj |jdS)zReturn the base name with upstream drivers encoded, if any. With no upstream drivers, this is just :pyattr:`name`. Otherwise:: name(driver1_vX;driver2_vY) Nr ;r )r isinstancestrr/join)r3rs rformatted_namezDriverInfo.formatted_namesIyy$$D~~Kq$..12!44rN)returnr.)r&r?r'r?rBz 'DriverInfo')rBz Optional[str])__name__ __module__ __qualname____doc__rr__annotations__r,rr6r/r4propertyr7r;rAr%rrr*r*9syB$,D +*2K'2 6Iy61$$03 * 5 5rr*ct|tur||yt||S|t|tr|Std)a%Resolve driver_info from parameters. If driver_info is provided, use it. Otherwise, create DriverInfo from lib_name and lib_version (using defaults only for sentinel values). Parameters ---------- driver_info : DriverInfo, optional The DriverInfo instance to use lib_name : str, optional The library name (default: "redis-py") lib_version : str, optional The library version (default: auto-detected) Returns ------- DriverInfo, optional The resolved DriverInfo instance N)rr,z1driver_info must be a DriverInfo instance or None)rr*r> TypeError) driver_infolib_namer,s rresolve_driver_inforMsH0h   3x[AAjjA G HHrN)rr?rr?rBNone)rr?rBrN)r!r?rBrN)r&r?r'r?rBr?)rKzOptional[DriverInfo] | objectrLr+r,r+rBzOptional[DriverInfo]) __future__r dataclassesrrtypingrrr2rrrrr"r(r*rMr%rrrRs"(! (  .:. [5[5 [5~2:'/*2 I. I$ I( I Ir