]> 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:59:01 +0000 (18:59 -0400)
commit6eda2baa1df815cd2104bb113afdd6f4865ed53c
tree34573964fa3977d2a8aae8569deded1d00b952d8
parent0d9dbf0564633fc37fa851ddd46fe6073d2bcfd9
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