+h*dZddlmZddlmZddlmZddlmZddlmZddlm Z ddlm Z dd l m Z dd l mZdd l mZdd l mZdd l mZddl mZddl mZddl mZddl mZddlmZddlmZddlmZddlmZddlmZddlmZddlm Z ddlm!Z!ddlm"Z"ddlm#Z#ddlm$Z$ddlm%Z%ddlm&Z&ddlm'Z'dd lm(Z(dd!lm)Z)dd"l*m+Z+dd#l*m,Z,dd$lm-Z-dd%lm.Z.dd&lm/Z/dd'lm0Z0dd(lm1Z1dd)l2m3Z3dd*l4m5Z5dd+l4m6Z6dd,l4m7Z7dd-l8m9Z9dd.l8m:Z:dd/l8m;Z;dd0lm?Z?dd2l>m@Z@dd3l>mAZAdd4l>mBZBdd5l>mCZCdd6l>mDZDdd7l>mEZEdd8l>mFZFdd9lGmHZHdd:lGmIZIdd;lmJZJddlMmOZOdd?lMmPZPdd@lMmQZQddAlMmRZRddBlMmSZSddClMmTZTddDlMmUZUddElMmVZVddFlMmWZWddGlMmXZXdHdIlmYZZdHdJlmMZ[dHdKl\m]Z]dgdMZ^e]eRdNZ_e]e:dOZ`e[jdPdQdRZbdSZce]e3dTZde]edUZedVZfdWZgeZjfdXZie]e/dYZe]edZZjd[ZkejjZlejjZnejjZoejjZpejjZqejjZrejjZsejjZtejjZuejjZvejjZwejjZxejjZyejjZzejjZ{e[jd\d]d^Z|e]e5d_Z} dd`l~mZddal~mZddbl~mZddcl~mZdddl~mZddel~mZdfZeeyL)hz Functional constructs for ORM configuration. See the SQLAlchemy object relational tutorial and mapper configuration documentation for an overview of how this module is used. )exc)mapper)strategy_options)AttributeEvent)InstrumentedAttribute)Mapped)QueryableAttribute) QueryContext)as_declarative)declarative_base)declarative_mixin)DeclarativeMeta) declared_attr)has_inherited_table)registry) synonym_for)CompositeProperty)SynonymProperty) IdentityMap) ClassManager) EXT_CONTINUE)EXT_SKIP)EXT_STOP)InspectionAttr)InspectionAttrInfo) MANYTOMANY) MANYTOONE)MapperProperty) NOT_EXTENSION) ONETOMANY)PropComparator)UserDefinedOption)merge_frozen_result) merge_result) class_mapper)configure_mappers)Mapper) reconstructor) validatesColumnProperty) AliasOption) FromStatement)Query)foreign)RelationshipProperty)remote)scoped_session)close_all_sessions)make_transient)make_transient_to_detached)object_session)ORMExecuteState)Session) sessionmaker)SessionTransaction)AttributeState) InstanceState)Load)UOWTransaction)aliased)Bundle)CascadeOptions)join)LoaderCriteriaOption) object_mapper) outerjoin)polymorphic_union) was_deleted) with_parent)with_polymorphic)sqlutil)public_factoryNc |jddr|jddn|jdd|jdd|jddtdd|i|S) aCreate 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. .. deprecated:: 1.4 The "autocommit" parameter will be removed in SQLAlchemy 2.0. :func:`_orm.create_session` will return a :class:`_orm.Session` that does not include "autocommit' behavior in release 2.0. Usage:: >>> from sqlalchemy.orm import create_session >>> session = create_session() It is recommended to use :func:`sessionmaker` instead of create_session(). futureF autocommitT autoflushexpire_on_commitbind)get setdefaultr8)rTkwargss J/var/www/html/venv/lib/python3.12/site-packages/sqlalchemy/orm/__init__.pycreate_sessionrZ[sgJzz(E",.,- k5) (%0  ' ' ''z.ormz.orm.relationshiprelationz!Please use :func:`.relationship`.ct|i|S)z#A synonym for :func:`relationship`. relationship)argkws rYr\r\s  # ##r[c $d|d<t|fi|S)aiConstruct 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. dynamiclazyr^)argumentras rYdynamic_loaderrfs BvJ  'B ''r[z.orm.column_propertyz.orm.compositec ||fS)aWhen using the :paramref:`_orm.relationship.backref` parameter, provides specific parameters to be used when the new :func:`_orm.relationship` is generated. E.g.:: 'items':relationship( SomeItem, backref=backref('parent', lazy='subquery')) The :paramref:`_orm.relationship.backref` parameter is generally considered to be legacy; for modern applications, using explicit :func:`_orm.relationship` constructs linked together using the :paramref:`_orm.relationship.back_populates` parameter should be preferred. .. seealso:: :ref:`relationships_backref` - background on backrefs rU)namerXs rYbackrefris, &>r[ct|ddi|S)aIndicate 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:`_schema.Column` object, however a collection is supported in order to support multiple columns mapped under the same attribute. :param raiseload: boolean, if True, indicates an exception should be raised if the load operation is to take place. .. versionadded:: 1.4 .. seealso:: :ref:`deferred_raiseload` :param \**kw: additional keyword arguments passed to :class:`.ColumnProperty`. .. seealso:: :ref:`deferred` deferredTr*)columnsras rYrkrks4 ' 84 8R 88r[c*t|}d|_|S)aIndicate an attribute that populates from a query-time SQL expression. :param default_expr: Optional SQL expression object that will be used in all cases if not assigned later with :func:`_orm.with_expression`. E.g.:: from sqlalchemy.sql import literal class C(Base): #... my_expr = query_expression(literal(1)) .. versionadded:: 1.3.18 .. versionadded:: 1.2 .. seealso:: :ref:`mapper_querytime_expression` ))query_expressionT)r+ strategy_key) default_exprprops rYrnrns. , 'D5D Kr[z .orm.mapperz .orm.synonymcTtjtjdy)aRemove all mappers from all classes. .. versionchanged:: 1.4 This function now locates all :class:`_orm.registry` objects and calls upon the :meth:`_orm.registry.dispose` method of each. 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. FN) mapperlib_dispose_registries_all_registriesrUr[rY clear_mappersrvs2!!)";";"=uEr[ eagerloadz#Please use :func:`_orm.joinedload`.ct|i|S)z#A synonym for :func:`joinedload()`.) joinedload)argsrXs rYrwrw2s t &v &&r[z.orm.contains_alias)AttributeEvents) MapperEvents)InstanceEvents)InstrumentationEvents) QueryEvents) SessionEventsc ddlm}ddlm}ddlm}ddlm}ddlddlmatfd |jDa tjjd tjjd y) NrJrLr)rc)events)loading) AppenderQueryc3lK|]+\}}|jdsj|s|-yw)_N) startswithismodule).0rhobj_inspects rY z__go..Ns6 D#$(9(9#(> s14zsqlalchemy.ormzsqlalchemy.ext) rMrcrrinspectrsorteditems__all___sa_util preloaded import_prefix)lclssa_utilrcrrrs @rY__gorCs`#&G  $$%56 $$%56r[)N)__doc__rrrrsr attributesrrrr contextr decl_apir r r rrrrrdescriptor_propsrridentityrinstrumentationr interfacesrrrrrrrrrr r!r"rr#r$r%r&r'r(r) propertiesr+queryr,r-r. relationshipsr/r0r1scopingr2sessionr3r4r5r6r7r8r9r:stater;r<r= unitofworkr>rMr?r@rArBrCrDrErFrGrHrIrK_sqlrutil.langhelpersrNrZwith_loader_criteriar_ deprecated_20r\rfcolumn_property compositerirknullrnsynonymrvry _unbound_fncontains_eagerdeferundefer undefer_groupwith_expression load_onlylazyload subqueryload selectinload immediateloadnoload raiseload defaultloadselectin_polymorphicrwcontains_aliasrr{r|r}r~rrrlocalsrUr[rYrs!&-*!$&'%#)!/-!)$ &*"!&%!&)(! %!& "/!#'#/#$!'! "& &#"-,(^&&:FC24GH  $GH$I$ ((!1GH ,.> ? 29:#,$))+8  . . 9F8 ( ( 4 4 !00<<**  " " . . ..:: "22>>  & & 2 2  $ $ 0 0,,88 ,,88  ..::  , ,  & & 2 2 **66 '<<HH %JK'L'  -BC'$&-#%7*VXr[