From 1b4daa2c01acda1a47503312f9d1ccb39c7c5fa5 Mon Sep 17 00:00:00 2001 From: collerek Date: Mon, 28 Mar 2022 12:57:48 +0200 Subject: [PATCH] add _default clarification in docs --- docs/queries/create.md | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/docs/queries/create.md b/docs/queries/create.md index 09cc560..76b5d2e 100644 --- a/docs/queries/create.md +++ b/docs/queries/create.md @@ -63,6 +63,9 @@ Combination of create and get methods. Tries to get a row meeting the criteria and if `NoMatch` exception is raised it creates a new one with given kwargs and _defaults. +When `_defaults` dictionary is provided the values set in `_defaults` will **always** be set, including overwriting explicitly provided values. +i.e. `get_or_create(_defaults: {"title": "I win"}, title="never used")` will always use "I win" as title whether you provide your own value in kwargs or not. + ```python class Album(ormar.Model): class Meta: @@ -187,4 +190,4 @@ from other side of the relation. [models-save]: ../models/methods.md#save [models-upsert]: ../models/methods.md#upsert [models-save-related]: ../models/methods.md#save_related -[querysetproxy]: ../relations/queryset-proxy.md \ No newline at end of file +[querysetproxy]: ../relations/queryset-proxy.md