python-docs-fr/library/pathlib.po

# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2001-2016, Python Software Foundation
# This file is distributed under the same license as the Python package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Python 3.6\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2017-04-02 22:11+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"Language: \n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"

#: ../Doc/library/pathlib.rst:3
msgid ":mod:`pathlib` --- Object-oriented filesystem paths"
msgstr ""

#: ../Doc/library/pathlib.rst:10
msgid "**Source code:** :source:`Lib/pathlib.py`"
msgstr ""

#: ../Doc/library/pathlib.rst:16
msgid ""
"This module offers classes representing filesystem paths with semantics "
"appropriate for different operating systems.  Path classes are divided "
"between :ref:`pure paths <pure-paths>`, which provide purely computational "
"operations without I/O, and :ref:`concrete paths <concrete-paths>`, which "
"inherit from pure paths but also provide I/O operations."
msgstr ""

#: ../Doc/library/pathlib.rst:25
msgid ""
"If you've never used this module before or just aren't sure which class is "
"right for your task, :class:`Path` is most likely what you need. It "
"instantiates a :ref:`concrete path <concrete-paths>` for the platform the "
"code is running on."
msgstr ""

#: ../Doc/library/pathlib.rst:29
msgid "Pure paths are useful in some special cases; for example:"
msgstr ""

#: ../Doc/library/pathlib.rst:31
msgid ""
"If you want to manipulate Windows paths on a Unix machine (or vice versa). "
"You cannot instantiate a :class:`WindowsPath` when running on Unix, but you "
"can instantiate :class:`PureWindowsPath`."
msgstr ""

#: ../Doc/library/pathlib.rst:34
msgid ""
"You want to make sure that your code only manipulates paths without actually "
"accessing the OS. In this case, instantiating one of the pure classes may be "
"useful since those simply don't have any OS-accessing operations."
msgstr ""

#: ../Doc/library/pathlib.rst:39
msgid ":pep:`428`: The pathlib module -- object-oriented filesystem paths."
msgstr ""

#: ../Doc/library/pathlib.rst:42
msgid ""
"For low-level path manipulation on strings, you can also use the :mod:`os."
"path` module."
msgstr ""

#: ../Doc/library/pathlib.rst:47
msgid "Basic use"
msgstr ""

#: ../Doc/library/pathlib.rst:49
msgid "Importing the main class::"
msgstr ""

#: ../Doc/library/pathlib.rst:53
msgid "Listing subdirectories::"
msgstr ""

#: ../Doc/library/pathlib.rst:60
msgid "Listing Python source files in this directory tree::"
msgstr ""

#: ../Doc/library/pathlib.rst:67
msgid "Navigating inside a directory tree::"
msgstr ""

#: ../Doc/library/pathlib.rst:76
msgid "Querying path properties::"
msgstr ""

#: ../Doc/library/pathlib.rst:83
msgid "Opening a file::"
msgstr ""

#: ../Doc/library/pathlib.rst:93
msgid "Pure paths"
msgstr ""

#: ../Doc/library/pathlib.rst:95
msgid ""
"Pure path objects provide path-handling operations which don't actually "
"access a filesystem.  There are three ways to access these classes, which we "
"also call *flavours*:"
msgstr ""

#: ../Doc/library/pathlib.rst:101
msgid ""
"A generic class that represents the system's path flavour (instantiating it "
"creates either a :class:`PurePosixPath` or a :class:`PureWindowsPath`)::"
msgstr ""

#: ../Doc/library/pathlib.rst:107
msgid ""
"Each element of *pathsegments* can be either a string representing a path "
"segment, an object implementing the :class:`os.PathLike` interface which "
"returns a string, or another path object::"
msgstr ""

#: ../Doc/library/pathlib.rst:116
msgid "When *pathsegments* is empty, the current directory is assumed::"
msgstr ""

#: ../Doc/library/pathlib.rst:121
msgid ""
"When several absolute paths are given, the last is taken as an anchor "
"(mimicking :func:`os.path.join`'s behaviour)::"
msgstr ""

