ó
‹EYc@s¢
dd
lZddl
mZmZ
ddlmZ
ddlmZ	
ddl
mZ
ddlmZ
d Z
ejdejƒZejdejƒZd
„Zd„Zd„Zd	ejejfd„ƒYZeed
<d
e	jf
d„ƒYZde	jf
d„ƒYZde	jf
d„ƒYZde	jf
d„ƒYZde	jf
d„ƒYZde	jf
d„ƒYZde	jf
d„ƒYZde	jf
d„ƒYZ d
S(!iÿÿÿÿNi
(tARRAYt
ischema_namesi(
ttypes(
t	functions(
t	custom_op(
tutiltHSTOREthstoresÝ
(
  "(?P<key> (\\ . | [^"])* )"       # Quoted key
)
[ ]* => [ ]*    # Pair operator, optional adjoining whitespace
(
    (?P<value_null> NULL )          # NULL value
  | "(?P<value> (\\ . | [^"])* )"   # Quoted value
)
s

[ ]* , [ ]*
cCs·d
}t|ƒ
}|t
|
|ddƒt|
|ƒ!}|t|
|ƒt|
|d|ƒ!}t|ƒ
|krƒd|d}nt|ƒ
|kr¦|d d}nd||
|fS(sformat an unmarshalling error.ii
is[...]iÿÿÿÿs5After %r, could not parse residual at position %d: %r(tlentmaxtmin(t
hstore_strtpostctxthslentparsed_tailtresidual((sZ/home/tvault/.virtenv/lib/python2.7/site-packages/sqlalchemy/dialects/postgresql/hstore.pyt_parse_error%s
'
'



c
Cs!
i}
d
}tj
|ƒ
}xÕ|d	k	rò|jdƒ
jddƒjddƒ}|jdƒ
rid	}n'|jdƒ
jddƒjddƒ}||
|<||jƒ7}tj
||ƒ
}|d	k	rÜ||jƒ7}ntj
||ƒ
}qW|t|ƒ
kr
tt	||ƒƒ
‚
n|
S(
s
Parse an hstore from its literal string representation.

    Attempts to approximate PG's hstore input parsing rules as closely as
    possible. Although currently this is not strictly necessary, since the
    current implementation of hstore's output syntax is stricter than what it
    accepts as input, the documentation makes no guarantees that will always
    be the case.



    itkeys\"t
"s\\s
\t
value_nulltvalueN(
tHSTORE_PAIR_REtmatchtNonetgrouptreplacetendtHSTORE_DELIMITER_RERt
ValueErrorR(RtresultRt
pair_matchRRtdelim_match((sZ/home/tvault/.virtenv/lib/python2.7/site-packages/sqlalchemy/dialects/postgresql/hstore.pyt
_parse_hstore7s&





	





c

s,d
„‰dj‡f
d†|j
ƒDƒ
ƒ
S(sxSerialize a dictionary into an hstore literal.  Keys and values must
    both be strings (except None for values).

    cSsh|
d
kr|dkrdSt
|tjƒrNd|jddƒjddƒStd||
fƒ
‚
dS(	NRtNULLs"%s"s
\s\\Rs\"s"%r in %s position is not a string.(Rt
isinstanceRtstring_typesRR(t
stposition((sZ/home/tvault/.virtenv/lib/python2.7/site-packages/sqlalchemy/dialects/postgresql/hstore.pytescds



 
s, c
3s7|]-\}
}dˆ|
d
ƒˆ|dƒfV
qdS(s%s=>%sRRN((t.0t
kt
v(
R'(sZ/home/tvault/.virtenv/lib/python2.7/site-packages/sqlalchemy/dialects/postgresql/hstore.pys	<genexpr>ms
(tjointitems(
tval((
R'sZ/home/tvault/.virtenv/lib/python2.7/site-packages/sqlalchemy/dialects/postgresql/hstore.pyt_serialize_hstore_s		
cBsHeZ
dZd
ZeZdejjf
d„ƒYZ	d„Z
d„ZRS(sRepresent the Postgresql HSTORE type.

    The :class:`.HSTORE` type stores dictionaries containing strings, e.g.::

        data_table = Table('data_table', metadata,
            Column('id', Integer, primary_key=True),
            Column('data', HSTORE)
        )

        with engine.connect() as conn:
            conn.execute(
                data_table.insert(),
                data = {"key1": "value1", "key2": "value2"}
            )

    :class:`.HSTORE` provides for a wide range of operations, including:

    * Index operations::

        data_table.c.data['some key'] == 'some value'

    * Containment operations::

        data_table.c.data.has_key('some key')

        data_table.c.data.has_all(['one', 'two', 'three'])

    * Concatenation::

        data_table.c.data + {"k1": "v1"}

    For a full list of special methods see
    :class:`.HSTORE.comparator_factory`.

    For usage with the SQLAlchemy ORM, it may be desirable to combine
    the usage of :class:`.HSTORE` with :class:`.MutableDict` dictionary
    now part of the :mod:`sqlalchemy.ext.mutable`
    extension.  This extension will allow "in-place" changes to the
    dictionary, e.g. addition of new keys or replacement/removal of existing
    keys to/from the current dictionary, to produce events which will be
    detected by the unit of work::

        from sqlalchemy.ext.mutable import MutableDict

        class MyClass(Base):
            __tablename__ = 'data_table'

            id = Column(Integer, primary_key=True)
            data = Column(MutableDict.as_mutable(HSTORE))

        my_object = session.query(MyClass).one()

        # in-place mutation, requires Mutable extension
        # in order for the ORM to detect
        my_object.data['some_key'] = 'some value'

        session.commit()

    When the :mod:`sqlalchemy.ext.mutable` extension is not used, the ORM
    will not be alerted to any changes to the contents of an existing
    dictionary, unless that dictionary value is re-assigned to the
    HSTORE-attribute itself, thus generating a change event.

    .. versionadded:: 0.8

    .. seealso::

        :class:`.hstore` - render the Postgresql ``hstore()`` function.


    Rtcomparator_factoryc
BsŒeZ
dZd
„Zd„Zd„Zd„Zd„Zd„Zd„Z	d„Z
d	„Zd
„Zd„Z
d„Zd
„Zd„ZRS(s2Define comparison operations for :class:`.HSTORE`.cCs|jj
d
ƒ
|
ƒ
S(svBoolean expression.  Test for presence of a key.  Note that the
            key may be a SQLA expression.
            t
?(texprtop(tselftother((sZ/home/tvault/.virtenv/lib/python2.7/site-packages/sqlalchemy/dialects/postgresql/hstore.pythas_keyÀscCs|jj
d
ƒ
|
ƒ
S(s\Boolean expression.  Test for presence of all keys in the PG
            array.
            s?&(R1R2(R3R4((sZ/home/tvault/.virtenv/lib/python2.7/site-packages/sqlalchemy/dialects/postgresql/hstore.pythas_allÆscCs|jj
d
ƒ
|
ƒ
S(s[Boolean expression.  Test for presence of any key in the PG
            array.
            s?|(R1R2(R3R4((sZ/home/tvault/.virtenv/lib/python2.7/site-packages/sqlalchemy/dialects/postgresql/hstore.pythas_anyÌscCst|j
|
ƒS(
sBoolean expression.  Test for presence of a non-NULL value for
            the key.  Note that the key may be a SQLA expression.
            (t_HStoreDefinedFunctionR1(R3R((sZ/home/tvault/.virtenv/lib/python2.7/site-packages/sqlalchemy/dialects/postgresql/hstore.pytdefinedÒscKs|jj
d
ƒ
|
ƒ
S(sxBoolean expression.  Test if keys are a superset of the keys of
            the argument hstore expression.
            s@>(R1R2(R3R4tkwargs((sZ/home/tvault/.virtenv/lib/python2.7/site-packages/sqlalchemy/dialects/postgresql/hstore.pytcontainsØscCs|jj
d
ƒ
|
ƒ
S(s}Boolean expression.  Test if keys are a proper subset of the
            keys of the argument hstore expression.
            s<@(R1R2(R3R4((sZ/home/tvault/.virtenv/lib/python2.7/site-packages/sqlalchemy/dialects/postgresql/hstore.pytcontained_byÞscCs|jj
d
ddƒ

|
ƒ
S(suText expression.  Get the value at a given key.  Note that the
            key may be a SQLA expression.
            s->t
precedencei(R1R2(R3R4((sZ/home/tvault/.virtenv/lib/python2.7/site-packages/sqlalchemy/dialects/postgresql/hstore.pyt__getitem__äscCs.t|
t
ƒrt|
ƒ
}
nt|j|
ƒS(
s™HStore expression.  Returns the contents of this hstore with the
            given key deleted.  Note that the key may be a SQLA expression.
            (R#tdictR.t_HStoreDeleteFunctionR1(R3R((sZ/home/tvault/.virtenv/lib/python2.7/site-packages/sqlalchemy/dialects/postgresql/hstore.pytdeleteês

cCst|j
|
ƒS(
sdHStore expression.  Returns a subset of an hstore defined by
            array of keys.
            (t_HStoreSliceFunctionR1(R3tarray((sZ/home/tvault/.virtenv/lib/python2.7/site-packages/sqlalchemy/dialects/postgresql/hstore.pytsliceòsc

Cs
t|j
ƒ
S(
s.Text array expression.  Returns array of keys.(t_HStoreKeysFunctionR1(
R3((sZ/home/tvault/.virtenv/lib/python2.7/site-packages/sqlalchemy/dialects/postgresql/hstore.pytkeysøsc

Cs
t|j
ƒ
S(
s0Text array expression.  Returns array of values.(t_HStoreValsFunctionR1(
R3((sZ/home/tvault/.virtenv/lib/python2.7/site-packages/sqlalchemy/dialects/postgresql/hstore.pytvalsüsc

Cs
t|j
ƒ
S(
s^Text array expression.  Returns array of alternating keys and
            values.
            (t_HStoreArrayFunctionR1(
R3((sZ/home/tvault/.virtenv/lib/python2.7/site-packages/sqlalchemy/dialects/postgresql/hstore.pyRC
sc

Cs
t|j
ƒ
S(
s<Text array expression.  Returns array of [key, value] pairs.(t_HStoreMatrixFunctionR1(
R3((sZ/home/tvault/.virtenv/lib/python2.7/site-packages/sqlalchemy/dialects/postgresql/hstore.pytmatrix
scCsct|
t
ƒrJ|
jdkr+|
tjfS|
jdkrJ|
tjfSntjjj||
|ƒS(NR0s?&s?|s@>s<@s->(R0s?&s?|s@>s<@(	R#RtopstringtsqltypestBooleantTexttConcatenablet
Comparatort_adapt_expression(R3R2tother_comparator((sZ/home/tvault/.virtenv/lib/python2.7/site-packages/sqlalchemy/dialects/postgresql/hstore.pyRR

s







(t__name__t
__module__t__doc__R5R6R7R9R;R<R>RARDRFRHRCRKRR(((sZ/home/tvault/.virtenv/lib/python2.7/site-packages/sqlalchemy/dialects/postgresql/hstore.pyR/½s
													cs1tj
r$|
j‰‡f
d
†}n	d„}|S(Nc

s*t|t
ƒr"t|ƒ
jˆƒ
S|SdS(
N(R#R?R.tencode(
R(
tencoding(sZ/home/tvault/.virtenv/lib/python2.7/site-packages/sqlalchemy/dialects/postgresql/hstore.pytprocess
s

c

Ss!t|t
ƒrt|ƒ
S|SdS(
N(R#R?R.(
R((sZ/home/tvault/.virtenv/lib/python2.7/site-packages/sqlalchemy/dialects/postgresql/hstore.pyRY
s


(Rtpy2kRX(R3tdialectRY((
RXsZ/home/tvault/.virtenv/lib/python2.7/site-packages/sqlalchemy/dialects/postgresql/hstore.pytbind_processor
s

	
		cs1tj
r$|
j‰‡f
d
†}n	d„}|S(Nc

s'|dk	rt
|jˆƒ
ƒ
S|SdS(
N(RR!tdecode(
R(
RX(sZ/home/tvault/.virtenv/lib/python2.7/site-packages/sqlalchemy/dialects/postgresql/hstore.pyRY(
s

c

Ss|dk	rt
|ƒ
S|SdS(
N(RR!(
R((sZ/home/tvault/.virtenv/lib/python2.7/site-packages/sqlalchemy/dialects/postgresql/hstore.pyRY.
s


(RRZRX(R3R[tcoltypeRY((
RXsZ/home/tvault/.virtenv/lib/python2.7/site-packages/sqlalchemy/dialects/postgresql/hstore.pytresult_processor$
s

	
		(RTRURVt__visit_name__tFalsethashableRMRPRQR/R\R_(((sZ/home/tvault/.virtenv/lib/python2.7/site-packages/sqlalchemy/dialects/postgresql/hstore.pyRqsG
V	c
BseZ
dZeZd
ZRS(szConstruct an hstore value within a SQL expression using the
    Postgresql ``hstore()`` function.

    The :class:`.hstore` function accepts one or two arguments as described
    in the Postgresql documentation.

    E.g.::

        from sqlalchemy.dialects.postgresql import array, hstore

        select([hstore('key1', 'value1')])

        select([
                hstore(
                    array(['key1', 'key2', 'key3']),
                    array(['value1', 'value2', 'value3'])
                )
            ])

    .. versionadded:: 0.8

    .. seealso::

        :class:`.HSTORE` - the Postgresql ``HSTORE`` datatype.

    R(RTRURVRttypetname(((sZ/home/tvault/.virtenv/lib/python2.7/site-packages/sqlalchemy/dialects/postgresql/hstore.pyR9
s

R8c
BseZ
ejZdZRS(
R9(RTRURMRNRcRd(((sZ/home/tvault/.virtenv/lib/python2.7/site-packages/sqlalchemy/dialects/postgresql/hstore.pyR8X
s
	
R@c
BseZ
eZdZRS(
RA(RTRURRcRd(((sZ/home/tvault/.virtenv/lib/python2.7/site-packages/sqlalchemy/dialects/postgresql/hstore.pyR@]
s

RBc
BseZ
eZdZRS(
RD(RTRURRcRd(((sZ/home/tvault/.virtenv/lib/python2.7/site-packages/sqlalchemy/dialects/postgresql/hstore.pyRBb
s

REcBseZ
eejƒ
ZdZRS(
takeys(RTRURRMRORcRd(((sZ/home/tvault/.virtenv/lib/python2.7/site-packages/sqlalchemy/dialects/postgresql/hstore.pyREg
s

RGcBseZ
eejƒ
ZdZRS(
tavals(RTRURRMRORcRd(((sZ/home/tvault/.virtenv/lib/python2.7/site-packages/sqlalchemy/dialects/postgresql/hstore.pyRGl
s

RIcBseZ
eejƒ
ZdZRS(
thstore_to_array(RTRURRMRORcRd(((sZ/home/tvault/.virtenv/lib/python2.7/site-packages/sqlalchemy/dialects/postgresql/hstore.pyRIq
s

RJcBseZ
eejƒ
ZdZRS(
thstore_to_matrix(RTRURRMRORcRd(((sZ/home/tvault/.virtenv/lib/python2.7/site-packages/sqlalchemy/dialects/postgresql/hstore.pyRJv
s

(sHSTOREshstore(!tretbaseRR
tRRMtsqlRtsqlfunct
sql.operatorsRRt__all__tcompiletVERBOSERRRR!R.RPt
TypeEngineRtGenericFunctionRR8R@RBRERGRIRJ(((sZ/home/tvault/.virtenv/lib/python2.7/site-packages/sqlalchemy/dialects/postgresql/hstore.pyt<module>s.



			(	Å