[Jc @ s0 d d k i Z d d k l Z l Z d d k l Z l Z l Z d d k
l Z l Z l
Z
l Z l Z d d k l Z l Z e d4 Z d5 Z d e f d YZ d e f d YZ d d Z d Z d e f d YZ d e i f d YZ d e f d YZ d d Z! e i" Z# d e i$ f d YZ% d e& e' d Z( d e' d! Z) d" Z* e' d# Z+ d$ Z, d% Z- d& Z. d' Z/ d( Z0 d) Z1 e' d* Z2 e' d+ Z3 d, Z4 d- Z5 d. Z6 d/ Z7 d0 Z8 d1 Z9 d2 Z: d3 Z; e; e _; e/ e _/ e+ e _+ d S(6 iN( t sqlt util( t
expressionR t operators( t MapperExtensiont EXT_CONTINUEt PropComparatort MapperPropertyt AttributeExtension( t
attributest exct deletes
delete-orphant allt merget expunges save-updates refresh-expiret nonet mappert instrumentort CascadeOptionsc B s, e Z d Z d d Z d Z d Z RS( s5 Keeps track of the options sent to relation().cascadet c C s- | p
t } n t d | i d D } d | j | _ d | j p
d | j | _ d | j p
d | j | _ d | j p
d | j | _ d | j p
d | j | _ d | j p
d | j | _ | i o | i o t i d
n x2 | D]* } | t
j o t i d | q q Wd S( Nc s s x | ] } | i Vq Wd S( N( t strip( t .0t c( ( s7 /usr/lib/python2.6/site-packages/sqlalchemy/orm/util.pys s t ,s
delete-orphanR R s save-updateR
R s refresh-expiresW The 'delete-orphan' cascade option requires 'delete'. This will raise an error in 0.6.s Invalid cascade option '%s'(
t sett splitt
delete_orphanR t save_updateR
R t refresh_expireR t warnt all_cascadest sa_exct
ArgumentError( t selft argt valuest x( ( s7 /usr/lib/python2.6/site-packages/sqlalchemy/orm/util.pyt __init__ s
c C s t | | i d d t S( Nt -t _( t getattrt replacet False( R! t item( ( s7 /usr/lib/python2.6/site-packages/sqlalchemy/orm/util.pyt __contains__+ s c
C sa d t d i g } d d d d d d g D]* } t | | t t j o | | q) q) ~ S( Ns CascadeOptions(%s)R R R R
R R s refresh-expire( t reprt joinR( R* t True( R! t _[1]R$ ( ( s7 /usr/lib/python2.6/site-packages/sqlalchemy/orm/util.pyt __repr__. s ( t __name__t
__module__t __doc__R% R, R1 ( ( ( s7 /usr/lib/python2.6/site-packages/sqlalchemy/orm/util.pyR s t Validatorc B s) e Z d Z d Z d Z d Z RS( s Runs a validation method on an attribute value to be set or appended.
The Validator class is used by the :func:`~sqlalchemy.orm.validates`
decorator, and direct access is usually not needed.
c C s | | _ | | _ d S( s
Construct a new Validator.
key - name of the attribute to be validated;
will be passed as the second argument to
the validation method (the first is the object instance itself).
validator - an function or instance method which accepts
three arguments; an instance (usually just 'self' for a method),
the key name of the attribute, and the value. The function should
return the same value given, unless it wishes to modify it.
N( t keyt validator( R! R6 R7 ( ( s7 /usr/lib/python2.6/site-packages/sqlalchemy/orm/util.pyR% = s
c C s | i | i | i | S( N( R7 t objR6 ( R! t statet valuet initiator( ( s7 /usr/lib/python2.6/site-packages/sqlalchemy/orm/util.pyt appendM s c C s | i | i | i | S( N( R7 R8 R6 ( R! R9 R: t oldvalueR; ( ( s7 /usr/lib/python2.6/site-packages/sqlalchemy/orm/util.pyR P s ( R2 R3 R4 R% R< R ( ( ( s7 /usr/lib/python2.6/site-packages/sqlalchemy/orm/util.pyR5 5 s t p_unionc s t } h h x | i D] } | | } t | t i o | i } | | | | i D]3 } | i | i | | | i <| i | i s c C s2 g | _ x" | p d D] } | i | q Wd S( N( ( t _extensionsR< ( R! t
extensionst ext( ( s7 /usr/lib/python2.6/site-packages/sqlalchemy/orm/util.pyR% s c C s
t | i S( N( Rk Rn ( R! ( ( s7 /usr/lib/python2.6/site-packages/sqlalchemy/orm/util.pyt copy s c C s$ | i | | i i d | d S( s< Insert a MapperExtension at the beginning of the collection.i N( t _registerRn t insert( R! t extension( ( s7 /usr/lib/python2.6/site-packages/sqlalchemy/orm/util.pyt push s
c C s! | i | | i i | d S( s6 Append a MapperExtension at the end of the collection.N( Rr Rn R< ( R! Rt ( ( s7 /usr/lib/python2.6/site-packages/sqlalchemy/orm/util.pyR< s
c C s
t | i S( s0 Iterate over MapperExtensions in the collection.( t iterRn ( R! ( ( s7 /usr/lib/python2.6/site-packages/sqlalchemy/orm/util.pyt __iter__ s c C sg x` | i i | D]L } t | | d } | o- | t t | j o | i | | | ( t idR R2 ( R! ( ( s7 /usr/lib/python2.6/site-packages/sqlalchemy/orm/util.pyR1 ^ s N( R2 R3 R4 RP R% R R R R R R1 ( ( ( s7 /usr/lib/python2.6/site-packages/sqlalchemy/orm/util.pyR s
c C s t i | h t d 6| S( s Deep copy the given ClauseElement, annotating each element with the "_orm_adapt" flag.
Elements within the exclude collection will be cloned but not annotated.
t
_orm_adapt( R t _deep_annotateR/ ( t elementt exclude( ( s7 /usr/lib/python2.6/site-packages/sqlalchemy/orm/util.pyt
_orm_annotateb s t _ORMJoinc B sM e Z d Z e i i Z d e e d Z d e e d Z
d e d Z RS( s/ Extend Join to support ORM constructs as input.c C s d } t | d o% | i d } | o
| i } qp n6 t | \ } } } | o | p | o
| } n t | \ } } }
|
o
| } n d } | p | o | | f | _ t | t o | i | } nX t | t i o$ | p | i
} n | i } n! t | t o
| } n d } | ox | i
d | d | d t d t d | \ }
} } } } } | o" t i | | |
| } | } n |
} | | _ qn t i i | | | | | d S( Nt _orm_mappersi t source_selectablet dest_selectablet source_polymorphict dest_polymorphict of_type( RP R R t rightR RJ t
basestringt get_propertyR R t __clause_element__t propertyR t
_create_joinsR/ R R. t _target_adapterR t JoinR% ( R! t leftR t onclauset isoutert join_to_leftt
adapt_fromt left_mappert left_is_aliasedt right_mappert right_is_aliasedt adapt_toR t pjt sjt sourcet destt secondaryt target_adapter( ( s7 /usr/lib/python2.6/site-packages/sqlalchemy/orm/util.pyR% q sH
c C s t | | | | | S( N( R ( R! R R R R ( ( s7 /usr/lib/python2.6/site-packages/sqlalchemy/orm/util.pyR. s c C s t | | | t | S( N( R R/ ( R! R R R ( ( s7 /usr/lib/python2.6/site-packages/sqlalchemy/orm/util.pyt outerjoin s N( R2 R3 R4 R R t __visit_name__RP R* R/ R% R. R ( ( ( s7 /usr/lib/python2.6/site-packages/sqlalchemy/orm/util.pyR l s
1c C s t | | | | | S( s Produce an inner join between left and right clauses.
In addition to the interface provided by
:func:`~sqlalchemy.sql.expression.join()`, left and right may be mapped
classes or AliasedClass instances. The onclause may be a
string name of a relation(), or a class-bound descriptor
representing a relation.
join_to_left indicates to attempt aliasing the ON clause,
in whatever form it is passed, to the selectable
passed as the left side. If False, the onclause
is used as is.
( R ( R R R R R ( ( s7 /usr/lib/python2.6/site-packages/sqlalchemy/orm/util.pyR. s c C s t | | | t | S( sU Produce a left outer join between left and right clauses.
In addition to the interface provided by
:func:`~sqlalchemy.sql.expression.outerjoin()`, left and right may be mapped
classes or AliasedClass instances. The onclause may be a
string name of a relation(), or a class-bound descriptor
representing a relation.
( R R/ ( R R R R ( ( s7 /usr/lib/python2.6/site-packages/sqlalchemy/orm/util.pyR s
c C sn t | t o% t | } | i | d t } n! t | t i o
| i } n | i t i
| d t S( st Return criterion which selects instances with a given parent.
instance
a parent instance, which should be persistent or detached.
property
a class-attached descriptor, MapperProperty or string property name
attached to the parent instance.
\**kwargs
all extra keyword arguments are propagated to the constructor of
Query.
t resolve_synonymst value_is_parent( RJ R Re R R/ R R R t compareR t eq( R^ R R ( ( s7 /usr/lib/python2.6/site-packages/sqlalchemy/orm/util.pyt with_parent s
c C s t | t o | i | i t f St | oQ t | t o t | | } n | o | i } n | } | | i t
f Sd | t
f Sd S( sl Return mapping information given a class, mapper, or AliasedClass.
Returns 3-tuple of: mapper, mapped selectable, boolean indicating if this
is an aliased() construct.
If the given entity is not a mapper, mapped class, or aliased construct,
returns None, the entity, False. This is typically used to allow
unmapped selectables through.
N( RJ R R R R/ t _is_mapped_classRN Ra t compileR R* RP ( R R R ( ( s7 /usr/lib/python2.6/site-packages/sqlalchemy/orm/util.pyR s
c C s| t | t o t | | } | | i f St | t o! t i | | } | | i f S| i | } | | i f Sd S( s Return attribute/property information given an entity and string name.
Returns a 2-tuple representing InstrumentedAttribute/MapperProperty.
N( RJ R R( R RN R t manager_of_classt
class_manager( R R6 t desc( ( s7 /usr/lib/python2.6/site-packages/sqlalchemy/orm/util.pyt _entity_descriptor s
c C sV t | \ } } } t | t i o# g } | i D]
} | | q6 ~ S| g Sd S( N( R RJ R t
SelectableR ( R R R R R0 R ( ( s7 /usr/lib/python2.6/site-packages/sqlalchemy/orm/util.pyt _orm_columns s #c C s t | \ } } } | S( N( R ( R R R R ( ( s7 /usr/lib/python2.6/site-packages/sqlalchemy/orm/util.pyt _orm_selectable
s c C s
t | t S( N( RJ R ( R ( ( s7 /usr/lib/python2.6/site-packages/sqlalchemy/orm/util.pyt _is_aliased_class s c C s
| i i S( N( t managerR ( R9 ( ( s7 /usr/lib/python2.6/site-packages/sqlalchemy/orm/util.pyt
_state_mapper s c C si y= t i | } | i i p t i | n | i i SWn% t i j
o t i | n Xd S( s Given an object, return the primary Mapper associated with the object instance.
Raises UnmappedInstanceError if no mapping is configured.
N( R t instance_stateR R R
t UnmappedInstanceErrort NO_STATE( R^ R9 ( ( s7 /usr/lib/python2.6/site-packages/sqlalchemy/orm/util.pyRe s
c C sv y3 t i | } | i } | d j o
t n Wn% t i j
o t i | n X| o | i } n | S( s Given a class, return the primary Mapper associated with the key.
Raises UnmappedClassError if no mapping is configured.
N( R R R RP R R
R t UnmappedClassErrorR ( Ri R R R ( ( s7 /usr/lib/python2.6/site-packages/sqlalchemy/orm/util.pyRa % s
c C ss t | o | i St | t o t | d | St | d o | o | i S| Sn t i | d S( NR ( R R RJ RN Ra R R R
R ( t class_or_mapperR ( ( s7 /usr/lib/python2.6/site-packages/sqlalchemy/orm/util.pyR : s
c C s t i | } t | S( N( R R t _state_has_identity( R R9 ( ( s7 /usr/lib/python2.6/site-packages/sqlalchemy/orm/util.pyt has_identityG s c C s
t | i S( N( t boolR6 ( R9 ( ( s7 /usr/lib/python2.6/site-packages/sqlalchemy/orm/util.pyR K s c C s~ d d k l } t | t | i f o t St | t i o t St | t o$ t
i | } | o
t | i
j St S( Ni( t mapperlib( t sqlalchemy.ormR RJ R t MapperR/ R t
ClauseElementR* RN R R t
_INSTRUMENTORt info( R R R ( ( s7 /usr/lib/python2.6/site-packages/sqlalchemy/orm/util.pyR N s c C s t t i | S( s' Return a string describing an instance.( t state_strR R ( R^ ( ( s7 /usr/lib/python2.6/site-packages/sqlalchemy/orm/util.pyt instance_strY s c C s6 | d j o d Sd | i i t | i f Sd S( s= Return a string describing an instance via its InstanceState.RP s <%s at 0x%x>N( RP Ri R2 R R8 ( R9 ( ( s7 /usr/lib/python2.6/site-packages/sqlalchemy/orm/util.pyR ^ s
c C s t | d | S( Nt .( R ( R^ t attribute( ( s7 /usr/lib/python2.6/site-packages/sqlalchemy/orm/util.pyt
attribute_strf s c C s t | d | S( NR ( R ( R9 R ( ( s7 /usr/lib/python2.6/site-packages/sqlalchemy/orm/util.pyt state_attribute_stri s c C s | | j o t S| d j p
| d j o t Sy" t i | } t i | } Wn t i j
o t SX| i d j p | i d j o t S| i | i j S( N( R/ RP R* R R R
R R6 ( t at bt state_at state_b( ( s7 /usr/lib/python2.6/site-packages/sqlalchemy/orm/util.pyt identity_equall s
( s deletes
delete-orphans alls merges expunges save-updates refresh-expireR ( s mapperR (< t sqlalchemy.exceptionst
exceptionsR t
sqlalchemyR R t sqlalchemy.sqlR R R t sqlalchemy.orm.interfacesR R R R R R R R
t frozensetR R R R R5 R[ Rj t dictRk R R R RP R t _deep_deannotatet _orm_deannotateR R R* R/ R. R R R R R R R R Re Ra R R R R R R R R R
( ( ( s7 /usr/lib/python2.6/site-packages/sqlalchemy/orm/util.pyt sR ( ! * 8HO <