#: ../Doc/library/pathlib.rst:129
msgid ""
"However, in a Windows path, changing the local root doesn't discard the "
"previous drive setting::"
msgstr ""

#: ../Doc/library/pathlib.rst:135
msgid ""
"Spurious slashes and single dots are collapsed, but double dots (``'..'``) "
"are not, since this would change the meaning of a path in the face of "
"symbolic links::"
msgstr ""

#: ../Doc/library/pathlib.rst:146
msgid ""
"(a naïve approach would make ``PurePosixPath('foo/../bar')`` equivalent to "
"``PurePosixPath('bar')``, which is wrong if ``foo`` is a symbolic link to "
"another directory)"
msgstr ""

#: ../Doc/library/pathlib.rst:150
msgid ""
"Pure path objects implement the :class:`os.PathLike` interface, allowing "
"them to be used anywhere the interface is accepted."
msgstr ""

#: ../Doc/library/pathlib.rst:153
msgid "Added support for the :class:`os.PathLike` interface."
msgstr ""

#: ../Doc/library/pathlib.rst:158
msgid ""
"A subclass of :class:`PurePath`, this path flavour represents non-Windows "
"filesystem paths::"
msgstr ""

#: ../Doc/library/pathlib.rst:164 ../Doc/library/pathlib.rst:174
#: ../Doc/library/pathlib.rst:587 ../Doc/library/pathlib.rst:597
#: ../Doc/library/pathlib.rst:607
msgid "*pathsegments* is specified similarly to :class:`PurePath`."
msgstr ""

#: ../Doc/library/pathlib.rst:168
msgid ""
"A subclass of :class:`PurePath`, this path flavour represents Windows "
"filesystem paths::"
msgstr ""

#: ../Doc/library/pathlib.rst:176
msgid ""
"Regardless of the system you're running on, you can instantiate all of these "
"classes, since they don't provide any operation that does system calls."
msgstr ""

#: ../Doc/library/pathlib.rst:181
msgid "General properties"
msgstr ""

#: ../Doc/library/pathlib.rst:183
msgid ""
"Paths are immutable and hashable.  Paths of a same flavour are comparable "
"and orderable.  These properties respect the flavour's case-folding "
"semantics::"
msgstr ""

#: ../Doc/library/pathlib.rst:196
msgid "Paths of a different flavour compare unequal and cannot be ordered::"
msgstr ""

#: ../Doc/library/pathlib.rst:207
msgid "Operators"
msgstr "Opérateurs"

#: ../Doc/library/pathlib.rst:209
msgid ""
"The slash operator helps create child paths, similarly to :func:`os.path."
"join`::"
msgstr ""

#: ../Doc/library/pathlib.rst:220
msgid ""
"A path object can be used anywhere an object implementing :class:`os."
"PathLike` is accepted::"
msgstr ""

#: ../Doc/library/pathlib.rst:228
msgid ""
"The string representation of a path is the raw filesystem path itself (in "
"native form, e.g. with backslashes under Windows), which you can pass to any "
"function taking a file path as a string::"
msgstr ""

#: ../Doc/library/pathlib.rst:239
msgid ""
"Similarly, calling :class:`bytes` on a path gives the raw filesystem path as "
"a bytes object, as encoded by :func:`os.fsencode`::"
msgstr ""

#: ../Doc/library/pathlib.rst:246
msgid ""
"Calling :class:`bytes` is only recommended under Unix.  Under Windows, the "
"unicode form is the canonical representation of filesystem paths."
msgstr ""

#: ../Doc/library/pathlib.rst:251
msgid "Accessing individual parts"
msgstr ""

#: ../Doc/library/pathlib.rst:253
msgid ""
"To access the individual \"parts\" (components) of a path, use the following "
"property:"
msgstr ""

#: ../Doc/library/pathlib.rst:258
msgid "A tuple giving access to the path's various components::"
msgstr ""

#: ../Doc/library/pathlib.rst:268
msgid "(note how the drive and local root are regrouped in a single part)"
msgstr ""

#: ../Doc/library/pathlib.rst:272
msgid "Methods and properties"
msgstr ""

