*hb%SrSSKJr SSKrSSKrSSKrSSKrSSKJr SSK J r J r J r J r JrJrJrJr SSKJr SSKrSSKrSrS S KJr S S KJr S S KJrJr S S K J!r!J"r"J#r#J$r$J%r% S SK&J'r' \ (aS SK(J)r) \RT"5r+Sr,Sr-\R\"S5r/Sr0\c\O\\4r1S\2S'0r3S\2S'S Sjr4S!Sjr5S"Sjr6S#Sjr7"SS5r8"SS5r9g!\a SrNf=f!\a SrNf=f)$z5Implementing pooling of connections to MySQL servers.) annotationsN) TracebackType) TYPE_CHECKINGAnyDictNoReturnOptionalTupleTypeUnion)uuid4TF)CMySQLConnection)MySQLConnection) CNX_POOL_ARGSDEFAULT_CONFIGURATION)ErrorInterfaceErrorNotSupportedError PoolErrorProgrammingError)read_option_files)MySQLConnectionAbstract @z[^a-zA-Z0-9._:\-*$#]z0MySQL Connector/Python C Extension not availablezUnion[type, Tuple[type, ...]]MYSQL_CNX_CLASSzDict[str, MySQLConnectionPool]_CONNECTION_POOLSPooledMySQLConnectionc SU;aUSO [S 0UD6nURS5SLa[c[[5e[  U[ ;a[S 0UD6[ U'OI[[ U[5(a-[ URnSU;aUSU:wa [S5eSSS5 [ UR5$!,(df  N&=f![a [SUS35Sef=f) z!Return a pooled MySQL connection. pool_nameuse_pureFN pool_sizez)Size can not be changed for active pools.z%Failed getting connection from pool '')generate_pool_namegetr ImportError ERROR_NO_CEXTCONNECTION_POOL_LOCKrMySQLConnectionPool isinstancer"rget_connectionAttributeErrorr)kwargsr check_sizes O/var/www/auris/envauris/lib/python3.13/site-packages/mysql/connector/pooling.py_get_pooled_connectionr1Ps +f4{:L:Vv:Vzz*&+;+C-((  - -+>+H+H i ( ))46I J J*95??Jf$ )< )J KLL  +::<<   3I;a @  sA'C7C CC:c UR5nUSnUS [/SQ5nSnUHn[UR 55U- nU(a5[ U5S:aSOSnS R U5n[S US U35e[US 5(aUS- nURS S 5US 'US S:d US S :a[SUS 35e[US [5(aM[SUS 35e SUs=:a[ U5:aO O [S5e0n /n [USSS9H@nUS U ;aU/XS 'U RUS 5 M*XS RU5 MB U Hn Xn [[ U 55Hzn [ U 5S- n[ R""SU5nU R%U5nUR5nUR'U5 UR%S S5 [)S0UD6s s $ M [S5e![a [S5Sef=f![*a Mf=f)aReturn a MySQL connection and try to failover if needed. An InterfaceError is raise when no MySQL is available. ValueError is raised when the failover server configuration contains an illegal connection argument. Supported arguments are user, password, host, port, unix_socket and database. ValueError is also raised when the failover argument was not provided. Returns MySQLConnection instance. failoverzfailover argument not providedN) userpasswordhostport unix_socketdatabaser r"priorityrrsz, z Unsupported connection argument z in failover: r:dz9Priority value should be in the range of 0 to 100, got : zDPriority value should be an integer in the range of 0 to 100, got : z\You must either assign no priority to any of the routers or give a priority for every routerc US$)Nr:r$xs r0*_get_failover_connection..s:T)keyreversez,Unable to connect to any of the target hostsr$)copyKeyError ValueErrorsetkeyslenjoinhasattrr&rr+intrsortedappendrangerandomrandintpopupdateconnectr)r.configr3support_cnx_argspriority_countserverdiffarglstserver_directoryserver_priority_listr: failover_list_lastindex new_configs r0_get_failover_connectionrems[[]FE*% z  N6;;=!$44 TQ#BC))D/C23%~cUK  6: & & a N#ZZ C8z *  !VJ%7#%=  +,. &,c22 $Z013 %. >)CM)   '>M * %5 54:8 J/ 0 ' 'z(: ; J/ 0 7 7 ? N)(2 s=)*A}%)DNN1d+E"&&u-FJ   f % NN:t , ,,,+) G HHU E9:DEL  sH# H=#H:= I  I c^ST;aTRS5OSn[U[5(d [S5eU(Ga[(d [S5eST;a [S5eST;a [S5eS T;a [S 5eS T;a [ S TS '[ RRTS S 5n/nUHNnURURRSS9URURUR S.5 MP UR#SS9 UVs/sH oUS USS.PM snTS 'ST;aTSTS'TRS5 ST;a[%S0TD6n['S0UD6$S T;a [)S0TD6$[+U4Sj[,55(a [/S0TD6$TR3SS5nST;a TS U(d[4c[7[85e[4(aU(d [5U0TD6$[;U0TD6$![ RRa [S TS S35Sef=fs snf![0a Nf=f)aiCreates or gets a MySQL connection object. In its simpliest form, `connect()` will open a connection to a MySQL server and return a `MySQLConnectionAbstract` subclass object such as `MySQLConnection` or `CMySQLConnection`. When any connection pooling arguments are given, for example `pool_name` or `pool_size`, a pool is created or a previously one is used to return a `PooledMySQLConnection`. Args: *args: N/A. **kwargs: For a complete list of possible arguments, see [1]. If no arguments are given, it uses the already configured or default values. Returns: A `MySQLConnectionAbstract` subclass instance (such as `MySQLConnection` or `CMySQLConnection`) or a `PooledMySQLConnection` instance. Examples: A connection with the MySQL server can be established using either the `mysql.connector.connect()` method or a `MySQLConnectionAbstract` subclass: ``` >>> from mysql.connector import MySQLConnection, HAVE_CEXT >>> >>> cnx1 = mysql.connector.connect(user='joe', database='test') >>> cnx2 = MySQLConnection(user='joe', database='test') >>> >>> cnx3 = None >>> if HAVE_CEXT: >>> from mysql.connector import CMySQLConnection >>> cnx3 = CMySQLConnection(user='joe', database='test') ``` References: [1]: https://dev.mysql.com/doc/connector-python/en/connector-python-connectargs.html dns_srvFz(The value of 'dns-srv' must be a booleanztMySQL host configuration requested DNS SRV. This requires the Python dnspython module. Please refer to documentationr8z. sQz]Qx[L$ArC)rD)r6r7read_default_file option_filesc3,># UH oT;v M g7fNr$).0rDr.s r0 connect..4s6 f} sr!r$)rTr+boolrHAVE_DNSPYTHONrdnsresolverquery exception DNSExceptionrPtargetto_textr7r:rjsortrrVreanyrr1 NameErrorr&rr'r(r)argsr.rg srv_recordsr3srvrdr!s ` r0rVrVsR(1F':fjj#G gt $ $GHH~ 8  F " N  V  M    S   26:F6N ,,,,VF^UCK C OOJJ..d.CHH # !jj    A BBJ BJ3[#f+ 6( z f$!'(;!<~ &'&00 $$$V'1&11 6 6 6 6)3F3 3 7zz*e,HV : ,4m, ,000 D +F ++g}}))  26&>2B!D  " *    s$#H,I(I2I I$#I$c /nSH nUR[X55 M" U(d [S5eSR U5$![a MTf=f)zGenerate a pool name This function takes keyword arguments, usually the connection arguments for MySQLConnection, and tries to generate a name for a pool. Raises PoolError when no name can be generated. Returns a string. )r6r7r4r9z.Failed generating pool name; specify pool_namera)rPstrrGrrL)r.partsrDs r0r%r%Fs^ E3  LLV[) *4 HII 88E?    sA  AAc\rSrSrSrS SjrS SjrSSjrSSjrSSjr \ SSj5r \ SS j5r S rg )ri^alClass holding a MySQL Connection in a pool PooledMySQLConnection is used by MySQLConnectionPool to return an instance holding a MySQL connection. It works like a MySQLConnection except for methods like close() and config(). The close()-method will add the connection back to the pool rather than disconnecting from the MySQL server. Configuring the connection have to be done through the MySQLConnectionPool method set_config(). Using config() on pooled connection will raise a PoolError. Attributes: pool_name (str): Returns the name of the connection pool to which the connection belongs. c[U[5(d [S5e[U[5(d [S5eXlX lg)zxConstructor. Args: pool: A `MySQLConnectionPool` instance. cnx: A `MySQLConnectionAbstract` subclass instance. z$pool should be a MySQLConnectionPoolzcnx should be a MySQLConnectionN)r+r*r-r _cnx_pool_cnx)selfpoolcnxs r0__init__PooledMySQLConnection.__init__qsA$ 344 !GH H#// !BC C.2-0 rCcU$rpr$rs r0 __enter__PooledMySQLConnection.__enter__s rCc$UR5 grp)close)rexc_type exc_value tracebacks r0__exit__PooledMySQLConnection.__exit__s rCc.[URU5$)z0Calls attributes of the MySQLConnection instance)getattrr)rattrs r0 __getattr__!PooledMySQLConnection.__getattr__styy$''rCcURnURR(aUR5 URRU5 SUlg!URRW5 SUlf=f)aDo not close, but adds connection back to pool. For a pooled connection, close() does not actually close it but returns it to the pool and makes it available for subsequent connection requests. If the pool configuration parameters are changed, a returned connection is closed and reopened with the new configuration before being returned from the pool again in response to a connection request. N)rr reset_sessionadd_connectionrrs r0rPooledMySQLConnection.closes_ ))C~~++!!# NN ) )# .DI NN ) )# .DIs 7A$Bc [S5e)zConfiguration is done through the pool. For pooled connections, the `config()` method raises a `PoolError` exception. Configuration for pooled connections should be done using the pool object. zKConfiguration for pooled connections should be done through the pool itself)r)r.s r0rWPooledMySQLConnection.configs   rCc.URR$)zHReturns the name of the connection pool to which the connection belongs.)rr rs r0r PooledMySQLConnection.pool_names~~'''rC)rrN)rr*rrreturnNonerr)rzType[BaseException]r BaseExceptionrrrr)rrrr)rr)r.rrrrr)__name__ __module__ __qualname____firstlineno____doc__rrrrr staticmethodrWpropertyr __static_attributes__r$rCr0rr^sn$ 1%!!   ("    ((rCc\rSrSrSrSSSjjr\SSj5r\SSj5r\SSj5r SSjr SS jr SS jr SS jr SSS jjrSS jrSSjrSrg)r*iz*Class defining a pool of MySQL connectionsNc SUlSUlX0lURU5 UR U=(d [ S0UD65 0Ul[R"UR5Ul [5Ul U(aKUR"S0UD6 SnXPR:a'UR5 US- nXPR:aM&ggg)aConstructor. Initialize a MySQL connection pool with a maximum number of connections set to `pool_size`. The rest of the keywords arguments, kwargs, are configuration arguments for MySQLConnection instances. Args: pool_name: The pool name. If this argument is not given, Connector/Python automatically generates the name, composed from whichever of the host, port, user, and database connection arguments are given in kwargs, in that order. pool_size: The pool size. If this argument is not given, the default is 5. pool_reset_session: Whether to reset session variables when the connection is returned to the pool. **kwargs: Optional additional connection arguments, as described in [1]. Examples: ``` >>> dbconfig = { >>> "database": "test", >>> "user": "joe", >>> } >>> cnxpool = mysql.connector.pooling.MySQLConnectionPool(pool_name = "mypool", >>> pool_size = 3, >>> **dbconfig) ``` References: [1]: https://dev.mysql.com/doc/connector-python/en/connector-python-connectargs.html Nrrr$) _pool_size _pool_name_reset_session_set_pool_size_set_pool_namer% _cnx_configqueueQueue _cnx_queuer _config_version set_configr)rr"r pool_reset_sessionr.cnts r0rMySQLConnectionPool.__init__sL*.)-0 I& IE);)Ef)EF+-@E OOA  %w  OO %f %C'##%q' rCcUR$)z(Returns the name of the connection pool.)rrs r0r MySQLConnectionPool.pool_namerCcUR$)z2Returns number of connections managed by the pool.)rrs r0r"MySQLConnectionPool.pool_sizerrCcUR$)z!Returns whether to reset session.)rrs r0r!MySQLConnectionPool.reset_sessions"""rCc U(dg[ [5nUR"S0UD6 Xl[ 5UlSSS5 g![ an[SU35UeSnAff=f!,(df  g=f)aTSet the connection configuration for `MySQLConnectionAbstract` subclass instances. This method sets the configuration used for creating `MySQLConnectionAbstract` subclass instances such as `MySQLConnection`. See [1] for valid connection arguments. Args: **kwargs: Connection arguments - for a complete list of possible arguments, see [1]. Raises: PoolError: When a connection argument is not valid, missing or not supported by `MySQLConnectionAbstract`. References: [1]: https://dev.mysql.com/doc/connector-python/en/connector-python-connectargs.html Nz$Connection configuration not valid: r$)r)rVrWrr rr-r)rr.test_cnxerrs r0rMySQLConnectionPool.set_configst$  ! W"9)&)#) ',w$ " ! " W"Fse LMSVV W " !s(A-1A  A*A%%A**A-- A;cTUS::d U[:a[S[35eXlg)zSet the size of the pool This method sets the size of the pool but it will not resize the pool. Raises an AttributeError when the pool_size is not valid. Invalid size is 0, negative or higher than pooling.CNX_POOL_MAXSIZE. rz8Pool size should be higher than 0 and lower or equal to N)CNX_POOL_MAXSIZEr-r)rr"s r0r"MySQLConnectionPool._set_pool_sizes5 >Y)99 J#$& $rCc[RU5(a[SUS35e[U5[:a[SUS35eXlg)zSet the name of the pool. This method checks the validity and sets the name of the pool. Raises an AttributeError when pool_name contains illegal characters ([^a-zA-Z0-9._\-*$#]) or is longer than pooling.CNX_POOL_MAXNAMESIZE. z Pool name 'z' contains illegal charactersz ' is too longN)CNX_POOL_NAMEREGEXsearchr-rKCNX_POOL_MAXNAMESIZEr)rr s r0r"MySQLConnectionPool._set_pool_name)sP  $ $Y / / ;yk9V!WX X y>0 0 ;yk!GH H#rCc[U[5(d [S5eURR USS9 g![ R an[S5UeSnAff=f)zPut connection back in the queue This method is putting a connection back in the queue. It will not acquire a lock as the methods using _queue_connection() will have it set. Raises `PoolError` on errors. ;Connection instance not subclass of MySQLConnectionAbstractFblock'Failed adding connection; queue is fullN)r+rrrputrFullrrrs r0_queue_connection%MySQLConnectionPool._queue_connection7sb#//M  P OO  5  1zz PEFC O Ps=A" AA"c0[ UR(d [S5eURR 5(a [S5eU(dh[ S0URD6nUR (a/URS(aURS:a [S5eURUl O [U[5(d [S5eURU5 SSS5 g![a NXf=f!,(df  g=f) aAdds a connection to the pool. This method instantiates a `MySQLConnection` using the configuration passed when initializing the `MySQLConnectionPool` instance or using the `set_config()` method. If cnx is a `MySQLConnection` instance, it will be added to the queue. Args: cnx: The `MySQLConnectionAbstract` subclass object to be added to the pool. If this argument is missing (aka `None`), the pool creates a new connection and adds it. Raises: PoolError: When no configuration is set, when no more connection can be added (maximum reached) or when the connection can not be instantiated. z&Connection configuration not availablercompress)z^Pool reset session is not supported with compression for MySQL server version 5.7.2 or earlierrNr$)r)rrrfullrVrserver_versionrrGrpool_config_versionr+rrrs r0r"MySQLConnectionPool.add_connectionJs&"## HII##%% IJJ1 0 01 ++ ,,Z8..:/)+/*>*>'!#77#U  " "3 '=" !( )" !s2A#D+AC7+AD7 DDDD Dc[ URRSS9nUR 5(aURUR:wa>UR"S0URD6 UR5 URUl[X5sSSS5 $![Ran[ S5UeSnAff=f![a URU5 ef=f!,(df  g=f)aNGets a connection from the pool. This method returns an PooledMySQLConnection instance which has a reference to the pool that created it, and the next available MySQL connection. When the MySQL connection is not connect, a reconnect is attempted. Returns: A `PooledMySQLConnection` instance. Raises: PoolError: On errors. Frz)Failed getting connection; pool exhaustedNr$)r)rr&rEmptyr is_connectedrrrWr reconnectrrrrs r0r,"MySQLConnectionPool.get_connection}s" Voo)))6 $$&&''3+B+BB .T--.MMO +/*>*>'(3'" !;; V KLRUU V&**3/" !sFC+B#A C+.C >C+#C7 CCC+ C((C++ C9cz[ SnURnUR5(a<URSS9nUR 5 US- nUR5(aM<UsSSS5 $![ R a UssSSS5 $[a e[a NXf=f!,(df  g=f)zClose all connections This method closes all connections. It returns the number of connections it closed. Used mostly for tests. Returns int. rFrrN) r)rqsizer& disconnectrrrr)rrcnxqrs r0_remove_connections'MySQLConnectionPool._remove_connectionss"C??D**,, (((/CNN$1HC **,,!" !{{J" !!" !s@$B,$A2B,'B,2B)B,B)&B,(B))B,, B:)rrrrrr)rNT) r"rNr z Optional[str]rrtr.rrrr)rrN)rrt)r.rrr)r"rNrr)r rrr)rrrrrp)rz!Optional[MySQLConnectionAbstract]rrr)rrrrrrrr r"rrrrrrr,rrr$rCr0r*r*s4#'#' 66!6! 6  6  6p##W< $ $P&1(f"4HrCr*)r.rrr)r.rr5Union[PooledMySQLConnection, MySQLConnectionAbstract])rrr.rrr)r.rrr):r __future__rrrRre threadingtypesrtypingrrrrr r r r uuidr dns.exceptionrv dns.resolverrur'connection_cextr connectionr constantsrrerrorsrrrrr optionfilesr abstractsrRLockr)rrcompilerr(r__annotations__rr1rerVr%rr*r$rCr0rsF:<" SSSN1(;+2 (ZZ 78B '/OoGW5X.5716:ZIZI:ZIzy, y,y,:y,x0Q(Q(hIIM Ns#C,C:,C76C7:DD