o Lj@sddlmZddlmZmZddlmZmZddlm Z hdZ d"d d Z d#ddZ d$ddZ d%ddZeGdddZe e e fd&dd Zd!S)') annotations) dataclassfield)ListOptional)SENTINEL>{}()[]valuestr field_namereturnNonecCs<|D]}t|dkst|dks|tvrt|dqdS)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)rrchrO/home/djax/ivt_ai_plugin/venv/lib/python3.10/site-packages/redis/driver_info.py_validate_no_invalid_chars s rnamecCs*ddl}t|d|d|stddS)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)rrrrr_validate_driver_names  rversioncCst|ddS)NzDriver version)r)r rrr_validate_driver_version1r! driver_namedriver_versioncCs|d|S)N_vr)r#r$rrr_format_driver_entry5r"r&c@sjeZdZUdZeZded<eZded<ee dZ ded<dd Z e dd d Z dddZe dddZdS) 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] _upstreamcCs6|jturd|_|jturddlm}||_dSdS)z7Initialize default metadata if not explicitly provided.zredis-pyr)get_lib_versionN)rrr) redis.utilsr-)selfr-rrr __post_init__`s    zDriverInfo.__post_init__rcCs t|jS)zuReturn a copy of the upstream driver entries. Each entry is in the form ``"driver-name_vversion"``. )listr,)r/rrrupstream_driversis zDriverInfo.upstream_driversr#rr$ 'DriverInfo'cCsL|durtd|durtdt|t|t||}|jd||S)zAdd an upstream driver to this instance and return self. The most recently added driver appears first in :pyattr:`formatted_name`. NzDriver name must not be NonezDriver version must not be Noner)rrr!r&r,insert)r/r#r$entryrrradd_upstream_driverrs zDriverInfo.add_upstream_driver Optional[str]cCs:|j}t|tr |s dS|js|S|dd|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 isinstancerr,join)r/rrrrformatted_names  zDriverInfo.formatted_nameN)rr+)r#rr$rrr3)rr7)__name__ __module__ __qualname____doc__rr__annotations__r)rr1r,r0propertyr2r6r;rrrrr'9s  !   r' driver_infoOptional[DriverInfo] | objectlib_namer(r)Optional[DriverInfo]cCsF|tur|dur|durdSt||dS|dust|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'r9 TypeError)rBrDr)rrrresolve_driver_infos rGN)rrrrrr)rrrr)r rrr)r#rr$rrr)rBrCrDr(r)r(rrE) __future__r dataclassesrrtypingrrr.rrrrr!r&r'rGrrrrs      _