python-docs-fr/library/tempfile.po

# Copyright (C) 2001-2018, Python Software Foundation
# For licence information, see README file.
#
msgid ""
msgstr ""
"Project-Id-Version: Python 3.6\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2018-06-28 15:29+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: FRENCH <traductions@lists.afpy.org>\n"
"Language: fr\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"

#: ../Doc/library/tempfile.rst:2
msgid ":mod:`tempfile` --- Generate temporary files and directories"
msgstr ""

#: ../Doc/library/tempfile.rst:9
msgid "**Source code:** :source:`Lib/tempfile.py`"
msgstr "**Code source :** :source:`Lib/tempfile.py`"

#: ../Doc/library/tempfile.rst:17
msgid ""
"This module creates temporary files and directories.  It works on all "
"supported platforms. :class:`TemporaryFile`, :class:`NamedTemporaryFile`, :"
"class:`TemporaryDirectory`, and :class:`SpooledTemporaryFile` are high-level "
"interfaces which provide automatic cleanup and can be used as context "
"managers. :func:`mkstemp` and :func:`mkdtemp` are lower-level functions "
"which require manual cleanup."
msgstr ""

#: ../Doc/library/tempfile.rst:24
msgid ""
"All the user-callable functions and constructors take additional arguments "
"which allow direct control over the location and name of temporary files and "
"directories. Files names used by this module include a string of random "
"characters which allows those files to be securely created in shared "
"temporary directories. To maintain backward compatibility, the argument "
"order is somewhat odd; it is recommended to use keyword arguments for "
"clarity."
msgstr ""

#: ../Doc/library/tempfile.rst:32
msgid "The module defines the following user-callable items:"
msgstr ""

#: ../Doc/library/tempfile.rst:36
msgid ""
"Return a :term:`file-like object` that can be used as a temporary storage "
"area. The file is created securely, using the same rules as :func:`mkstemp`. "
"It will be destroyed as soon as it is closed (including an implicit close "
"when the object is garbage collected).  Under Unix, the directory entry for "
"the file is either not created at all or is removed immediately after the "
"file is created.  Other platforms do not support this; your code should not "
"rely on a temporary file created using this function having or not having a "
"visible name in the file system."
msgstr ""

#: ../Doc/library/tempfile.rst:44
msgid ""
"The resulting object can be used as a context manager (see :ref:`tempfile-"
"examples`).  On completion of the context or destruction of the file object "
"the temporary file will be removed from the filesystem."
msgstr ""

#: ../Doc/library/tempfile.rst:49
msgid ""
"The *mode* parameter defaults to ``'w+b'`` so that the file created can be "
"read and written without being closed.  Binary mode is used so that it "
"behaves consistently on all platforms without regard for the data that is "
"stored.  *buffering*, *encoding* and *newline* are interpreted as for :func:"
"`open`."
msgstr ""

#: ../Doc/library/tempfile.rst:55
msgid ""
"The *dir*, *prefix* and *suffix* parameters have the same meaning and "
"defaults as with :func:`mkstemp`."
msgstr ""

#: ../Doc/library/tempfile.rst:58
msgid ""
"The returned object is a true file object on POSIX platforms.  On other "
"platforms, it is a file-like object whose :attr:`!file` attribute is the "
"underlying true file object."
msgstr ""

#: ../Doc/library/tempfile.rst:62
msgid ""
"The :py:data:`os.O_TMPFILE` flag is used if it is available and works (Linux-"
"specific, requires Linux kernel 3.11 or later)."
msgstr ""

#: ../Doc/library/tempfile.rst:67
msgid "The :py:data:`os.O_TMPFILE` flag is now used if available."
msgstr ""

#: ../Doc/library/tempfile.rst:72
msgid ""
"This function operates exactly as :func:`TemporaryFile` does, except that "
"the file is guaranteed to have a visible name in the file system (on Unix, "
"the directory entry is not unlinked).  That name can be retrieved from the :"
"attr:`name` attribute of the returned file-like object.  Whether the name "
"can be used to open the file a second time, while the named temporary file "
"is still open, varies across platforms (it can be so used on Unix; it cannot "
"on Windows NT or later).  If *delete* is true (the default), the file is "
"deleted as soon as it is closed. The returned object is always a file-like "
"object whose :attr:`!file` attribute is the underlying true file object. "
"This file-like object can be used in a :keyword:`with` statement, just like "
"a normal file."
msgstr ""

#: ../Doc/library/tempfile.rst:88
msgid ""
"This function operates exactly as :func:`TemporaryFile` does, except that "
"data is spooled in memory until the file size exceeds *max_size*, or until "
"the file's :func:`fileno` method is called, at which point the contents are "
"written to disk and operation proceeds as with :func:`TemporaryFile`."
msgstr ""

