From: jonathan vanasco <jonathan@2xlp.com>
Date: Mon, 27 Sep 2021 19:53:03 +0000 (-0400)
Subject: Fixes: #5151
X-Git-Tag: rel_1_4_26~58^2
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=e40bd0b565dd52f45e25371a2b5fd199cff92b32;p=thirdparty%2Fsqlalchemy%2Fsqlalchemy.git

Fixes: #5151

document `listen=True` on `before_create`

Change-Id: I0804ee073044d879eb0decafeb1b358741d69f02
---

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):