#27145: Misunderstanding beetween documentation and docstring for Storage.save
method
--------------------------------------+--------------------
Reporter: pacahon | Owner: nobody
Type: Uncategorized | Status: new
Component: File uploads/storage | Version: 1.9
Severity: Normal | Keywords:
Triage Stage: Unreviewed | Has patch: 0
Easy pickings: 0 | UI/UX: 0
--------------------------------------+--------------------
Docstring for `django.core.files.storage.Storage.save` method says:
{{{
"""
Saves new content to the file specified by name. The content
should be
a proper File object or any python file-like object, ready to be
read
from the beginning.
"""
}}}
But in
[https://docs.djangoproject.com/en/1.9/ref/files/storage/#django.core.files.storage.Storage.save
docs] provided next description for `content` attribute
{{{
The content argument must be an instance of django.core.files.File or of a
subclass of File.
}}}
What about to update docs or add additional check in `save` method?
--
Ticket URL: <https://code.djangoproject.com/ticket/27145>
Django <https://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.
--
You received this message because you are subscribed to the Google Groups
"Django updates" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to [email protected].
To post to this group, send email to [email protected].
To view this discussion on the web visit
https://groups.google.com/d/msgid/django-updates/050.6cb6a38c16ebc88ea26e38655a0a2b2e%40djangoproject.com.
For more options, visit https://groups.google.com/d/optout.
