σ H`ΎTc@@sͺdZddlmZddlmZmZddlmZddlmZddlm Z dd l m Z m Z d d d d dgZ ejd e fd„ƒYƒZdS(szMapperProperty implementations. This is a private module which defines the behavior of invidual ORM- mapped attributes. i(tabsolute_importi(tutiltlog(t expressioni(t attributes(t_orm_full_deannotate(tPropComparatortStrategizedPropertytColumnPropertytCompositePropertytSynonymPropertytComparablePropertytRelationshipPropertycB@s~eZdZdZd„Zed„ƒZd„Zd„Zd„Z e j d„Z d„Z d efd „ƒYZd „ZRS( sDescribes an object attribute that corresponds to a table column. Public constructor is the :func:`.orm.column_property` function. tcolumncO@sg|D]}tj|ƒ^q|_g|D]}tjt|ƒƒ^q,|_|jddƒ|_|jdtƒ|_ |jdt ƒ|_ |jd|j j ƒ|_|jddƒ|_|jddƒ|_|jdtƒ|_|jdt ƒ|_d |kr|jd ƒ|_nd |kr@|jd ƒ|_nNxKt|jƒD]1}t|d dƒ}|dk rP||_PqPqPWd|_|rΘtd |j jd jt|jƒƒƒfƒ‚ntj|ƒ|jd|j fd |j fƒ|_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. .. versionadded:: 0.6.6 :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. .. versionadded:: 0.7.3 :param info: Optional data dictionary which will be populated into the :attr:`.MapperProperty.info` attribute of this object. .. versionadded:: 0.8 :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. **Deprecated.** Please see :class:`.AttributeEvents`. tgrouptdeferredt _instrumenttcomparator_factoryt descriptort extensiontactive_historytexpire_on_flushtinfotdocs.%s received unexpected keyword argument(s): %ss, t instrumentN( Rt_labeledt _orig_columnsRtcolumnstpoptNoneRtFalseRtTrueRt __class__t ComparatorRRRRRRRtreversedtgetattrt TypeErrort__name__tjointsortedtkeysRtset_creation_ordert_strategy_lookuptstrategy_class(tselfRtkwargstctcolR((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/properties.pyt__init__%s>K%(       %  cC@s |jdS(sJReturn the primary column or expression for this ColumnProperty. i(R(R,((s_/var/www/send.findwatt.com/datamanager/lib/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_tkeyRR(R,tmapper((s_/var/www/send.findwatt.com/datamanager/lib/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( tsuperRtdo_inittlenRtsettparentt primary_keyt issupersetRtwarnR5(R,((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/properties.pyR9«scC@s(td|jd|jd|j|jŒS(NRRR(RRRRR(R,((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/properties.pytcopyΆs   cC@s"|j|jƒj||d|ƒS(Ntpassive(tget_implR5tget_committed_value(R,tstatetdict_R RA((s_/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/orm/properties.pyt _getcommitted½sc C@sŸ|js dS|j|krj||j}|s?|||j s