Classe « InstanceEvents »

Méthode sqlalchemy.orm.InstanceEvents.init_failure

Signature de la méthode init_failure

def init_failure(self, target, args, kwargs) 

Description

init_failure.__doc__

Receive an instance when its constructor has been called,
and raised an exception.

.. container:: event_signatures

     Example argument forms::

        from sqlalchemy import event


        @event.listens_for(SomeClass, 'init_failure')
        def receive_init_failure(target, args, kwargs):
            "listen for the 'init_failure' event"

            # ... (event handling logic) ...


This method is only called during a userland construction of
an object, in conjunction with the object's constructor, e.g.
its ``__init__`` method. It is not called when an object is loaded
from the database.

The event is invoked after an exception raised by the ``__init__``
method is caught.  After the event
is invoked, the original exception is re-raised outwards, so that
the construction of the object still raises an exception.   The
actual exception and stack trace raised should be present in
``sys.exc_info()``.

:param target: the mapped instance.  If
 the event is configured with ``raw=True``, this will
 instead be the :class:`.InstanceState` state-management
 object associated with the instance.
:param args: positional arguments that were passed to the ``__init__``
 method.
:param kwargs: keyword arguments that were passed to the ``__init__``
 method.

.. seealso::

    :meth:`.InstanceEvents.init`

    :meth:`.InstanceEvents.load`