#: ../Doc/library/tempfile.rst:94
msgid ""
"The resulting file has one additional method, :func:`rollover`, which causes "
"the file to roll over to an on-disk file regardless of its size."
msgstr ""

#: ../Doc/library/tempfile.rst:97
msgid ""
"The returned object is a file-like object whose :attr:`_file` attribute is "
"either an :class:`io.BytesIO` or :class:`io.StringIO` object (depending on "
"whether binary or text *mode* was specified) or a true file object, "
"depending on whether :func:`rollover` has been called.  This file-like "
"object can be used in a :keyword:`with` statement, just like a normal file."
msgstr ""

#: ../Doc/library/tempfile.rst:104
msgid "the truncate method now accepts a ``size`` argument."
msgstr ""

#: ../Doc/library/tempfile.rst:110
msgid ""
"This function securely creates a temporary directory using the same rules "
"as :func:`mkdtemp`. The resulting object can be used as a context manager "
"(see :ref:`tempfile-examples`).  On completion of the context or destruction "
"of the temporary directory object the newly created temporary directory and "
"all its contents are removed from the filesystem."
msgstr ""

#: ../Doc/library/tempfile.rst:116
msgid ""
"The directory name can be retrieved from the :attr:`name` attribute of the "
"returned object.  When the returned object is used as a context manager, "
"the :attr:`name` will be assigned to the target of the :keyword:`as` clause "
"in the :keyword:`with` statement, if there is one."
msgstr ""

#: ../Doc/library/tempfile.rst:121
msgid ""
"The directory can be explicitly cleaned up by calling the :func:`cleanup` "
"method."
msgstr ""

#: ../Doc/library/tempfile.rst:129
msgid ""
"Creates a temporary file in the most secure manner possible.  There are no "
"race conditions in the file's creation, assuming that the platform properly "
"implements the :const:`os.O_EXCL` flag for :func:`os.open`.  The file is "
"readable and writable only by the creating user ID.  If the platform uses "
"permission bits to indicate whether a file is executable, the file is "
"executable by no one.  The file descriptor is not inherited by child "
"processes."
msgstr ""

#: ../Doc/library/tempfile.rst:137
msgid ""
"Unlike :func:`TemporaryFile`, the user of :func:`mkstemp` is responsible for "
"deleting the temporary file when done with it."
msgstr ""

#: ../Doc/library/tempfile.rst:140
msgid ""
"If *suffix* is not ``None``, the file name will end with that suffix, "
"otherwise there will be no suffix.  :func:`mkstemp` does not put a dot "
"between the file name and the suffix; if you need one, put it at the "
"beginning of *suffix*."
msgstr ""

#: ../Doc/library/tempfile.rst:145
msgid ""
"If *prefix* is not ``None``, the file name will begin with that prefix; "
"otherwise, a default prefix is used.  The default is the return value of :"
"func:`gettempprefix` or :func:`gettempprefixb`, as appropriate."
msgstr ""

#: ../Doc/library/tempfile.rst:149
msgid ""
"If *dir* is not ``None``, the file will be created in that directory; "
"otherwise, a default directory is used.  The default directory is chosen "
"from a platform-dependent list, but the user of the application can control "
"the directory location by setting the *TMPDIR*, *TEMP* or *TMP* environment "
"variables.  There is thus no guarantee that the generated filename will have "
"any nice properties, such as not requiring quoting when passed to external "
"commands via ``os.popen()``."
msgstr ""

#: ../Doc/library/tempfile.rst:157
msgid ""
"If any of *suffix*, *prefix*, and *dir* are not ``None``, they must be the "
"same type. If they are bytes, the returned name will be bytes instead of "
"str. If you want to force a bytes return value with otherwise default "
"behavior, pass ``suffix=b''``."
msgstr ""

#: ../Doc/library/tempfile.rst:163
msgid ""
"If *text* is specified, it indicates whether to open the file in binary mode "
"(the default) or text mode.  On some platforms, this makes no difference."
msgstr ""

#: ../Doc/library/tempfile.rst:167
msgid ""
":func:`mkstemp` returns a tuple containing an OS-level handle to an open "
"file (as would be returned by :func:`os.open`) and the absolute pathname of "
"that file, in that order."
msgstr ""

#: ../Doc/library/tempfile.rst:171 ../Doc/library/tempfile.rst:192
msgid ""
"*suffix*, *prefix*, and *dir* may now be supplied in bytes in order to "
"obtain a bytes return value.  Prior to this, only str was allowed. *suffix* "
"and *prefix* now accept and default to ``None`` to cause an appropriate "
"default value to be used."
msgstr ""

#: ../Doc/library/tempfile.rst:180
msgid ""
"Creates a temporary directory in the most secure manner possible. There are "
"no race conditions in the directory's creation.  The directory is readable, "
"writable, and searchable only by the creating user ID."
msgstr ""

