ó H`¾Tc@@s›dZddlmZddlmZmZddlmZddlm Z ej dƒZ ej d ƒZ d „Z d „Zd „Zd „Zd„ZdS(s,Public API functions for the event system. i(tabsolute_importi(tutiltexci(t _registrars(t _EventKeytCANCELt NO_RETVALcC@s`xYt|D]4}|j|ƒ}|dk r t||||ƒSq Wtjd||fƒ‚dS(Ns"No such event '%s' for target '%s'(Rt _accept_withtNoneRRtInvalidRequestError(ttargett identifiertfntevt_clsttgt((sZ/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/event/api.pyt _event_keys   cO@s t|||ƒj||ŽdS(s<Register a listener function for the given target. e.g.:: from sqlalchemy import event from sqlalchemy.schema import UniqueConstraint def unique_constraint_name(const, table): const.name = "uq_%s_%s" % ( table.name, list(const.columns)[0].name ) event.listen( UniqueConstraint, "after_parent_attach", unique_constraint_name) A given function can also be invoked for only the first invocation of the event using the ``once`` argument:: def on_config(): do_config() event.listen(Mapper, "before_configure", on_config, once=True) .. versionadded:: 0.9.4 Added ``once=True`` to :func:`.event.listen` and :func:`.event.listens_for`. N(Rtlisten(R R R targstkw((sZ/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/event/api.pyRs c@s‡‡‡‡fd†}|S(sDecorate a function as a listener for the given target + identifier. e.g.:: from sqlalchemy import event from sqlalchemy.schema import UniqueConstraint @event.listens_for(UniqueConstraint, "after_parent_attach") def unique_constraint_name(const, table): const.name = "uq_%s_%s" % ( table.name, list(const.columns)[0].name ) A given function can also be invoked for only the first invocation of the event using the ``once`` argument:: @event.listens_for(Mapper, "before_configure", once=True) def on_config(): do_config() .. versionadded:: 0.9.4 Added ``once=True`` to :func:`.event.listen` and :func:`.event.listens_for`. c@stˆˆ|ˆˆŽ|S(N(R(R (R RRR (sZ/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/event/api.pytdecorate]s((R R RRR((R RR RsZ/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/event/api.pyt listens_forBscC@st|||ƒjƒdS(s,Remove an event listener. The arguments here should match exactly those which were sent to :func:`.listen`; all the event registration which proceeded as a result of this call will be reverted by calling :func:`.remove` with the same arguments. e.g.:: # if a function was registered like this... @event.listens_for(SomeMappedClass, "before_insert", propagate=True) def my_listener_function(*arg): pass # ... it's removed like this event.remove(SomeMappedClass, "before_insert", my_listener_function) Above, the listener function associated with ``SomeMappedClass`` was also propagated to subclasses of ``SomeMappedClass``; the :func:`.remove` function will revert all of these operations. .. versionadded:: 0.9.0 N(Rtremove(R R R ((sZ/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/event/api.pyRcscC@st|||ƒjƒS(s`Return True if the given target/ident/fn is set up to listen. .. versionadded:: 0.9.0 (Rtcontains(R R R ((sZ/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/event/api.pyRsN(t__doc__t __future__RtRRtbaseRtregistryRtsymbolRRRRRRR(((sZ/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/event/api.pyt s # !