o "4gQ@sLdZddlmZddlmZddlmZddlmZGdddZeZ d S) z psycopg capabilities objects ) annotations)pq)_cmodule)NotSupportedErrorc@seZdZdZd"ddZd#d$d d Zd#d$d d Zd#d$d dZd#d$ddZd#d$ddZ d#d$ddZ d#d$ddZ d%ddZ d&ddZ d'dd Zd!S)( Capabilitiesz\ An object to check if a feature is supported by the libpq available on the client. returnNonecCs i|_dS)N)_cache)selfr ^/var/www/html/authentication-server/venv/lib/python3.10/site-packages/psycopg/_capabilities.py__init__s zCapabilities.__init__FcheckboolcC|jdd|dS)z~Check if the `PGconn.encrypt_password()` method is implemented. The feature requires libpq 10.0 and greater. zpq.PGconn.encrypt_password()ir _has_featurer rr r r has_encrypt_passwordz!Capabilities.has_encrypt_passwordcCr)zCheck if the `ConnectionInfo.hostaddr` attribute is implemented. The feature requires libpq 12.0 and greater. zConnection.info.hostaddrirrrr r r has_hostaddrrzCapabilities.has_hostaddrcCr)z~Check if the :ref:`pipeline mode ` is supported. The feature requires libpq 14.0 and greater. zConnection.pipeline()"rrrr r r has_pipeline$rzCapabilities.has_pipelinecCr)zCheck if the `pq.PGconn.set_trace_flags()` method is implemented. The feature requires libpq 14.0 and greater. zPGconn.set_trace_flags()rrrrr r r has_set_trace_flags+rz Capabilities.has_set_trace_flagscCr)z}Check if the `Connection.cancel_safe()` method is implemented. The feature requires libpq 17.0 and greater. zConnection.cancel_safe()rrrr r r has_cancel_safe2rzCapabilities.has_cancel_safecCr)zCheck if `Cursor.stream()` can handle a `size` parameter value greater than 1 to retrieve results by chunks. The feature requires libpq 17.0 and greater. z4Cursor.stream() with 'size' parameter greater than 1rrrrr r r has_stream_chunked9szCapabilities.has_stream_chunkedcCr)zCheck if the `pq.PGconn.send_closed_prepared()` method is implemented. The feature requires libpq 17.0 and greater. zPGconn.send_close_prepared()rrrrr r r has_send_close_preparedCrz$Capabilities.has_send_close_preparedfeaturestr want_versionintcCsD||jvr |j|}n |||}||j|<|sdS|r t|dS)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 _get_unsupported_messager)r r r"rmsgr r r rJs   zCapabilities._has_featurec Cszt|krd|d|dttdt|d Stj|kr;d|dtjdttjdt|d SdS) 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"r r r r$`s&    z%Capabilities._get_unsupported_messagecCs"tjdkrtjp d}d|SdS)z5Return a string reporting where the libpq comes from.binaryunknownz$the psycopg[binary] package version zsystem libraries)rr+r __version__)r r'r r r r(zs   zCapabilities._libpq_sourceN)rr )F)rrrr)r r!r"r#rrrr)r r!r"r#rr!)rr!)__name__ __module__ __qualname____doc__rrrrrrrrrr$r(r r r r rs         rN) r2 __future__rr&rrerrorsrr capabilitiesr r r r s     v