Called before a series of mappers have been configured. The :meth:`.MapperEvents.before_configured` event is invoked each time the :func:`_orm.configure_mappers` function is invoked, before the function has done any of its work. :func:`_orm.configure_mappers` is typi
(self)
| 1067 | |
| 1068 | @event._omit_standard_example |
| 1069 | def before_configured(self) -> None: |
| 1070 | """Called before a series of mappers have been configured. |
| 1071 | |
| 1072 | The :meth:`.MapperEvents.before_configured` event is invoked |
| 1073 | each time the :func:`_orm.configure_mappers` function is |
| 1074 | invoked, before the function has done any of its work. |
| 1075 | :func:`_orm.configure_mappers` is typically invoked |
| 1076 | automatically as mappings are first used, as well as each time |
| 1077 | new mappers have been made available and new mapper use is |
| 1078 | detected. |
| 1079 | |
| 1080 | Similar events to this one include |
| 1081 | :meth:`.MapperEvents.after_configured`, which is invoked after a series |
| 1082 | of mappers has been configured, as well as |
| 1083 | :meth:`.MapperEvents.before_mapper_configured` and |
| 1084 | :meth:`.MapperEvents.mapper_configured`, which are both invoked on a |
| 1085 | per-mapper basis. |
| 1086 | |
| 1087 | This event can **only** be applied to the :class:`_orm.Mapper` class, |
| 1088 | and not to individual mappings or mapped classes:: |
| 1089 | |
| 1090 | from sqlalchemy.orm import Mapper |
| 1091 | |
| 1092 | |
| 1093 | @event.listens_for(Mapper, "before_configured") |
| 1094 | def go(): ... |
| 1095 | |
| 1096 | Typically, this event is called once per application, but in practice |
| 1097 | may be called more than once, any time new mappers are to be affected |
| 1098 | by a :func:`_orm.configure_mappers` call. If new mappings are |
| 1099 | constructed after existing ones have already been used, this event will |
| 1100 | likely be called again. |
| 1101 | |
| 1102 | .. seealso:: |
| 1103 | |
| 1104 | :meth:`.MapperEvents.before_mapper_configured` |
| 1105 | |
| 1106 | :meth:`.MapperEvents.mapper_configured` |
| 1107 | |
| 1108 | :meth:`.MapperEvents.after_configured` |
| 1109 | |
| 1110 | :meth:`.RegistryEvents.before_configured` |
| 1111 | |
| 1112 | :meth:`.RegistryEvents.after_configured` |
| 1113 | |
| 1114 | """ |
| 1115 | |
| 1116 | @event._omit_standard_example |
| 1117 | def after_configured(self) -> None: |
no outgoing calls
no test coverage detected