]> 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:11 +0000 (18:59 -0400)
commit769f568c54a1cfae66735128c442758602ca755e
treecfa659c0e178b9a234d46303b1eed6467f11bc1a
parentbd237bc3a95148c60a48079359673419e30e6dde
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