]> git.ipfire.org Git - thirdparty/sqlalchemy/sqlalchemy.git/commit
Clarify INSERT/UPDATE defaults vs. data marshalling
authorMike Bayer <mike_mp@zzzcomputing.com>
Sat, 10 Aug 2019 22:17:59 +0000 (18:17 -0400)
committerMike Bayer <mike_mp@zzzcomputing.com>
Sat, 10 Aug 2019 22:58:51 +0000 (18:58 -0400)
commit41fd7d40c21cc21e42706212024413c5f6ef78d7
treec31f05edbaa70414e306d61350dc64a36fc20899
parent622571e758942297bd7aae656ae09062049a41b5
Clarify INSERT/UPDATE defaults vs. data marshalling

- Add a full introductory paragraph to INSERT/UPDATE defaults
stating what we mean when we talk about this concept.  Add a note
differentiating what a default does, vs. a rule that intercepts
data as it moves into the database, providing links

- Add a quick section referring to TypeDecorator in the ORM
section on modifying attribute behavior

- Add an "ORM tip", a new thing that we can use in Core to link
to ORM concepts when useful, in the TypeDecorator section which
mentions that for more open ended conversion of arbitrary user
data based on business rules, @validates might be useful
(although this still does not suit the case of full blown form
validation).

- add glossary entries for DML, data marshalling since we already
use these terms and I'd like to refer to them more often.

Fixes: #4796
Change-Id: Ic4cd5c1595fd51c00a9bf24c021d2e56d457d346
(cherry picked from commit cda0b4a2b909be55cef7a844a04689ec527041c0)
doc/build/core/custom_types.rst
doc/build/core/defaults.rst
doc/build/core/events.rst
doc/build/glossary.rst
doc/build/orm/events.rst
doc/build/orm/mapped_attributes.rst