#: ../Doc/library/pathlib.rst:274
msgid "Pure paths provide the following methods and properties:"
msgstr ""

#: ../Doc/library/pathlib.rst:278
msgid "A string representing the drive letter or name, if any::"
msgstr ""

#: ../Doc/library/pathlib.rst:287
msgid "UNC shares are also considered drives::"
msgstr ""

#: ../Doc/library/pathlib.rst:294
msgid "A string representing the (local or global) root, if any::"
msgstr ""

#: ../Doc/library/pathlib.rst:303
msgid "UNC shares always have a root::"
msgstr ""

#: ../Doc/library/pathlib.rst:310
msgid "The concatenation of the drive and root::"
msgstr ""

#: ../Doc/library/pathlib.rst:324
msgid ""
"An immutable sequence providing access to the logical ancestors of the path::"
msgstr ""

#: ../Doc/library/pathlib.rst:338
msgid "The logical parent of the path::"
msgstr ""

#: ../Doc/library/pathlib.rst:344
msgid "You cannot go past an anchor, or empty path::"
msgstr ""

#: ../Doc/library/pathlib.rst:354
msgid "This is a purely lexical operation, hence the following behaviour::"
msgstr ""

#: ../Doc/library/pathlib.rst:360
msgid ""
"If you want to walk an arbitrary filesystem path upwards, it is recommended "
"to first call :meth:`Path.resolve` so as to resolve symlinks and eliminate `"
"\"..\"` components."
msgstr ""

#: ../Doc/library/pathlib.rst:367
msgid ""
"A string representing the final path component, excluding the drive and "
"root, if any::"
msgstr ""

#: ../Doc/library/pathlib.rst:373
msgid "UNC drive names are not considered::"
msgstr ""

#: ../Doc/library/pathlib.rst:383
msgid "The file extension of the final component, if any::"
msgstr ""

#: ../Doc/library/pathlib.rst:395
msgid "A list of the path's file extensions::"
msgstr ""

#: ../Doc/library/pathlib.rst:407
msgid "The final path component, without its suffix::"
msgstr ""

#: ../Doc/library/pathlib.rst:419
msgid ""
"Return a string representation of the path with forward slashes (``/``)::"
msgstr ""

#: ../Doc/library/pathlib.rst:430
msgid ""
"Represent the path as a ``file`` URI.  :exc:`ValueError` is raised if the "
"path isn't absolute."
msgstr ""

#: ../Doc/library/pathlib.rst:443
msgid ""
"Return whether the path is absolute or not.  A path is considered absolute "
"if it has both a root and (if the flavour allows) a drive::"
msgstr ""

#: ../Doc/library/pathlib.rst:463
msgid ""
"With :class:`PureWindowsPath`, return ``True`` if the path is considered "
"reserved under Windows, ``False`` otherwise.  With :class:`PurePosixPath`, "
"``False`` is always returned."
msgstr ""

#: ../Doc/library/pathlib.rst:472
msgid ""
"File system calls on reserved paths can fail mysteriously or have unintended "
"effects."
msgstr ""

#: ../Doc/library/pathlib.rst:478
msgid ""
"Calling this method is equivalent to combining the path with each of the "
"*other* arguments in turn::"
msgstr ""

#: ../Doc/library/pathlib.rst:493
msgid ""
"Match this path against the provided glob-style pattern.  Return ``True`` if "
"matching is successful, ``False`` otherwise."
msgstr ""

#: ../Doc/library/pathlib.rst:496
msgid ""
"If *pattern* is relative, the path can be either relative or absolute, and "
"matching is done from the right::"
msgstr ""

#: ../Doc/library/pathlib.rst:506
msgid ""
"If *pattern* is absolute, the path must be absolute, and the whole path must "
"match::"
msgstr ""

#: ../Doc/library/pathlib.rst:514
msgid "As with other methods, case-sensitivity is observed::"
msgstr ""

#: ../Doc/library/pathlib.rst:522
msgid ""
"Compute a version of this path relative to the path represented by *other*.  "
"If it's impossible, ValueError is raised::"
msgstr ""

