/
opt
/
alt
/
python27
/
lib64
/
python2.7
/
site-packages
/
sqlalchemy
/
orm
/
up file
home
� 1��fc @@ s� d Z d d l m Z d d l m Z d d l m Z d d l m Z d d l m Z d d l m Z d d l m Z d d l m Z d d l m Z d d l m Z d d l m Z d d l m Z d d d d d g Z e j d e f d � � Y� Z d S( s| MapperProperty implementations. This is a private module which defines the behavior of individual ORM- mapped attributes. i ( t absolute_importi ( t attributes( t CompositeProperty( t ConcreteInheritedProperty( t SynonymProperty( t PropComparator( t StrategizedProperty( t RelationshipPropertyi ( t log( t util( t coercions( t rolest ColumnPropertyR R R R c B@ s� e Z d Z d Z e Z e Z d$ Z d � Z d � Z e j d d � d � � Z e j d d � d � � Z d � Z e d � � Z d � Z d � Z d � Z e j d � Z d � Z d! e j e f d" � � YZ d# � Z RS(% s� Describes an object attribute that corresponds to a table column. Public constructor is the :func:`_orm.column_property` function. t columnt columnst groupt deferredt instrumentt comparator_factoryt descriptort active_historyt expire_on_flusht infot doct strategy_keyt _creation_ordert _is_polymorphic_discriminatort _mapped_by_synonymt _deferred_column_loadert _raise_column_loadert _renders_in_subqueriest raiseloadc O@ s t t | � j � g | D] } t j t j | � ^ q | _ | j d d � | _ | j d t � | _ | j d t � | _ | j d t � | _ | j d | j j � | _ | j d d � | _ | j d t � | _ | j d t � | _ d | k r | j d � | _ n d | k r.| j d � | _ nN xK t | j � D]1 } t | d d � } | d k r>| | _ Pq>q>Wd | _ | r�t d | j j d j t | j � � � f � � n t j | � d | j f d | j f f | _! | j r| j! d t f f 7_! n d S( s4 Provide a column-level property for use with a mapping. Column-based properties can normally be applied to the mapper's ``properties`` dictionary using the :class:`_schema.Column` element directly. Use this function when the given column is not directly present within the mapper's selectable; examples include SQL expressions, functions, and scalar SELECT queries. The :func:`_orm.column_property` function returns an instance of :class:`.ColumnProperty`. Columns that aren't present in the mapper's selectable won't be persisted by the mapper and are effectively "read-only" attributes. :param \*cols: list of Column objects to be mapped. :param active_history=False: When ``True``, indicates that the "previous" value for a scalar attribute should be loaded when replaced, if not already loaded. Normally, history tracking logic for simple non-primary-key scalar values only needs to be aware of the "new" value in order to perform a flush. This flag is available for applications that make use of :func:`.attributes.get_history` or :meth:`.Session.is_modified` which also need to know the "previous" value of the attribute. :param comparator_factory: a class which extends :class:`.ColumnProperty.Comparator` which provides custom SQL clause generation for comparison operations. :param group: a group name for this property when marked as deferred. :param deferred: when True, the column property is "deferred", meaning that it does not load immediately, and is instead loaded when the attribute is first accessed on an instance. See also :func:`~sqlalchemy.orm.deferred`. :param doc: optional string that will be applied as the doc on the class-bound descriptor. :param expire_on_flush=True: Disable expiry on flush. A column_property() which refers to a SQL expression (and not a single table-bound column) is considered to be a "read only" property; populating it has no effect on the state of data, and it can only return database state. For this reason a column_property()'s value is expired whenever the parent object is involved in a flush, that is, has any kind of "dirty" state within a flush. Setting this parameter to ``False`` will have the effect of leaving any existing value present after the flush proceeds. Note however that the :class:`.Session` with default expiration settings still expires all attributes after a :meth:`.Session.commit` call, however. :param info: Optional data dictionary which will be populated into the :attr:`.MapperProperty.info` attribute of this object. :param raiseload: if True, indicates the column should raise an error when undeferred, rather than loading the value. This can be altered at query time by using the :func:`.deferred` option with raiseload=False. .. versionadded:: 1.4 .. seealso:: :ref:`deferred_raiseload` .. seealso:: :ref:`column_property_options` - to map columns while including mapping options :ref:`mapper_column_property_sql_expressions` - to map SQL expressions R R R t _instrumentR R R R R R s. %s received unexpected keyword argument(s): %ss , R N(" t superR t __init__R t expectR t LabeledColumnExprRoleR t popt NoneR t FalseR R t TrueR t __class__t ComparatorR R R R R R t reversedt getattrt TypeErrort __name__t joint sortedt keysR t set_creation_orderR ( t selfR t kwargst ct colR ( ( sL /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/properties.pyR" G s< T+ . c C@ sD d t f | j k r | j j Sd t f | j k pC | | j j k S( Nt query_expressionR ( R( R t strategyt _have_default_expressiont parentt _readonly_props( R3 ( ( sL /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/properties.pyt% _memoized_attr__renders_in_subqueries� s s sqlalchemy.orm.states sqlalchemy.orm.strategiesc C@ sC t j j } t j j } | j j | j j | j | j � | j � S( N( R t preloadedt orm_statet orm_strategiest InstanceStatet" _instance_level_callable_processorR: t class_managert LoadDeferredColumnst key( R3 t statet strategies( ( sL /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/properties.pyt& _memoized_attr__deferred_column_loader� s c C@ sF t j j } t j j } | j j | j j | j | j t � | j � S( N( R R= R> R? R@ RA R: RB RC RD R( ( R3 RE RF ( ( sL /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/properties.pyt# _memoized_attr__raise_column_loader� s c C@ s | j S( ss Allow the ColumnProperty to work in expression before it is turned into an instrumented attribute. ( t expression( R3 ( ( sL /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/properties.pyt __clause_element__� s c C@ s | j d S( s� Return the primary column or expression for this ColumnProperty. E.g.:: class File(Base): # ... name = Column(String(64)) extension = Column(String(8)) filename = column_property(name + '.' + extension) path = column_property('C:/' + filename.expression) .. seealso:: :ref:`mapper_column_property_sql_expressions_composed` i ( R ( R3 ( ( sL /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/properties.pyRI � s c C@ sH | j s d St j | j | j d | j | | � d | d | j �d S( Nt comparatort parententityR ( R R t register_descriptort class_RD R R ( R3 t mapper( ( sL /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/properties.pyt instrument_class s c C@ s~ t t | � j � t | j � d k rz t | j j � j | j � rz t j d | j | j d | j d | j f � n d S( Ni s� On mapper %s, primary key column '%s' is being combined with distinct primary key column '%s' in attribute '%s'. Use explicit properties to give each column its own mapped attribute name.i ( R! R t do_initt lenR t setR: t primary_keyt issupersetR t warnRD ( R3 ( ( sL /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/properties.pyRQ s ' c C@ s( t d | j d | j d | j | j � S( NR R R ( R R R R R ( R3 ( ( sL /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/properties.pyt copy s c C@ s" | j | j � j | | d | �S( Nt passive( t get_implRD t get_committed_value( R3 RE t dict_R RX ( ( sL /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/properties.pyt _getcommitted$ s c C@ s� | j s d S| j | k rj | | j } | s? | | | j <q� | j | j � } | j | | | d � n7 | j r� | j | k r� | j | | j g d t �n d S( Nt no_loader( R RD RY RS R& t has_identityt _expire_attributesR( ( R3 t sessiont source_statet source_dictt dest_statet dest_dictt loadt _recursivet _resolve_conflict_mapt valuet impl( ( sL /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/properties.pyt merge+ s R* c B@ sS e Z d Z d Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z RS( s� Produce boolean, comparison, and other operators for :class:`.ColumnProperty` attributes. See the documentation for :class:`.PropComparator` for a brief overview. .. seealso:: :class:`.PropComparator` :class:`.ColumnOperators` :ref:`types_operators` :attr:`.TypeEngine.comparator_factory` RJ R t expressionsc C@ s� | j } i | d 6| d 6| d 6| j j d 6} | } | j j rk | } | j j j | � } | | d <n | j | � j i d d 6| d 6� S( s� annotate and possibly adapt a column to be returned as the mapped-attribute exposed version of the column. The column in this context needs to act as much like the column in an ORM mapped context as possible, so includes annotations to give hints to various ORM functions as to the source entity of this column. It also adapts it to the mapper's with_polymorphic selectable if one is present. t entity_namespaceRL t parentmappert proxy_keyt adapt_columnt ormt compile_state_plugint plugin_subject( t _parententityt propRD t _parentmappert _polymorphic_adaptert traverset _annotatet _set_propagate_attrs( R3 R t pet annotationsR6 t mapper_local_col( ( sL /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/properties.pyt _orm_annotate_columnZ s c C@ sD | j r) | j | j j d | j j � S| j | j j d � Sd S( Ni ( t adapterRt R RD R} ( R3 ( ( sL /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/properties.pyt# _memoized_method___clause_element__� s c C@ s6 | j � } y | j SWn t k r1 | j j SXd S( s( The .info dictionary for this attribute.N( RJ R t AttributeErrorRt ( R3 t ce( ( sL /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/properties.pyt _memoized_attr_info� s c C@ sb | j r8 g | j j D] } | j | | j j � ^ q Sg | j j D] } | j | � ^ qE Sd S( s� The full sequence of columns referenced by this attribute, adjusted for any aliasing in progress. .. versionadded:: 1.3.17 N( R~ Rt R RD R} ( R3 R6 ( ( sL /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/properties.pyt _memoized_attr_expressions� s ,c C@ s t | j � | � S( s� proxy attribute access down to the mapped column. this allows user-defined comparison methods to be accessed. ( R, RJ ( R3 RD ( ( sL /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/properties.pyt _fallback_getattr� s c O@ s | | j � | | � S( N( RJ ( R3 t opt otherR4 ( ( sL /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/properties.pyt operate� s c K@ s( | j � } | | j | | � | | � S( N( RJ t _bind_param( R3 R� R� R4 R6 ( ( sL /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/properties.pyt reverse_operate� s ( RJ R Rk ( R. t __module__t __doc__t __slots__R} R R� R� R� R� R� ( ( ( sL /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/properties.pyR* E s ( c C@ s t | j j j � d | j S( Nt .( t strR: RN R. RD ( R3 ( ( sL /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/properties.pyt __str__� s ( R R R R R R R R R R R R R R R R R R ( R. R� R� t strategy_wildcard_keyR( t inherit_cacheR' t _links_to_entityR� R" R< R t preload_moduleRG RH RJ t propertyRI RP RQ RW R t PASSIVE_OFFR\ Rj t MemoizedSlotsR R* R� ( ( ( sL /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/properties.pyR & sF � kN( R� t __future__R t R t descriptor_propsR R R t interfacesR R t relationshipsR R R t sqlR R t __all__t class_loggerR ( ( ( sL /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/properties.pyt <module> s&