2018-07-04 09:06:45 +00:00
|
|
|
# Copyright (C) 2001-2018, Python Software Foundation
|
2018-07-04 09:08:42 +00:00
|
|
|
# For licence information, see README file.
|
2016-10-30 09:46:26 +00:00
|
|
|
#
|
|
|
|
msgid ""
|
|
|
|
msgstr ""
|
|
|
|
"Project-Id-Version: Python 3.6\n"
|
|
|
|
"Report-Msgid-Bugs-To: \n"
|
2018-12-24 13:20:55 +00:00
|
|
|
"POT-Creation-Date: 2018-12-21 09:48+0100\n"
|
2016-10-30 09:46:26 +00:00
|
|
|
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
|
|
|
|
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
|
2018-07-04 09:14:25 +00:00
|
|
|
"Language-Team: FRENCH <traductions@lists.afpy.org>\n"
|
2017-05-23 22:40:56 +00:00
|
|
|
"Language: fr\n"
|
2016-10-30 09:46:26 +00:00
|
|
|
"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, "
|
2018-12-24 13:20:55 +00:00
|
|
|
"the :attr:`name` will be assigned to the target of the :keyword:`!as` clause "
|
2016-10-30 09:46:26 +00:00
|
|
|
"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 "
|
2017-04-02 20:14:06 +00:00
|
|
|
"and this is the recommended approach."
|
2016-10-30 09:46:26 +00:00
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
#: ../Doc/library/tempfile.rst:252
|
|
|
|
msgid ""
|
|
|
|
"When set to a value other than ``None``, this variable defines the default "
|
2017-04-02 20:14:06 +00:00
|
|
|
"value for the *dir* argument to the functions defined in this module."
|
2016-10-30 09:46:26 +00:00
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
#: ../Doc/library/tempfile.rst:256
|
|
|
|
msgid ""
|
2018-06-28 13:32:56 +00:00
|
|
|
"If ``tempdir`` is ``None`` (the default) at any call to any of the above "
|
2016-10-30 09:46:26 +00:00
|
|
|
"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 ""
|