]> 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:57:51 +0000 (18:57 -0400)
commitcda0b4a2b909be55cef7a844a04689ec527041c0
tree24da6e56a6cb91c6e5ff1379c16b0244969e82c8
parent104e6907284e602a8485f32fc67fd6af0c00e4d0
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
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