Opened 12 years ago
Closed 12 years ago
#22346 closed Uncategorized (invalid)
ModelForm modifies the Model instance before save is called
| Reported by: | Owned by: | nobody | |
|---|---|---|---|
| Component: | Forms | Version: | 1.6 |
| Severity: | Normal | Keywords: | |
| Cc: | Triage Stage: | Unreviewed | |
| Has patch: | no | Needs documentation: | no |
| Needs tests: | no | Patch needs improvement: | no |
| Easy pickings: | no | UI/UX: | no |
Description
So here is a use case that is relevant to me:
I need a model instance's primary key(pk) before I save the model, but only after the model form is validated. In particular I needed it to use in a pre_save method on a file field. So my logical solution was:
try:
instance = CustomModel.objects.get(pk=pk)
except CustomModel.DoesNotExist:
instance = CustomModel()
form = CustomModelForm(instance=instance, data=request.POST, files=request.FILES))
if form.is_valid():
if not instance.pk:
instance.save() # saves the model while generating a pk
instance = form.save()
To my disappointment, after a few wasted hours, I figured out that binding data to a model instance modifies that instance, so when I am calling instance.save() it already contains data from the form, before even calling form.save() method.
After finding this ticket: #14885 I also noticed that it may be a partial update of the model instance. Despite closed ticket I couldn't find it in current documentation.
In my opinion it is completely illogical. Model instance should only be modified only upon form.save() call, this would also give a real use case for the existence of commit=False argument: "apply cleaned form data to model instance, but do not commit to database."
Even documentation follows the logic I am proposing: "A subclass of ModelForm can accept an existing model instance as the keyword argument instance; if this is supplied, save() will update that instance"
Overall it sounds to me like a side effect or a bug. If it truly is an unavoidable side-effect, I believe, we should get at least a really good explanation of it in the documentation.
Never mind, I just found a Warning in Documentation, and it actually makes sense, since model fields need to be validate as well.