Method delete

lib/sqlalchemy/orm/session.py:3623–3649

Mark an instance as deleted. The object is assumed to be either :term:`persistent` or :term:`detached` when passed; after the method is called, the object will remain in the :term:`persistent` state until the next flush proceeds. During this time, the object will al

(self, instance: object)

            self._save_or_update_impl(st_)

    def delete(self, instance: object) -> None:
        """Mark an instance as deleted.

        The object is assumed to be either :term:`persistent` or
        :term:`detached` when passed; after the method is called, the
        object will remain in the :term:`persistent` state until the next
        flush proceeds.  During this time, the object will also be a member
        of the :attr:`_orm.Session.deleted` collection.

        When the next flush proceeds, the object will move to the
        :term:`deleted` state, indicating a ``DELETE`` statement was emitted
        for its row within the current transaction.   When the transaction
        is successfully committed,
        the deleted object is moved to the :term:`detached` state and is
        no longer present within this :class:`_orm.Session`.

        .. seealso::

            :ref:`session_deleting` - at :ref:`session_basics`

            :meth:`.Session.delete_all` - multiple instance version

        """
        if self._warn_on_events:
            self._flush_warning("Session.delete()")

        self._delete_impl(object_state(instance), instance, head=True)

    def delete_all(self, instances: Iterable[object]) -> None:
        """Calls :meth:`.Session.delete` on multiple instances.