From e40bd0b565dd52f45e25371a2b5fd199cff92b32 Mon Sep 17 00:00:00 2001 From: jonathan vanasco Date: Mon, 27 Sep 2021 15:53:03 -0400 Subject: [PATCH] Fixes: #5151 document `listen=True` on `before_create` Change-Id: I0804ee073044d879eb0decafeb1b358741d69f02 --- lib/sqlalchemy/sql/events.py | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/lib/sqlalchemy/sql/events.py b/lib/sqlalchemy/sql/events.py index a6c5c8e286..db80b51e35 100644 --- a/lib/sqlalchemy/sql/events.py +++ b/lib/sqlalchemy/sql/events.py @@ -105,12 +105,17 @@ class DDLEvents(event.Events): event, the checkfirst flag, and other elements used by internal events. - :func:`.event.listen` also accepts the ``propagate=True`` + :func:`.event.listen` accepts the ``propagate=True`` modifier for this event; when True, the listener function will be established for any copies made of the target object, i.e. those copies that are generated when :meth:`_schema.Table.to_metadata` is used. + :func:`.event.listen` accepts the ``insert=True`` + modifier for this event; when True, the listener function will + be prepended to the internal list of events upon discovery, and execute + before registered listener functions that do not pass this argument. + """ def after_create(self, target, connection, **kw): -- 2.47.3