#: ../Doc/library/pathlib.rst:540
msgid ""
"Return a new path with the :attr:`name` changed.  If the original path "
"doesn't have a name, ValueError is raised::"
msgstr ""

#: ../Doc/library/pathlib.rst:557
msgid ""
"Return a new path with the :attr:`suffix` changed.  If the original path "
"doesn't have a suffix, the new *suffix* is appended instead::"
msgstr ""

#: ../Doc/library/pathlib.rst:572
msgid "Concrete paths"
msgstr ""

#: ../Doc/library/pathlib.rst:574
msgid ""
"Concrete paths are subclasses of the pure path classes.  In addition to "
"operations provided by the latter, they also provide methods to do system "
"calls on path objects.  There are three ways to instantiate concrete paths:"
msgstr ""

#: ../Doc/library/pathlib.rst:580
msgid ""
"A subclass of :class:`PurePath`, this class represents concrete paths of the "
"system's path flavour (instantiating it creates either a :class:`PosixPath` "
"or a :class:`WindowsPath`)::"
msgstr ""

#: ../Doc/library/pathlib.rst:591
msgid ""
"A subclass of :class:`Path` and :class:`PurePosixPath`, this class "
"represents concrete non-Windows filesystem paths::"
msgstr ""

#: ../Doc/library/pathlib.rst:601
msgid ""
"A subclass of :class:`Path` and :class:`PureWindowsPath`, this class "
"represents concrete Windows filesystem paths::"
msgstr ""

#: ../Doc/library/pathlib.rst:609
msgid ""
"You can only instantiate the class flavour that corresponds to your system "
"(allowing system calls on non-compatible path flavours could lead to bugs or "
"failures in your application)::"
msgstr ""

#: ../Doc/library/pathlib.rst:629
msgid "Methods"
msgstr "Méthodes"

#: ../Doc/library/pathlib.rst:631
msgid ""
"Concrete paths provide the following methods in addition to pure paths "
"methods.  Many of these methods can raise an :exc:`OSError` if a system call "
"fails (for example because the path doesn't exist):"
msgstr ""

#: ../Doc/library/pathlib.rst:637
msgid ""
"Return a new path object representing the current directory (as returned by :"
"func:`os.getcwd`)::"
msgstr ""

#: ../Doc/library/pathlib.rst:646
msgid ""
"Return a new path object representing the user's home directory (as returned "
"by :func:`os.path.expanduser` with ``~`` construct)::"
msgstr ""

#: ../Doc/library/pathlib.rst:657
msgid ""
"Return information about this path (similarly to :func:`os.stat`). The "
"result is looked up at each call to this method."
msgstr ""

#: ../Doc/library/pathlib.rst:669
msgid "Change the file mode and permissions, like :func:`os.chmod`::"
msgstr ""

#: ../Doc/library/pathlib.rst:681
msgid "Whether the path points to an existing file or directory::"
msgstr ""

#: ../Doc/library/pathlib.rst:693
msgid ""
"If the path points to a symlink, :meth:`exists` returns whether the symlink "
"*points to* an existing file or directory."
msgstr ""

#: ../Doc/library/pathlib.rst:699
msgid ""
"Return a new path with expanded ``~`` and ``~user`` constructs, as returned "
"by :meth:`os.path.expanduser`::"
msgstr ""

#: ../Doc/library/pathlib.rst:711
msgid ""
"Glob the given *pattern* in the directory represented by this path, yielding "
"all matching files (of any kind)::"
msgstr ""

#: ../Doc/library/pathlib.rst:719
msgid ""
"The \"``**``\" pattern means \"this directory and all subdirectories, "
"recursively\".  In other words, it enables recursive globbing::"
msgstr ""

#: ../Doc/library/pathlib.rst:730
msgid ""
"Using the \"``**``\" pattern in large directory trees may consume an "
"inordinate amount of time."
msgstr ""

#: ../Doc/library/pathlib.rst:736
msgid ""
"Return the name of the group owning the file.  :exc:`KeyError` is raised if "
"the file's gid isn't found in the system database."
msgstr ""