#: ../Doc/library/tempfile.rst:184
msgid ""
"The user of :func:`mkdtemp` is responsible for deleting the temporary "
"directory and its contents when done with it."
msgstr ""

#: ../Doc/library/tempfile.rst:187
msgid ""
"The *prefix*, *suffix*, and *dir* arguments are the same as for :func:"
"`mkstemp`."
msgstr ""

#: ../Doc/library/tempfile.rst:190
msgid ":func:`mkdtemp` returns the absolute pathname of the new directory."
msgstr ""

#: ../Doc/library/tempfile.rst:201
msgid ""
"Return the name of the directory used for temporary files. This defines the "
"default value for the *dir* argument to all functions in this module."
msgstr ""

#: ../Doc/library/tempfile.rst:205
msgid ""
"Python searches a standard list of directories to find one which the calling "
"user can create files in.  The list is:"
msgstr ""

#: ../Doc/library/tempfile.rst:208
msgid "The directory named by the :envvar:`TMPDIR` environment variable."
msgstr ""

#: ../Doc/library/tempfile.rst:210
msgid "The directory named by the :envvar:`TEMP` environment variable."
msgstr ""

#: ../Doc/library/tempfile.rst:212
msgid "The directory named by the :envvar:`TMP` environment variable."
msgstr ""

#: ../Doc/library/tempfile.rst:214
msgid "A platform-specific location:"
msgstr ""

#: ../Doc/library/tempfile.rst:216
msgid ""
"On Windows, the directories :file:`C:\\\\TEMP`, :file:`C:\\\\TMP`, :file:`\\"
"\\TEMP`, and :file:`\\\\TMP`, in that order."
msgstr ""

#: ../Doc/library/tempfile.rst:219
msgid ""
"On all other platforms, the directories :file:`/tmp`, :file:`/var/tmp`, and :"
"file:`/usr/tmp`, in that order."
msgstr ""

#: ../Doc/library/tempfile.rst:222
msgid "As a last resort, the current working directory."
msgstr ""

#: ../Doc/library/tempfile.rst:224
msgid ""
"The result of this search is cached, see the description of :data:`tempdir` "
"below."
msgstr ""

#: ../Doc/library/tempfile.rst:229
msgid "Same as :func:`gettempdir` but the return value is in bytes."
msgstr ""

#: ../Doc/library/tempfile.rst:235
msgid ""
"Return the filename prefix used to create temporary files.  This does not "
"contain the directory component."
msgstr ""

#: ../Doc/library/tempfile.rst:240
msgid "Same as :func:`gettempprefix` but the return value is in bytes."
msgstr ""

#: ../Doc/library/tempfile.rst:244
msgid ""
"The module uses a global variable to store the name of the directory used "
"for temporary files returned by :func:`gettempdir`.  It can be set directly "
"to override the selection process, but this is discouraged. All functions in "
"this module take a *dir* argument which can be used to specify the directory "
"and this is the recommended approach."
msgstr ""

#: ../Doc/library/tempfile.rst:252
msgid ""
"When set to a value other than ``None``, this variable defines the default "
"value for the *dir* argument to the functions defined in this module."
msgstr ""

#: ../Doc/library/tempfile.rst:256
msgid ""
"If ``tempdir`` is ``None`` (the default) at any call to any of the above "
"functions except :func:`gettempprefix` it is initialized following the "
"algorithm described in :func:`gettempdir`."
msgstr ""

#: ../Doc/library/tempfile.rst:263
msgid "Examples"
msgstr "Exemples"

#: ../Doc/library/tempfile.rst:265
msgid "Here are some examples of typical usage of the :mod:`tempfile` module::"
msgstr ""

#: ../Doc/library/tempfile.rst:296
msgid "Deprecated functions and variables"
msgstr ""

#: ../Doc/library/tempfile.rst:298
msgid ""
"A historical way to create temporary files was to first generate a file name "
"with the :func:`mktemp` function and then create a file using this name. "
"Unfortunately this is not secure, because a different process may create a "
"file with this name in the time between the call to :func:`mktemp` and the "
"subsequent attempt to create the file by the first process. The solution is "
"to combine the two steps and create the file immediately. This approach is "
"used by :func:`mkstemp` and the other functions described above."
msgstr ""

#: ../Doc/library/tempfile.rst:309
msgid "Use :func:`mkstemp` instead."
msgstr ""

#: ../Doc/library/tempfile.rst:312
msgid ""
"Return an absolute pathname of a file that did not exist at the time the "
"call is made.  The *prefix*, *suffix*, and *dir* arguments are similar to "
"those of :func:`mkstemp`, except that bytes file names, ``suffix=None`` and "
"``prefix=None`` are not supported."
msgstr ""

#: ../Doc/library/tempfile.rst:319
msgid ""
"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::"
msgstr ""