Skip to content
Browse files

Fixed #18154 -- Documentation on closing File objects and best practices

  • Loading branch information...
1 parent aee9eec commit ffa6d95f65363b7f4f9047ab11561880be29049a @gabejackson gabejackson committed with SmileyChris
Showing with 23 additions and 0 deletions.
  1. +23 −0 docs/topics/files.txt
23 docs/topics/files.txt
@@ -75,6 +75,29 @@ using a Python built-in ``file`` object::
Now you can use any of the documented attributes and methods
of the :class:`~django.core.files.File` class.
+Be aware that files created in this way are not automatically closed.
+The following approach may be used to close files automatically::
+ >>> from django.core.files import File
+ # Create a Python file object using open() and the with statement
+ >>> with open('/tmp/', 'w') as f:
+ >>> myfile = File(f)
+ >>> for line in myfile:
+ >>> print line
+ >>> myfile.closed
+ True
+ >>> f.closed
+ True
+Closing files is especially important when accessing file fields in a loop
+over a large number of objects:: If files are not manually closed after
+accessing them, the risk of running out of file descriptors may arise. This
+may lead to the following error:
+ IOError: [Errno 24] Too many open files
File storage

0 comments on commit ffa6d95

Please sign in to comment.
Something went wrong with that request. Please try again.