#: ../Doc/library/pathlib.rst:742
msgid ""
"Return ``True`` if the path points to a directory (or a symbolic link "
"pointing to a directory), ``False`` if it points to another kind of file."
msgstr ""

#: ../Doc/library/pathlib.rst:745 ../Doc/library/pathlib.rst:754
#: ../Doc/library/pathlib.rst:771 ../Doc/library/pathlib.rst:780
#: ../Doc/library/pathlib.rst:789 ../Doc/library/pathlib.rst:798
msgid ""
"``False`` is also returned if the path doesn't exist or is a broken symlink; "
"other errors (such as permission errors) are propagated."
msgstr ""

#: ../Doc/library/pathlib.rst:751
msgid ""
"Return ``True`` if the path points to a regular file (or a symbolic link "
"pointing to a regular file), ``False`` if it points to another kind of file."
msgstr ""

#: ../Doc/library/pathlib.rst:760
msgid ""
"Return ``True`` if the path points to a symbolic link, ``False`` otherwise."
msgstr ""

#: ../Doc/library/pathlib.rst:762
msgid ""
"``False`` is also returned if the path doesn't exist; other errors (such as "
"permission errors) are propagated."
msgstr ""

#: ../Doc/library/pathlib.rst:768
msgid ""
"Return ``True`` if the path points to a Unix socket (or a symbolic link "
"pointing to a Unix socket), ``False`` if it points to another kind of file."
msgstr ""

#: ../Doc/library/pathlib.rst:777
msgid ""
"Return ``True`` if the path points to a FIFO (or a symbolic link pointing to "
"a FIFO), ``False`` if it points to another kind of file."
msgstr ""

#: ../Doc/library/pathlib.rst:786
msgid ""
"Return ``True`` if the path points to a block device (or a symbolic link "
"pointing to a block device), ``False`` if it points to another kind of file."
msgstr ""

#: ../Doc/library/pathlib.rst:795
msgid ""
"Return ``True`` if the path points to a character device (or a symbolic link "
"pointing to a character device), ``False`` if it points to another kind of "
"file."
msgstr ""

#: ../Doc/library/pathlib.rst:804
msgid ""
"When the path points to a directory, yield path objects of the directory "
"contents::"
msgstr ""

#: ../Doc/library/pathlib.rst:820
msgid ""
"Like :meth:`Path.chmod` but, if the path points to a symbolic link, the "
"symbolic link's mode is changed rather than its target's."
msgstr ""

#: ../Doc/library/pathlib.rst:826
msgid ""
"Like :meth:`Path.stat` but, if the path points to a symbolic link, return "
"the symbolic link's information rather than its target's."
msgstr ""

#: ../Doc/library/pathlib.rst:832
msgid ""
"Create a new directory at this given path.  If *mode* is given, it is "
"combined with the process' ``umask`` value to determine the file mode and "
"access flags.  If the path already exists, :exc:`FileExistsError` is raised."
msgstr ""

#: ../Doc/library/pathlib.rst:837
msgid ""
"If *parents* is true, any missing parents of this path are created as "
"needed; they are created with the default permissions without taking *mode* "
"into account (mimicking the POSIX ``mkdir -p`` command)."
msgstr ""

#: ../Doc/library/pathlib.rst:841
msgid ""
"If *parents* is false (the default), a missing parent raises :exc:"
"`FileNotFoundError`."
msgstr ""

#: ../Doc/library/pathlib.rst:844
msgid ""
"If *exist_ok* is false (the default), :exc:`FileExistsError` is raised if "
"the target directory already exists."
msgstr ""

#: ../Doc/library/pathlib.rst:847
msgid ""
"If *exist_ok* is true, :exc:`FileExistsError` exceptions will be ignored "
"(same behavior as the POSIX ``mkdir -p`` command), but only if the last path "
"component is not an existing non-directory file."
msgstr ""

#: ../Doc/library/pathlib.rst:851
msgid "The *exist_ok* parameter was added."
msgstr ""

#: ../Doc/library/pathlib.rst:857
msgid ""
"Open the file pointed to by the path, like the built-in :func:`open` "
"function does::"
msgstr ""

