mirrors/django
1
0
Fork 0
mirror of https://github.com/django/django.git synced 2025-08-31 07:47:37 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 2

Fixed #30736 -- Added Storage.get_alternative_name() to allow customization.

Browse source
This commit is contained in:
yukihira1992 2019-08-29 01:17:07 +09:00 • committed by Mariusz Felisiak
parent 400ec5125e
commit 0545781764
4 changed files with 31 additions and 11 deletions
Download patch file Download diff file Expand all files Collapse all files

10
docs/howto/custom-file-storage.txt
View file

@ -97,6 +97,12 @@ non-standard characters are converted to safe filenames.
The code provided on ``Storage`` retains only alpha-numeric characters, periods
and underscores from the original filename, removing everything else.
.. method:: get_alternative_name(file_root, file_ext)
Returns an alternative filename based on the ``file_root`` and ``file_ext``
parameters. By default, an underscore plus a random 7 character alphanumeric
string is appended to the filename before the extension.
.. method:: get_available_name(name, max_length=None)
Returns a filename that is available in the storage mechanism, possibly taking
@ -108,5 +114,5 @@ The length of the filename will not exceed ``max_length``, if provided. If a
free unique filename cannot be found, a :exc:`SuspiciousFileOperation
<django.core.exceptions.SuspiciousOperation>` exception is raised.
If a file with ``name`` already exists, an underscore plus a random 7 character
alphanumeric string is appended to the filename before the extension.
If a file with ``name`` already exists, ``get_alternative_name()`` is called to
obtain an alternative name.