HEX

File: //opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/__init__.pyo
�
��4]c@s�dZddlmZddlmZddlmZddlmZddlmZddlm	Z	ddl
mZdd	l
mZdd
l
m
Z
ddlmZddlmZdd
lmZddlmZddlmZddlmZddlmZddlmZddlmZddlmZddlmZddlmZddlmZddlmZddlm Z ddlm!Z!ddlm"Z"ddl#m$Z$ddl%m&Z&ddl%m'Z'ddl%m(Z(dd l%m)Z)dd!l%m*Z*dd"l%m+Z+dd#lm,Z,dd$l-m.Z.dd%l-m/Z/dd&l-m0Z0dd'l-m1Z1dd(l-m2Z2dd)l-m3Z3dd*l-m4Z4dd+l-m5Z5d,d-lm6Z7d,d.lm-Z8d,d/l9m:Z:dEd0�Z<e:e!d1�Z=d2�Z>d3�Z?e:ed4�Z@e:ed5�ZAd6�ZBd7�ZCd8�ZDe:ed9�Ze:e
d:�ZEe:ed;�ZFe8jGd<d=d>�d?��ZHd@�ZIejJjKZJejJjLZMejNjKZNejOjKZOejPjKZPejQjKZQejRjKZRejSjKZSejTjKZTejUjLZUejVjKZVejWjLZWejXjKZXejYjLZYejZjKZZej[jKZ[ej\jKZ\ej]jKZ]ej^jKZ^dA�Z_dB�Z`e:edC�ZadD�Zbebec��dES(Fs�
Functional constructs for ORM configuration.

See the SQLAlchemy object relational tutorial and mapper configuration
documentation for an overview of how this module is used.

i(texc(tmapper(tstrategy_options(tAttributeExtension(tMapperExtension(tSessionExtension(tComparableProperty(tCompositeProperty(tSynonymProperty(tEXT_CONTINUE(tEXT_SKIP(tEXT_STOP(tPropComparator(t_mapper_registry(tclass_mapper(tconfigure_mappers(tMapper(t
reconstructor(t	validates(tColumnProperty(tAliasOption(tBundle(tQuery(tforeign(tRelationshipProperty(tremote(tscoped_session(tclose_all_sessions(tmake_transient(tmake_transient_to_detached(tobject_session(tSession(tsessionmaker(tLoad(taliased(tjoin(t
object_mapper(t	outerjoin(tpolymorphic_union(twas_deleted(twith_parent(twith_polymorphici(tsql(tutil(tpublic_factorycKs@|jdt�|jdt�|jdt�td||�S(s�Create a new :class:`.Session`
    with no automation enabled by default.

    This function is used primarily for testing.   The usual
    route to :class:`.Session` creation is via its constructor
    or the :func:`.sessionmaker` function.

    :param bind: optional, a single Connectable to use for all
      database access in the created
      :class:`~sqlalchemy.orm.session.Session`.

    :param \*\*kwargs: optional, passed through to the
      :class:`.Session` constructor.

    :returns: an :class:`~sqlalchemy.orm.session.Session` instance

    The defaults of create_session() are the opposite of that of
    :func:`sessionmaker`; ``autoflush`` and ``expire_on_commit`` are
    False, ``autocommit`` is True.  In this sense the session acts
    more like the "classic" SQLAlchemy 0.3 session with these.

    Usage::

      >>> from sqlalchemy.orm import create_session
      >>> session = create_session()

    It is recommended to use :func:`sessionmaker` instead of
    create_session().

    t	autoflusht
autocommittexpire_on_committbind(t
setdefaulttFalsetTrueR(R0tkwargs((sJ/opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/__init__.pytcreate_session?ss.orm.relationshipcOs
t||�S(s#A synonym for :func:`relationship`.(trelationship(targtkw((sJ/opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/__init__.pytrelationgscKsd|d<t||�S(siConstruct a dynamically-loading mapper property.

    This is essentially the same as
    using the ``lazy='dynamic'`` argument with :func:`relationship`::

        dynamic_loader(SomeClass)

        # is the same as

        relationship(SomeClass, lazy="dynamic")

    See the section :ref:`dynamic_relationship` for more details
    on dynamic loading.

    tdynamictlazy(R6(targumentR8((sJ/opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/__init__.pytdynamic_loaderms
s.orm.column_propertys.orm.compositecKs
||fS(s�Create a back reference with explicit keyword arguments, which are the
    same arguments one can send to :func:`relationship`.

    Used with the ``backref`` keyword argument to :func:`relationship` in
    place of a string argument, e.g.::

        'items':relationship(
            SomeItem, backref=backref('parent', lazy='subquery'))

    .. seealso::

        :ref:`relationships_backref`

    ((tnameR4((sJ/opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/__init__.pytbackref�scOstdt||�S(s�Indicate a column-based mapped attribute that by default will
    not load unless accessed.

    :param \*columns: columns to be mapped.  This is typically a single
     :class:`.Column` object, however a collection is supported in order
     to support multiple columns mapped under the same attribute.

    :param \**kw: additional keyword arguments passed to
     :class:`.ColumnProperty`.

    .. seealso::

        :ref:`deferred`

    tdeferred(RR3(tcolumnsR8((sJ/opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/__init__.pyR@�scCs(ttj��}dtff|_|S(s�Indicate an attribute that populates from a query-time SQL expression.

    .. versionadded:: 1.2

    .. seealso::

        :ref:`mapper_query_expression`

    tquery_expression(Rt_sqltnullR3tstrategy_key(tprop((sJ/opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/__init__.pyRB�s
s.orm.mappers.orm.synonyms.orm.comparable_propertys0.7tmessagesv:func:`.compile_mappers` is deprecated and will be removed in a future release.  Please use :func:`.configure_mappers`cCst�dS(sZInitialize the inter-mapper relationships of all mappers that have
    been defined.

    N(R(((sJ/opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/__init__.pytcompile_mappers�s
cCsgtjj�zEx>trPy tj�\}}|j�Wqtk
rLqXqWWdtjj�XdS(sRemove all mappers from all classes.

    This function removes all instrumentation from classes and disposes
    of their associated mappers.  Once called, the classes are unmapped
    and can be later re-mapped with new mappers.

    :func:`.clear_mappers` is *not* for normal use, as there is literally no
    valid usage for it outside of very specific testing scenarios. Normally,
    mappers are permanent structural components of user-defined classes, and
    are never discarded independently of their class.  If a mapped class
    itself is garbage collected, its mapper is automatically disposed of as
    well. As such, :func:`.clear_mappers` is only for usage in test suites
    that re-use the same classes with different mappings, which is itself an
    extremely rare use case - the only such use case is in fact SQLAlchemy's
    own test suite, and possibly the test suites of other ORM extension
    libraries which intend to test various combinations of mapper construction
    upon a fixed set of classes.

    N(t	mapperlibt_CONFIGURE_MUTEXtacquireR
tpopitemtdisposetKeyErrortrelease(Rtb((sJ/opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/__init__.pyt
clear_mappers�s
	
cOs
t||�S(s#A synonym for :func:`joinedload()`.(t
joinedload(targsR4((sJ/opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/__init__.pyt	eagerloadscOs
t||�S(s&A synonym for :func:`joinedload_all()`(tjoinedload_all(RSR4((sJ/opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/__init__.pyt
eagerload_allss.orm.contains_aliascs�ddlm}ddlm}ddlm}ddlm}ddl�t�fd�|j�D��at	j
jd	�t	j
jd
�dS(Ni(R+i(R:(tevents(tloadingi����c3s9|]/\}}|jd�p*�j|�s|VqdS(t_N(t
startswithtismodule(t.0R>tobj(t_inspect(sJ/opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/__init__.pys	<genexpr>s	ssqlalchemy.ormssqlalchemy.ext(tR+R:RWRXtinspecttsortedtitemst__all__t_sa_utiltdependenciestresolve_all(tlclstsa_utilR:RWRX((R^sJ/opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/__init__.pyt__gosN(dt__doc__R_RRRIRtdeprecated_interfacesRRRtdescriptor_propsRRRt
interfacesR	R
RRR
RRRRRt
propertiesRtqueryRRRt
relationshipsRRRtscopingRtsessionRRRRRR R!R+R"R#R$R%R&R'R(R)R*RCRdtutil.langhelpersR,tNoneR5R6R9R=tcolumn_propertyt	compositeR?R@RBtsynonymtcomparable_propertyt
deprecatedRHRQRRt_unbound_fnt_unbound_all_fnRUtcontains_eagertdefertundefert
undefer_grouptwith_expressiont	load_onlytlazyloadtlazyload_alltsubqueryloadtsubqueryload_alltselectinloadtselectinload_allt
immediateloadtnoloadt	raiseloadtdefaultloadtselectin_polymorphicRTRVtcontains_aliasRitlocals(((sJ/opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/orm/__init__.pyt<module>s�%						!