#: ../Doc/library/pathlib.rst:869
msgid ""
"Return the name of the user owning the file.  :exc:`KeyError` is raised if "
"the file's uid isn't found in the system database."
msgstr ""

#: ../Doc/library/pathlib.rst:875
msgid "Return the binary contents of the pointed-to file as a bytes object::"
msgstr ""

#: ../Doc/library/pathlib.rst:888
msgid "Return the decoded contents of the pointed-to file as a string::"
msgstr ""

#: ../Doc/library/pathlib.rst:896
msgid "The optional parameters have the same meaning as in :func:`open`."
msgstr ""

#: ../Doc/library/pathlib.rst:903
msgid ""
"Rename this file or directory to the given *target*.  On Unix, if *target* "
"exists and is a file, it will be replaced silently if the user has "
"permission.  *target* can be either a string or another path object::"
msgstr ""

#: ../Doc/library/pathlib.rst:918
msgid ""
"Rename this file or directory to the given *target*.  If *target* points to "
"an existing file or directory, it will be unconditionally replaced."
msgstr ""

#: ../Doc/library/pathlib.rst:924
msgid ""
"Make the path absolute, resolving any symlinks.  A new path object is "
"returned::"
msgstr ""

#: ../Doc/library/pathlib.rst:933
msgid ""
"\"``..``\" components are also eliminated (this is the only method to do "
"so)::"
msgstr ""

#: ../Doc/library/pathlib.rst:939
msgid ""
"If the path doesn't exist and *strict* is ``True``, :exc:`FileNotFoundError` "
"is raised.  If *strict* is ``False``, the path is resolved as far as "
"possible and any remainder is appended without checking whether it exists.  "
"If an infinite loop is encountered along the resolution path, :exc:"
"`RuntimeError` is raised."
msgstr ""

#: ../Doc/library/pathlib.rst:945
msgid "The *strict* argument."
msgstr ""

#: ../Doc/library/pathlib.rst:950
msgid ""
"This is like calling :meth:`Path.glob` with \"``**``\" added in front of the "
"given *pattern*:"
msgstr ""

#: ../Doc/library/pathlib.rst:963
msgid "Remove this directory.  The directory must be empty."
msgstr ""

#: ../Doc/library/pathlib.rst:968
msgid ""
"Return whether this path points to the same file as *other_path*, which can "
"be either a Path object, or a string.  The semantics are similar to :func:"
"`os.path.samefile` and :func:`os.path.samestat`."
msgstr ""

#: ../Doc/library/pathlib.rst:972
msgid ""
"An :exc:`OSError` can be raised if either file cannot be accessed for some "
"reason."
msgstr ""

#: ../Doc/library/pathlib.rst:987
msgid ""
"Make this path a symbolic link to *target*.  Under Windows, "
"*target_is_directory* must be true (default ``False``) if the link's target "
"is a directory.  Under POSIX, *target_is_directory*'s value is ignored."
msgstr ""

#: ../Doc/library/pathlib.rst:1001
msgid ""
"The order of arguments (link, target) is the reverse of :func:`os.symlink`'s."
msgstr ""

#: ../Doc/library/pathlib.rst:1007
msgid ""
"Create a file at this given path.  If *mode* is given, it is combined with "
"the process' ``umask`` value to determine the file mode and access flags.  "
"If the file already exists, the function succeeds if *exist_ok* is true (and "
"its modification time is updated to the current time), otherwise :exc:"
"`FileExistsError` is raised."
msgstr ""

#: ../Doc/library/pathlib.rst:1016
msgid ""
"Remove this file or symbolic link.  If the path points to a directory, use :"
"func:`Path.rmdir` instead."
msgstr ""

#: ../Doc/library/pathlib.rst:1022
msgid ""
"Open the file pointed to in bytes mode, write *data* to it, and close the "
"file::"
msgstr ""

#: ../Doc/library/pathlib.rst:1031
msgid "An existing file of the same name is overwritten."
msgstr ""

#: ../Doc/library/pathlib.rst:1038
msgid ""
"Open the file pointed to in text mode, write *data* to it, and close the "
"file::"
msgstr ""