OǻipddlmZddlmZmZddlmZmZhdZd dZ ddZ ddZ ddZ eGd d Z dd Zy )) annotations) dataclassfield)ListOptional>()[]{}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 O/opt/lhia/marcimex/agent/venv/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!/s w(89rc|d|S)N_v) driver_namedriver_versions r_format_driver_entryr'3s]"^, --rceZdZUdZdZded<dZded<eeZ d ed <d Z e dd Z dd Z e ddZy) 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 (default: "redis-py") lib_version : str, optional The redis-py library version. If None, the version will be determined automatically from the installed package. 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' redis-pystrrN Optional[str] lib_version)default_factory List[str] _upstreamcB|jddlm}||_yy)z'Initialize lib_version if not provided.Nrget_lib_version)r- redis.utilsr3)selfr3s r __post_init__zDriverInfo.__post_init__]s!    # 3.0D  $rc,t|jS)zuReturn a copy of the upstream driver entries. Each entry is in the form ``"driver-name_vversion"``. )listr0r5s rupstream_driverszDriverInfo.upstream_driversdsDNN##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'r0insert)r5r%r&entrys radd_upstream_driverzDriverInfo.add_upstream_driverms]  ;< <  !>? ?k* 0$[.A a' rc|js |jS|jddj|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) r;r )r0rjoinr9s rformatted_namezDriverInfo.formatted_names:~~99 ))Achht~~67q99r)returnr/)r%r+r&r+rCz 'DriverInfo')rCr+)__name__ __module__ __qualname____doc__r__annotations__r-rr8r0r6propertyr:r>rBr$rrr)r)7sw@D#!%K% 6Iy61$$03 * : :rr)cR||Sddlm}||nd}||n|}t||S)aResolve driver_info from parameters. If driver_info is provided, use it. Otherwise, create DriverInfo from lib_name and lib_version (using defaults if not provided). 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 The resolved DriverInfo instance rr2r*)rr-)r4r3r)) driver_infolib_namer-r3rr s rresolve_driver_inforMs=0,+8D(4k/:KG 4W 55rN)rr+rr+rCNone)rr+rCrN)r r+rCrN)r%r+r&r+rCr+)rKzOptional[DriverInfo]rLr,r-r,rCr)) __future__r dataclassesrrtypingrrrrrr!r'r)rMr$rrrRsm"(! (  .:. U:U: U:p 6% 6 6 6 6r