ó ¿b›]c@@s²dZddlmZddlmZddlmZddlmZddlm Z dd lm Z dd lmZdd l m Z d gZ e jd efd „ƒYƒZdS(s|MapperProperty implementations. This is a private module which defines the behavior of individual ORM- mapped attributes. i(tabsolute_importi(t attributes(tPropComparator(tStrategizedProperty(t_orm_full_deannotatei(tlog(tutil(t expressiontColumnPropertycB@sÀeZdZdZd#Zejd d$ƒd„ƒZejddƒd„ƒZ d„Z e d„ƒZ d„Z d„Zd„Zejd„Zd„Zd ejefd!„ƒYZd"„ZRS(%sDescribes an object attribute that corresponds to a table column. Public constructor is the :func:`.orm.column_property` function. tcolumnt _orig_columnstcolumnstgrouptdeferredt instrumenttcomparator_factoryt descriptort extensiontactive_historytexpire_on_flushtinfotdoct strategy_keyt_creation_ordert_is_polymorphic_discriminatort_mapped_by_synonymt_deferred_column_loaders0.7sÃ:class:`.AttributeExtension` is deprecated in favor of the :class:`.AttributeEvents` listener interface. The :paramref:`.column_property.extension` parameter will be removed in a future release.cO@s tt|ƒjƒg|D]}tj|ƒ^q|_g|D]}tjt|ƒƒ^q?|_|jddƒ|_ |jdt ƒ|_ |jdt ƒ|_|jd|jjƒ|_|jddƒ|_|jddƒ|_|jdt ƒ|_|jdt ƒ|_d |kr2|jd ƒ|_nd |krS|jd ƒ|_nNxKt|jƒD]1}t|d dƒ}|dk rc||_PqcqcWd|_|rÛtd |jjd jt|jƒƒƒfƒ‚ntj |ƒd|j fd |jff|_!dS(s\ Provide a column-level property for use with a Mapper. Column-based properties can normally be applied to the mapper's ``properties`` dictionary using the :class:`.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. 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 extension: an :class:`.AttributeExtension` instance, or list of extensions, which will be prepended to the list of attribute listeners for the resulting descriptor placed on the class. R R t _instrumentRRRRRRRs.%s received unexpected keyword argument(s): %ss, RN("tsuperRt__init__Rt_labeledR RR tpoptNoneR tFalseR tTrueRt __class__t ComparatorRRRRRRRtreversedtgetattrt TypeErrort__name__tjointsortedtkeysRtset_creation_orderR(tselfR tkwargstctcolR((s8lib/python2.7/site-packages/sqlalchemy/orm/properties.pyR:s:K%+     .  ssqlalchemy.orm.statessqlalchemy.orm.strategiescC@s+|jj|jj|j|jƒ|jƒS(N(t InstanceStatet"_instance_level_callable_processortparentt class_managertLoadDeferredColumnstkey(R-tstatet strategies((s8lib/python2.7/site-packages/sqlalchemy/orm/properties.pyt&_memoized_attr__deferred_column_loader°s  cC@s|jS(ssAllow the ColumnProperty to work in expression before it is turned into an instrumented attribute. (R(R-((s8lib/python2.7/site-packages/sqlalchemy/orm/properties.pyt__clause_element__¸scC@s |jdS(sJReturn the primary column or expression for this ColumnProperty. i(R (R-((s8lib/python2.7/site-packages/sqlalchemy/orm/properties.pyR¿sc C@sH|js dStj|j|jd|j||ƒd|d|jƒdS(Nt comparatort parententityR(RRtregister_descriptortclass_R6RR(R-tmapper((s8lib/python2.7/site-packages/sqlalchemy/orm/properties.pytinstrument_classÆs  cC@s~tt|ƒjƒt|jƒdkrzt|jjƒj|jƒrzt j d|j|jd|jd|j fƒndS(Nis»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( RRtdo_inittlenR tsetR3t primary_keyt issupersetRtwarnR6(R-((s8lib/python2.7/site-packages/sqlalchemy/orm/properties.pyRAÒs ' cC@s(td|jd|jd|j|jŒS(NR R R(RR R RR (R-((s8lib/python2.7/site-packages/sqlalchemy/orm/properties.pytcopyás   cC@s"|j|jƒj||d|ƒS(Ntpassive(tget_implR6tget_committed_value(R-R7tdict_R RH((s8lib/python2.7/site-packages/sqlalchemy/orm/properties.pyt _getcommittedésc C@s¥|js dS|j|krj||j} |s?| ||jR(R6(R-((s8lib/python2.7/site-packages/sqlalchemy/orm/properties.pyt__str__As(R R R R RRRRRRRRRRRRR(s0.7sÃ:class:`.AttributeExtension` is deprecated in favor of the :class:`.AttributeEvents` listener interface. The :paramref:`.column_property.extension` parameter will be removed in a future release.(R(RjRktstrategy_wildcard_keyRlRtdeprecated_paramsRt dependenciesR9R:tpropertyRR@RARGRt PASSIVE_OFFRLRZt MemoizedSlotsRR$Ro(((s8lib/python2.7/site-packages/sqlalchemy/orm/properties.pyRs@ s    7N(Rkt __future__RtRt interfacesRRRRRtsqlRt__all__t class_loggerR(((s8lib/python2.7/site-packages/sqlalchemy/orm/properties.pyt s