o c_3 @sddlZddlZddlZddlZddlZddlZddlZddlmZddl m Z m Z ddl m Z mZmZmZmZddlmZddlmZddlmZdd lmZmZmZmZmZmZdd lmZmZzddl Z d Z!Wn e"ywdZ d Z!Ynwz ddl#Z#e#$Z%[#Wn e"e&fydZ%Ynwd Z'ej(ej)ej*ej+ej,ej-ej.ej/ej0h Z1d Z2dZ3ddZ4ddZ5GdddZ6GdddZ7GdddZ8dS)N)_auth)charset_by_name charset_by_id)CLIENTCOMMANDCR FIELD_TYPE SERVER_STATUS) converters)Cursor)Parser) dump_packet MysqlPacketFieldDescriptorPacketOKPacketWrapperEOFPacketWrapperLoadLocalPacketWrapper)errVERSION_STRINGTFutf8mb4cCstd|ddS)Nd?Z%dbd@dAZ&dBdCZ'e(fdDdEZ)dFdGZ*dHdIZ+dcdJdKZ,dLdMZ-dNdOZ.dPdQZ/dRdSZ0dTdUZ1dVdWZ2dXdYZ3dZd[Z4d\d]Z5d^d_Z6d`daZ7e8j9Z9e8j:Z:e8j;Z;e8jZ>e8j?Z?e8j@Z@e8jAZAe8jBZBdS)e ConnectionaP Representation of a socket with a mysql server. The proper way to get an instance of this class is to call connect(). Establish a connection to the MySQL database. Accepts several arguments: :param host: Host where the database server is located :param user: Username to log in as :param password: Password to use. :param database: Database to use, None to not use a particular one. :param port: MySQL port to use, default is usually OK. (default: 3306) :param bind_address: When the client has multiple network interfaces, specify the interface from which to connect to the host. Argument can be a hostname or an IP address. :param unix_socket: Optionally, you can use a unix socket rather than TCP/IP. :param read_timeout: The timeout for reading from the connection in seconds (default: None - no timeout) :param write_timeout: The timeout for writing to the connection in seconds (default: None - no timeout) :param charset: Charset you want to use. :param sql_mode: Default SQL_MODE to use. :param read_default_file: Specifies my.cnf file to read these parameters from under the [client] section. :param conv: Conversion dictionary to use instead of the default one. This is used to provide custom marshalling and unmarshalling of types. See converters. :param use_unicode: Whether or not to default to unicode strings. This option defaults to true. :param client_flag: Custom flags to send to MySQL. Find potential values in constants.CLIENT. :param cursorclass: Custom cursor class to use. :param init_command: Initial SQL statement to run when connection is established. :param connect_timeout: Timeout before throwing an exception when connecting. (default: 10, min: 1, max: 31536000) :param ssl: A dict of arguments similar to mysql_ssl_set()'s parameters. :param ssl_ca: Path to the file that contains a PEM-formatted CA certificate :param ssl_cert: Path to the file that contains a PEM-formatted client certificate :param ssl_disabled: A boolean value that disables usage of TLS :param ssl_key: Path to the file that contains a PEM-formatted private key for the client certificate :param ssl_verify_cert: Set to true to check the validity of server certificates :param ssl_verify_identity: Set to true to check the server's identity :param read_default_group: Group to read from in the configuration file. :param autocommit: Autocommit mode. None means use server default. (default: False) :param local_infile: Boolean to enable the use of LOAD DATA LOCAL command. (default: False) :param max_allowed_packet: Max size of packet sent to server in bytes. (default: 16MB) Only used to limit size of "LOAD LOCAL INFILE" data packet smaller than default (16KB). :param defer_connect: Don't explicitly connect on construction - wait for connect call. (default: False) :param auth_plugin_map: A dict of plugin names to a class that processes that plugin. The class will take the Connection object as the argument to the constructor. The class needs an authenticate method taking an authentication packet as an argument. For the dialog plugin, a prompt(echo, prompt) method can be used (if no authenticate method) for returning a string from the user. (experimental) :param server_public_key: SHA256 authentication plugin public key value. (default: None) :param binary_prefix: Add _binary prefix on bytes and bytearray. (default: False) :param compress: Not supported :param named_pipe: Not supported :param db: **DEPRECATED** Alias for database. :param passwd: **DEPRECATED** Alias for password. See `Connection `_ in the specification. NFrT r#)&userpasswordhostdatabase unix_socketportcharsetsql_moderead_default_fileconv use_unicode client_flag cursorclass init_commandconnect_timeoutread_default_group autocommit local_infilemax_allowed_packet defer_connectauth_plugin_map read_timeout write_timeout bind_address binary_prefix program_nameserver_public_keysslssl_cassl_cert ssl_disabledssl_keyssl_verify_certssl_verify_identitycompress named_pipepasswddbc&*s|&dur |dur |&}|%dur|s|%}|#s|$rtdt||_|jr'| tjO} r6| s6tjdr4d} nd} | rsd'|_?|r||j?d(<|rd|_@dS|AdS))Nz3compress and named_pipe arguments are not supportedwinz c:\my.iniz /etc/my.cnfclientcs.|r|Sz|WSty|YSwN)get Exception)keyargcfgr<rr_configs z$Connection.__init__.._configr-r.r/r0socketr2z bind-addresszdefault-character-set)cacapathcertrXcipherzssl-F)r^check_hostname verify_moder`rXzssl module not foundT localhosti zport should be of type intlatin1ri3z+connect_timeout should be >0 and <=31536000zread_timeout should be > 0zwrite_timeout should be > 0z Not connectedcSs"i|] \}}t|tur||qSrtypeint.0kvrrr L"z'Connection.__init__..cSs"i|] \}}t|tur||qSrrgrjrrrrnMropymysql) _client_name_pid_client_versionrF)BNotImplementedErrorbool _local_infiler LOCAL_FILESsysplatform startswithr readospath expanduserri isinstancedictrVrH SSL_ENABLEDSSL_create_ssl_ctxctxr/r2rhr& DEFAULT_USERr-r.strencoderRr1rDr; _read_timeout_write_timeoutDEFAULT_CHARSETr3r7rencoding CAPABILITIESCONNECT_WITH_DBr8r9_result_affected_rows host_infoautocommit_moder conversionsitemsencodersdecodersr4r:r?_auth_plugin_map_binary_prefixrGgetpidr_connect_attrs_sockconnect)*selfr-r.r/r0r1r2r3r4r5r6r7r8r9r:r;r<r=r>r?r@rArBrCrDrErFrGrHrIrJrKrLrMrNrOrPrQrRr\rXvaluerrZr__init__s*                            zConnection.__init__cCs|SrUrrrrr __enter__cszConnection.__enter__cGs~|dSrU)close)rexc_inforrr__exit__fs zConnection.__exit__cCsNt|tjr|S|d}|d}|duo|du}tj||d}| o)|dd|_|d}|dur>|r9tjntj|_n`_ in the specification. :raise Error: If the connection is already closed. Already closedTN`_ in the specification. COMMITNrrrrrcommit zConnection.commitcCr)z Roll back the current transaction. See `Connection.rollback() `_ in the specification. ROLLBACKNrrrrrrollbackrzConnection.rollbackcCs$|tjdt|}||jS)z%Send the "SHOW WARNINGS" SQL command.z SHOW WARNINGS)rrr MySQLResultr{rows)rresultrrr show_warningsszConnection.show_warningscCs|tj||dS)zI Set current db. :param db: The name of the db. N)rr COM_INIT_DBr)rrRrrr select_dbs zConnection.select_dbcCsXt|trd||dSt|ttfr#||}|jr!d|}|Stj||j |dS)z}Escape whatever value you pass to it. Non-standard, for internal use; do not use this in your applications. '_binary)mapping) rr escape_stringr' bytearray _quote_bytesrr escape_itemr3)robjrretrrrrs  zConnection.escapecCs|||jS)zjAlias for escape() Non-standard, for internal use; do not use this in your applications. )rr)rrrrrliteralszConnection.literalcCs"|jtj@r |ddSt|S)Nrz'')rr "SERVER_STATUS_NO_BACKSLASH_ESCAPESreplacer rrsrrrrs   zConnection.escape_stringcCs0|jtj@rd|ddddfSt|S)Nz'%s''s''asciisurrogateescape)rr rrdecoder escape_bytesrrrrr s  zConnection._quote_bytescCs|r||S||S)a  Create a new cursor to execute queries with. :param cursor: The type of cursor to create; one of :py:class:`Cursor`, :py:class:`SSCursor`, :py:class:`DictCursor`, or :py:class:`SSDictCursor`. None means use Cursor. )r9)rcursorrrrrs zConnection.cursorcCs:t|tr ||jd}|tj||j|d|_|jS)Nr unbuffered) rrrrrrr_read_query_resultr)rsqlrrrrquerys zConnection.querycCs|j|d|_|jS)Nr)rr)rrrrr next_result'szConnection.next_resultcC|jSrU)rrrrr affected_rows+zConnection.affected_rowscCs"td|}|tj||S)Nr)rrrrCOM_PROCESS_KILLr)r thread_idrYrrrkill.s zConnection.killcCsp|jdur|r|d}ntdz|tjd|WdSty7|r6|| dYdSw)z Check if the server is alive. :param reconnect: If the connection is closed, reconnect. :raise Error: If the connection is closed and reconnect=False. NFrr+) rrrrrrCOM_PINGrrWping)r reconnectrrrr3s   zConnection.pingcCs:t|j}|tjd|||||_||_dS)Nz SET NAMES %s)rrrrrrrr3)rr3rrrr set_charsetJs  zConnection.set_charsetc CsDd|_z|dur|jr,ttjtj}||j||jd|_d|_ t r+t dn]i}|j dur:|j df|d< ztj |j|jf|jfi|}Wnttfyg}z |jtjkrbWYd}~q:d}~wwd|j|jf|_t rwt d|tjtjd |tjtjd |d||_|d |_d|_|||jdur| }|!d |jf|j"dur| }|!|j"|#|$|j%dur|&|j%WdSWdSt'y!}z:d|_|durz|#WnYt(|tttj)frt*+d d |j|f}||_,t-.|_-t rt |j-|d}~ww)NFzLocalhost via UNIX socketTzconnected using unix_socketrsource_addressz socket %s:%dzconnected using socketrrbzSET sql_mode=%siz(Can't connect to MySQL server on %r (%s))/rr1r]AF_UNIX SOCK_STREAM settimeoutr;rr_secureDEBUGprintrDcreate_connectionr/r2OSErrorIOErrorerrnoEINTR setsockopt IPPROTO_TCP TCP_NODELAY SOL_SOCKET SO_KEEPALIVErmakefiler _next_seq_id_get_server_information_request_authenticationr4rexecuter:rrrr= BaseExceptionrerrorrroriginal_exception traceback format_exc)rsockkwargsecexcrrrrSs              zConnection.connectcCsFtt|t|jg|}trt||||jdd|_dS)zvWrites an entire "mysql packet" in its entirety to the network adding its length and sequence number. rN)rlenr'rrrr)rpayloaddatarrr write_packets  zConnection.write_packetc Cst} |d}td|\}}}||d>}||jkr6||dkr,ttj dt d||jf|jdd |_||}t rIt |||7}|d krRq|t krWnq|t||j} | rw|jd urs|jjdursd |j_| | S) a!Read an entire "mysql packet" in its entirety from the network and return a MysqlPacket type that represents the results. :raise OperationalError: If the connection to the MySQL server is lost. :raise InternalError: If the packet sequence number is wrong. Tz|jdkrd}|j rt"rt#dt$|j |j!}n%t"rt#dn|jdkrd}|jr|jtj@r|j d }n|j rd}nd }|jtj%@r|t&t'||7}n|jtj(@r|tdt'||7}n||d 7}|j)r|jtj*@rt |j)t r |j) |j|_)||j)d 7}|jtj+@r#||pdd 7}|jtj,@red}|j-.D]'\}}| d}|tdt'||7}| d}|tdt'||7}q1|tdt'||7}|||/} | 0rt"rzt#d| 1| 2}|jtj+@r|dur|3|| } nAt4|j |j!d }|||/} n-| 5rt"rt#d|jdkrt6|| } n|jdkrt7|| } nt89d|jt"rt#ddSdS)N.rrzDid not specify a usernamezs                         z"Connection._request_authenticationc Cs||}|r'z||WSty&|dkr$tdd|t|fYnw|dkr1t||S|dkr;t||S|dkrIt |j | }n|dkrWt |j | }n|dkrgt |j | d }n|d krq|j d }n|dkr|} |}|d @d k}|d@dk}| } | dkr||j d nA|rd} z||| } || d Wn-tytdd||ftytdd||| | fwtdd||f|}||s|r |Sqxtdd||||}||S)Nsdialog zGAuthentication plugin '%s' not loaded: - %r missing authenticate methodr[r]rYsclient_ed25519smysql_old_passwordrWsmysql_clear_passwordTrs Password: z3no response - TypeError within plugin.prompt methodzAAuthentication plugin '%s' not loaded: - %r missing prompt methodi zTAuthentication plugin '%s' %r didn't respond with string. Returned '%r' to prompt %rz.Authentication plugin '%s' (%r) not configuredz)Authentication plugin '%s' not configured)_get_auth_plugin_handler authenticateAttributeErrorrrrhrrurvrhr.read_alled25519_passwordrsrpr.prompt TypeErrorr check_errorr) rrzr|handlerr-rflagecholastrresprrrrrs              ' zConnection._process_authc Csj|j|}|st|tr|j|d}|r1z||}W|Sty0tdd||fwd}|S)Nrr}zXAuthentication plugin '%s' not loaded: - %r cannot be constructed with connection object)rrVrr'rrrr)rrz plugin_classrrrrrs"   z#Connection._get_auth_plugin_handlercCs |jdSrI)server_thread_idrrrrrs zConnection.thread_idcCrrU)r3rrrrcharacter_set_namerzConnection.character_set_namecCrrU)rrrrr get_host_inforzConnection.get_host_infocCrrU)protocol_versionrrrrget_proto_inforzConnection.get_proto_infoc Csd}|}|}|||_|d7}|d|}|||d|_|d}td|||d|_|d7}|||d|_ |d7}td |||d d|_ |d 7}t ||d krtd |||d \}}}}|d 7}||_ zt |j|_Wn tyd|_Ynw||_trtd ||j |d>O_ trtd|td|d}|d7}t |||kr|j ||||7_ ||7}|d7}|j tj@rt ||kr|d|}|dkr||dd|_dS|||d|_dSdSdS)NrrrWrfrr/ r"rr~zRead a column descriptor packet for each column in the result.?Nrz DEBUG: field=z , converter=zProtocol error, expecting EOF)fieldsr rHr7rrangerrrrr type_coder JSON TEXT_TYPES charsetnrrrVthroughrrrr) rr7 conn_encodingrr(field field_typerr eof_packetrrrrs8      zMySQLResult._get_descriptionsN)rrrrrr{rGrrrrrrNrrrrrrrrms     rc@seZdZddZddZdS)rcCs||_||_dSrU)rrH)rrrHrrrr?s zLoadLocalFile.__init__c Cs|jjs tdd|j}zHz-t|jd}t|jd} ||}|s%n| |qWdn1s5wYWnt yMt dd|jd wW| d dS| d w) z3Send data packets from the local file to the serverrr+r i@TNizCan't find file 'rre) rHrrrKrrrPr?r{r.rr)rconn open_filerRchunkrrrrCs,    zLoadLocalFile.send_dataN)rrrrrrrrrr>s r)9rr|r]rrxr#rLr+rr3rr constantsrrrr r r cursorsr optionfiler protocolrrrrrrrrrHr ImportErrorgetpassgetuserrrrBITBLOB LONG_BLOB MEDIUM_BLOBSTRING TINY_BLOB VAR_STRINGVARCHARGEOMETRYrrr6rr)r*rrrrrrsp       R