U d>H@srdZddlZddlmZmZddlmZmZmZddlm Z m Z m Z GdddZ d/d d Z Gd d d ZGd ddZGddde ZGddde ZGddde ZGddde ZGdddeZeeeeeeddddZeeeeddddZeeeed d!d"dZeed#ed$d%d&dZeed'ed(d)d*dZeed+ed,d-d.dZedS)0z1Implementation of the Range type and adaptation N)ProgrammingErrorInterfaceError) ISQLQuoteadaptregister_adapter)new_typenew_array_type register_typec@seZdZdZdZd0ddZdd Zd d Zed d Z eddZ eddZ eddZ eddZ eddZeddZddZddZddZd d!Zd"d#Zd$d%Zd&d'Zd(d)Zd*d+Zd,d-Zd.d/ZdS)1RangeaPython representation for a PostgreSQL |range|_ type. :param lower: lower bound for the range. `!None` means unbound :param upper: upper bound for the range. `!None` means unbound :param bounds: one of the literal strings ``()``, ``[)``, ``(]``, ``[]``, representing whether the lower or upper bounds are included :param empty: if `!True`, the range is empty _lower_upper_boundsN[)FcCsD|s.|dkrtd|||_||_||_nd|_|_|_dS)N)rz(]z()z[]zbound flags not valid: ) ValueErrorr r r)selflowerupperboundsemptyr3/tmp/pip-unpacked-wheel-pzk59f4e/psycopg2/_range.py__init__/szRange.__init__cCs6|jdkr|jjdSd|jj|j|j|jSdS)Nz (empty=True)z{}({!r}, {!r}, {!r}))r __class____name__formatr r rrrr__repr__:s  zRange.__repr__cCs>|jdkrdS|jdt|jdt|j|jdg}d|S)Nrrz, )rstrr r join)ritemsrrr__str__As z Range.__str__cCs|jS)z:The lower bound of the range. `!None` if empty or unbound.)r rrrrrNsz Range.lowercCs|jS)z:The upper bound of the range. `!None` if empty or unbound.)r rrrrrSsz Range.uppercCs |jdkS)z`!True` if the range is empty.NrrrrrisemptyXsz Range.isemptycCs|jdkrdS|jdkS)z0`!True` if the range doesn't have a lower bound.NFrr rrrr lower_inf]s zRange.lower_infcCs|jdkrdS|jdkS)z1`!True` if the range doesn't have an upper bound.NFrr rrrr upper_infds zRange.upper_infcCs&|jdks|jdkrdS|jddkS)z4`!True` if the lower bound is included in the range.NFr[r&rrrr lower_inckszRange.lower_inccCs&|jdks|jdkrdS|jddkS)z4`!True` if the upper bound is included in the range.NFr]r(rrrr upper_incrszRange.upper_inccCs~|jdkrdS|jdk rD|jddkr6||jkrDdSn||jkrDdS|jdk rz|jddkrl||jkrzdSn||jkrzdSdS)NFrr*rr,T)rr r )rxrrr __contains__ys       zRange.__contains__cCs |jdk SNr$rrrr__bool__szRange.__bool__cCs2t|tsdS|j|jko0|j|jko0|j|jkS)NF) isinstancer r r rrotherrrr__eq__s    z Range.__eq__cCs || Sr0)r5r3rrr__ne__sz Range.__ne__cCst|j|j|jfSr0)hashr r rrrrr__hash__szRange.__hash__cCsbt|tstSdD]J}t||}t||}||kr4q|dkrBdS|dkrPdS||kSqdS)Nr TF)r2r NotImplementedgetattr)rr4attrZ self_valueZ other_valuerrr__lt__s   z Range.__lt__cCs||kr dS||SdSNT)r<r3rrr__le__sz Range.__le__cCst|tr||StSdSr0)r2r r<r9r3rrr__gt__s  z Range.__gt__cCs||kr dS||SdSr=)r?r3rrr__ge__sz Range.__ge__csfddjDS)Ncs"i|]}t|r|t|qSr)hasattrr:).0slotrrr s z&Range.__getstate__..) __slots__rrrr __getstate__s zRange.__getstate__cCs"|D]\}}t|||qdSr0)r"setattr)rstaterCvaluerrr __setstate__szRange.__setstate__)NNrF)r __module__ __qualname____doc__rErrr#propertyrrr%r'r)r+r-r/r1r5r6r8r<r>r?r@rFrJrrrrr #s<          r FcCs&t|||}|| r|pd|S)aCreate and register an adapter and the typecasters to convert between a PostgreSQL |range|_ type and a PostgreSQL `Range` subclass. :param pgrange: the name of the PostgreSQL |range| type. Can be schema-qualified :param pyrange: a `Range` strict subclass, or just a name to give to a new class :param conn_or_curs: a connection or cursor used to find the oid of the range and its subtype; the typecaster is registered in a scope limited to this object, unless *globally* is set to `!True` :param globally: if `!False` (default) register the typecaster only on *conn_or_curs*, otherwise register it globally :return: `RangeCaster` instance responsible for the conversion If a string is passed to *pyrange*, a new `Range` subclass is created with such name and will be available as the `~RangeCaster.range` attribute of the returned `RangeCaster` object. The function queries the database on *conn_or_curs* to inspect the *pgrange* type and raises `~psycopg2.ProgrammingError` if the type is not found. If querying the database is not advisable, use directly the `RangeCaster` class and register the adapter and typecasters using the provided functions. N) RangeCaster_from_db _register)pgrangepyrange conn_or_cursZgloballyZcasterrrrregister_rangesrUc@s4eZdZdZdZddZddZddZd d ZdS) RangeAdapterz`ISQLQuote` adapter for `Range` subclasses. This is an abstract class: concrete classes must set a `name` class attribute or override `getquoted()`. NcCs ||_dSr0)adapted)rrWrrrrszRangeAdapter.__init__cCs|jtkr|SdSr0)Z_protor)rprotorrr __conform__s zRangeAdapter.__conform__cCs ||_dSr0)_conn)rconnrrrprepareszRangeAdapter.preparecCs|jdkrtd|j}|jr.d|jdS|jdk rbt|j}t|drX||j | }nd}|j dk rt|j }t|dr||j | }nd}|jdd|d|d|j dd S) NzMRangeAdapter must be subclassed overriding its name or the getquoted() methods 'empty'::utf8r\sNULL(s, s, 's')) nameNotImplementedErrorrWr%encoderrrAr\rZ getquotedrr)rrarrrrrrbs4            zRangeAdapter.getquoted) rrKrLrMr_rrYr\rbrrrrrVs rVc@sZeZdZdZdddZddZeddZe d ej Z e d Z dd d Z dd dZdS)rOa Helper class to convert between `Range` and PostgreSQL range types. Objects of this class are usually created by `register_range()`. Manual creation could be useful if querying the database is not advisable: in this case the oids must be provided. NcCs`||_||||jjp"|jjj}t|f||j|_|dk rVt |f|d|j|_ nd|_ dS)NARRAY) subtype_oid_create_rangesadapterr_rrrparse typecasterrarray_typecaster)rrRrSoidrf array_oidr_rrrr$s zRangeCaster.__init__cCsd|_t|tr*t|tfi|_||j_n2zt|trD|tk rD||_Wntk rZYnX|jdkrntdd|_z6t|trt|t fi|_t|t r|t k r||_Wntk rYnX|jdkrtddS)z0Create Range and RangeAdapter classes if needed.Nz:pgrange must be a string or a RangeAdapter strict subclassz1pyrange must be a type or a Range strict subclass) rhr2r typerVr_ issubclass TypeErrorranger )rrRrSrrrrg2s6        zRangeCaster._create_rangesc CsNddlm}ddlm}||\}}|jjdkr@td|jj|j}d|kr`|dd\} } n|} d} | d | | f| } | szdz.d } |j|kr| d d } | d|fWntk rYnX| } | r| dd\} } W5| r| d X||kr|j s| | s*td|d| dd\} }}t ||| ||dS)z|Return a `RangeCaster` instance for the type *pgrange*. Raise `ProgrammingError` if the type is not found. r)STATUS_IN_TRANSACTION)_solve_conn_cursiX`z'range types not available in version %s.rpubliczselect rngtypid, rngsubtype, typarray from pg_range r join pg_type t on t.oid = rngtypid join pg_namespace ns on ns.oid = typnamespace where typname = %s and ns.nspname = %s; z#ROLLBACK TO SAVEPOINT register_typeFzSAVEPOINT register_typeTzSELECT rngtypid, rngsubtype, typarray, typname, nspname from pg_range r join pg_type t on t.oid = rngtypid join pg_namespace ns on ns.oid = typnamespace WHERE t.oid = %s::regtype NzPostgreSQL range 'z ' not foundrlrfrm)psycopg2.extensionsrrZpsycopg2.extrasrsinfoZserver_versionrstatussplitexecuteZfetchoneZ autocommitrollbackrO)rr_rSrTrrrsr[ZcursZ conn_statusZschemaZtnameZrecZ savepointrnsubtypearrayrrrrPUsX        zRangeCaster._from_dba] ( \(|\[ ) # lower bound flag (?: # lower bound: " ( (?: [^"] | "")* ) " # - a quoted string | ( [^",]+ ) # - or an unquoted string )? # - or empty (not catched) , (?: # upper bound: " ( (?: [^"] | "")* ) " # - a quoted string | ( [^"\)\]]+ ) # - or an unquoted string )? # - or empty (not catched) ( \)|\] ) # upper bound flag z (["\\])\1cCs|dkr dS|dkr |jddS|j|}|dkrDtd|d|d}|dkrv|d}|dk rv|jd|}|d }|dkr|d }|dk r|jd|}|dk r||j|}||j|}|d |d }||||S) NrT)rzfailed to parse range: ''rvz\1r) rq _re_rangematchrgroup _re_undoublesubcastrf)rscurmrrrrrrris,      zRangeCaster.parsecCs4t|j||jdk r"t|j|t|j|jdSr0)r rjrkrrqrh)rZscoperrrrQs   zRangeCaster._register)N)N)N)rrKrLrMrrg classmethodrPrecompileVERBOSErrrirQrrrrrOs # L   rOc@seZdZdZdS) NumericRangezA `Range` suitable to pass Python numeric types to a PostgreSQL range. PostgreSQL types :sql:`int4range`, :sql:`int8range`, :sql:`numrange` are casted into `!NumericRange` instances. NrrKrLrMrrrrrsrc@seZdZdZdS) DateRangez#Represents :sql:`daterange` values.Nrrrrrrsrc@seZdZdZdS) DateTimeRangez!Represents :sql:`tsrange` values.Nrrrrrrsrc@seZdZdZdS)DateTimeTZRangez#Represents :sql:`tstzrange` values.Nrrrrrrsrc@seZdZdZddZdS)NumberRangeAdapterz1Adapt a range if the subtype doesn't need quotes.cCs||j}|jrdS|js,t|jd}nd}|jsLt|jd}nd}d|j d|d||j dd dS)Ns'empty'asciirrr,r) rWr%r'rrrbdecoder)rrra)rrcrrrrrrbszNumberRangeAdapter.getquotedN)rrKrLrMrbrrrrrsri@iArwiViWiBiiCZ daterangeiHi:iIZtsrangeiDiZiEZ tstzrangeiFiiG)F)rMrZpsycopg2._psycopgrrrxrrrrrr r rUrVrOrrrrrZint4range_casterrQZint8range_casterZnumrange_casterZdaterange_casterZtsrange_casterZtstzrange_casterrrrrsh, 0=