[Python-checkins] r62914 - python/trunk/Doc/library/tempfile.rst

[skip.montanaro]

Author: skip.montanaro
Date: Fri May  9 02:45:00 2008
New Revision: 62914

Log:
Add an example about using NamedTemporaryFile() to replace mktemp().  I'm
unclear whether the verbatim text should have been indented or by how much.



Modified:
   python/trunk/Doc/library/tempfile.rst

Modified: python/trunk/Doc/library/tempfile.rst
==============================================================================
--- python/trunk/Doc/library/tempfile.rst	(original)
+++ python/trunk/Doc/library/tempfile.rst	Fri May  9 02:45:00 2008
@@ -167,6 +167,24 @@
       Use of this function may introduce a security hole in your program.
       By the time you get around to doing anything with the file name it
       returns, someone else may have beaten you to the punch.
+      :func:`mktemp` usage can be replaced easily with
+      :func:`NamedTemporaryFile`, passing it the  `delete=False` parameter ::
+
+   >>> f = NamedTemporaryFile(delete=False)
+   >>> print f.name
+   >>> f.write("Hello World!\n")
+   >>> f.close()
+   >>> os.unlink(f.name)
+   >>> f = NamedTemporaryFile(delete=False)
+   >>> f
+   <open file '<fdopen>', mode 'w+b' at 0x384698>
+   >>> f.name
+   '/var/folders/5q/5qTPn6xq2RaWqk+1Ytw3-U+++TI/-Tmp-/tmpG7V1Y0'
+   >>> f.write("Hello World!\n")
+   >>> f.close()
+   >>> os.unlink(f.name)
+   >>> os.path.exists(f.name)
+   False
 
 The module uses two global variables that tell it how to construct a
 temporary name.  They are initialized at the first call to any of the