\j RdZddlmZddlmZmZddlmZGddZeZ y) z psycopg capabilities objects ) annotations)_cmodulepq)NotSupportedErrorceZdZdZddZdddZdddZdddZdddZdddZ dddZ ddd Z ddd Z ddd Z dd Zdd ZddZy) Capabilitiesz\ An object to check if a feature is supported by the libpq available on the client. ci|_y)N)_cache)selfs ?/root/env/lib/python3.12/site-packages/psycopg/_capabilities.py__init__zCapabilities.__init__s &( c*|jdd|S)zCheck if the `PGconn.full_protocol_version()` method is implemented. If the method is implemented, then `ConnectionInfo.full_protocol_version` will return a meaningful value. The feature requires libpq 18.0 and greater. z!pq.PGconn.full_protocol_version()i check _has_featurer rs r has_full_protocol_versionz&Capabilities.has_full_protocol_versions#  /u!  rc*|jdd|S)z}Check if the `PGconn.encrypt_password()` method is implemented. The feature requires libpq 10.0 or greater. zpq.PGconn.encrypt_password()irrrs r has_encrypt_passwordz!Capabilities.has_encrypt_password!   !?u UUrc*|jdd|S)z~Check if the `ConnectionInfo.hostaddr` attribute is implemented. The feature requires libpq 12.0 or greater. zConnection.info.hostaddrirrrs r has_hostaddrzCapabilities.has_hostaddr(   !;V5 QQrc*|jdd|S)z}Check if the :ref:`pipeline mode ` is supported. The feature requires libpq 14.0 or greater. zConnection.pipeline()"rrrs r has_pipelinezCapabilities.has_pipeline/s   !8& NNrc*|jdd|S)zCheck if the `pq.PGconn.set_trace_flags()` method is implemented. The feature requires libpq 14.0 or greater. zPGconn.set_trace_flags()rrrrs r has_set_trace_flagsz Capabilities.has_set_trace_flags6rrc*|jdd|S)z|Check if the `pq.PGconn.used_gssapi` attribute is implemented. The feature requires libpq 16.0 or greater. zPGconn.used_gssapiiqrrrs r has_used_gssapizCapabilities.has_used_gssapi=s   !5vU KKrc*|jdd|S)z|Check if the `Connection.cancel_safe()` method is implemented. The feature requires libpq 17.0 or greater. zConnection.cancel_safe()rrrs r has_cancel_safezCapabilities.has_cancel_safeDrrc*|jdd|S)zCheck if `Cursor.stream()` can handle a `size` parameter value greater than 1 to retrieve results by chunks. The feature requires libpq 17.0 or greater. z4Cursor.stream() with 'size' parameter greater than 1r%rrrs r has_stream_chunkedzCapabilities.has_stream_chunkedKs$   BFRW!  rc*|jdd|S)zCheck if the `pq.PGconn.send_closed_prepared()` method is implemented. The feature requires libpq 17.0 or greater. zPGconn.send_close_prepared()r%rrrs r has_send_close_preparedz$Capabilities.has_send_close_preparedUrrc |j|}|sy|r t|y#t$r$|j||}||j|<Y=wxYw)z Check is a version is supported. If `check` is true, raise an exception with an explicative message explaining why the feature is not supported. The expletive messages, are left to the user. TF)r KeyError_get_unsupported_messager)r feature want_versionrmsgs r rzCapabilities._has_feature\s_ '++g&C  #C( ( '//FC#&DKK  's"*AAc tj|krUd|d|jdtjtjdtj|d Stj|krQd|dtj dtjtjdtj|d Sy) z Return a descriptinve message to describe why a feature is unsupported. Return an empty string if the feature is supported. z the feature 'z<' is not available: the client libpq version (imported from z) is z%; the feature requires libpq version z or newerz,' is not available: you are using a psycopg[z)] libpq wrapper built with libpq version )rversion _libpq_sourceversion_pretty__build_version____impl__)r r.r/s r r-z%Capabilities._get_unsupported_messagers ::<, &y)<<@)r.strr/intrr>r<r>)r.r?r/r@r<r?)r<r?)__name__ __module__ __qualname____doc__rrrrrr!r#r&r(r*rr-r4rr r r sO)  VRORLR V,4&rr N) rD __future__rr2rrerrorsrr capabilitiesrErr rIs+ #%E&E&R~ r