summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
Diffstat (limited to 'docs')
-rw-r--r--docs/topics/files.txt17
1 files changed, 17 insertions, 0 deletions
diff --git a/docs/topics/files.txt b/docs/topics/files.txt
index 88f2bc9049..ce8a5c75a0 100644
--- a/docs/topics/files.txt
+++ b/docs/topics/files.txt
@@ -55,6 +55,23 @@ it has all the methods and attributes described below.
file name used on disk cannot be relied on until after the model has been
saved.
+For example, you can change the file name by setting the file's
+:attr:`~django.core.files.File.name` to a path relative to the file storage's
+location (:setting:`MEDIA_ROOT` if you are using the default
+:class:`~django.core.files.storage.FileSystemStorage`)::
+
+ >>> import os
+ >>> from django.conf import settings
+ >>> initial_path = car.photo.path
+ >>> car.photo.name = 'cars/chevy_ii.jpg'
+ >>> new_path = settings.MEDIA_ROOT + car.photo.name
+ >>> # Move the file on the filesystem
+ >>> os.rename(initial_path, new_path)
+ >>> car.save()
+ >>> car.photo.path
+ '/media/cars/chevy_ii.jpg'
+ >>> car.photo.path == new_path
+ True
The ``File`` object
===================