# SOME DESCRIPTIVE TITLE. # Copyright (C) 2001-2016, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.5\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2016-10-30 10:42+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: 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 `, which provide purely computational " "operations without I/O, and :ref:`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 ` 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 "" "This module has been included in the standard library on a :term:" "`provisional basis `. Backwards incompatible changes " "(up to and including removal of the package) may occur if deemed necessary " "by the core developers." msgstr "" #: ../Doc/library/pathlib.rst:45 msgid ":pep:`428`: The pathlib module -- object-oriented filesystem paths." msgstr "" #: ../Doc/library/pathlib.rst:48 msgid "" "For low-level path manipulation on strings, you can also use the :mod:`os." "path` module." msgstr "" #: ../Doc/library/pathlib.rst:53 msgid "Basic use" msgstr "" #: ../Doc/library/pathlib.rst:55 msgid "Importing the main class::" msgstr "" #: ../Doc/library/pathlib.rst:59 msgid "Listing subdirectories::" msgstr "" #: ../Doc/library/pathlib.rst:66 msgid "Listing Python source files in this directory tree::" msgstr "" #: ../Doc/library/pathlib.rst:73 msgid "Navigating inside a directory tree::" msgstr "" #: ../Doc/library/pathlib.rst:82 msgid "Querying path properties::" msgstr "" #: ../Doc/library/pathlib.rst:89 msgid "Opening a file::" msgstr "" #: ../Doc/library/pathlib.rst:99 msgid "Pure paths" msgstr "" #: ../Doc/library/pathlib.rst:101 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:107 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:113 msgid "" "Each element of *pathsegments* can be either a string representing a path " "segment, or another path object::" msgstr "" #: ../Doc/library/pathlib.rst:121 msgid "When *pathsegments* is empty, the current directory is assumed::" msgstr "" #: ../Doc/library/pathlib.rst:126 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:134 msgid "" "However, in a Windows path, changing the local root doesn't discard the " "previous drive setting::" msgstr "" #: ../Doc/library/pathlib.rst:140 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:151 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:157 msgid "" "A subclass of :class:`PurePath`, this path flavour represents non-Windows " "filesystem paths::" msgstr "" #: ../Doc/library/pathlib.rst:163 ../Doc/library/pathlib.rst:173 #: ../Doc/library/pathlib.rst:578 ../Doc/library/pathlib.rst:588 #: ../Doc/library/pathlib.rst:598 msgid "*pathsegments* is specified similarly to :class:`PurePath`." msgstr "" #: ../Doc/library/pathlib.rst:167 msgid "" "A subclass of :class:`PurePath`, this path flavour represents Windows " "filesystem paths::" msgstr "" #: ../Doc/library/pathlib.rst:175 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:180 msgid "General properties" msgstr "" #: ../Doc/library/pathlib.rst:182 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:195 msgid "Paths of a different flavour compare unequal and cannot be ordered::" msgstr "" #: ../Doc/library/pathlib.rst:206 msgid "Operators" msgstr "Opérateurs" #: ../Doc/library/pathlib.rst:208 msgid "" "The slash operator helps create child paths, similarly to :func:`os.path." "join`::" msgstr "" #: ../Doc/library/pathlib.rst:219 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:230 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:237 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:242 msgid "Accessing individual parts" msgstr "" #: ../Doc/library/pathlib.rst:244 msgid "" "To access the individual \"parts\" (components) of a path, use the following " "property:" msgstr "" #: ../Doc/library/pathlib.rst:249 msgid "A tuple giving access to the path's various components::" msgstr "" #: ../Doc/library/pathlib.rst:259 msgid "(note how the drive and local root are regrouped in a single part)" msgstr "" #: ../Doc/library/pathlib.rst:263 msgid "Methods and properties" msgstr "" #: ../Doc/library/pathlib.rst:265 msgid "Pure paths provide the following methods and properties:" msgstr "" #: ../Doc/library/pathlib.rst:269 msgid "A string representing the drive letter or name, if any::" msgstr "" #: ../Doc/library/pathlib.rst:278 msgid "UNC shares are also considered drives::" msgstr "" #: ../Doc/library/pathlib.rst:285 msgid "A string representing the (local or global) root, if any::" msgstr "" #: ../Doc/library/pathlib.rst:294 msgid "UNC shares always have a root::" msgstr "" #: ../Doc/library/pathlib.rst:301 msgid "The concatenation of the drive and root::" msgstr "" #: ../Doc/library/pathlib.rst:315 msgid "" "An immutable sequence providing access to the logical ancestors of the path::" msgstr "" #: ../Doc/library/pathlib.rst:329 msgid "The logical parent of the path::" msgstr "" #: ../Doc/library/pathlib.rst:335 msgid "You cannot go past an anchor, or empty path::" msgstr "" #: ../Doc/library/pathlib.rst:345 msgid "This is a purely lexical operation, hence the following behaviour::" msgstr "" #: ../Doc/library/pathlib.rst:351 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:358 msgid "" "A string representing the final path component, excluding the drive and " "root, if any::" msgstr "" #: ../Doc/library/pathlib.rst:364 msgid "UNC drive names are not considered::" msgstr "" #: ../Doc/library/pathlib.rst:374 msgid "The file extension of the final component, if any::" msgstr "" #: ../Doc/library/pathlib.rst:386 msgid "A list of the path's file extensions::" msgstr "" #: ../Doc/library/pathlib.rst:398 msgid "The final path component, without its suffix::" msgstr "" #: ../Doc/library/pathlib.rst:410 msgid "" "Return a string representation of the path with forward slashes (``/``)::" msgstr "" #: ../Doc/library/pathlib.rst:421 msgid "" "Represent the path as a ``file`` URI. :exc:`ValueError` is raised if the " "path isn't absolute." msgstr "" #: ../Doc/library/pathlib.rst:434 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:454 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:463 msgid "" "File system calls on reserved paths can fail mysteriously or have unintended " "effects." msgstr "" #: ../Doc/library/pathlib.rst:469 msgid "" "Calling this method is equivalent to combining the path with each of the " "*other* arguments in turn::" msgstr "" #: ../Doc/library/pathlib.rst:484 msgid "" "Match this path against the provided glob-style pattern. Return ``True`` if " "matching is successful, ``False`` otherwise." msgstr "" #: ../Doc/library/pathlib.rst:487 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:497 msgid "" "If *pattern* is absolute, the path must be absolute, and the whole path must " "match::" msgstr "" #: ../Doc/library/pathlib.rst:505 msgid "As with other methods, case-sensitivity is observed::" msgstr "" #: ../Doc/library/pathlib.rst:513 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:531 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:548 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:563 msgid "Concrete paths" msgstr "" #: ../Doc/library/pathlib.rst:565 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:571 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:582 msgid "" "A subclass of :class:`Path` and :class:`PurePosixPath`, this class " "represents concrete non-Windows filesystem paths::" msgstr "" #: ../Doc/library/pathlib.rst:592 msgid "" "A subclass of :class:`Path` and :class:`PureWindowsPath`, this class " "represents concrete Windows filesystem paths::" msgstr "" #: ../Doc/library/pathlib.rst:600 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:620 msgid "Methods" msgstr "Méthodes" #: ../Doc/library/pathlib.rst:622 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:628 msgid "" "Return a new path object representing the current directory (as returned by :" "func:`os.getcwd`)::" msgstr "" #: ../Doc/library/pathlib.rst:637 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:648 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:660 msgid "Change the file mode and permissions, like :func:`os.chmod`::" msgstr "" #: ../Doc/library/pathlib.rst:672 msgid "Whether the path points to an existing file or directory::" msgstr "" #: ../Doc/library/pathlib.rst:684 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:690 msgid "" "Return a new path with expanded ``~`` and ``~user`` constructs, as returned " "by :meth:`os.path.expanduser`::" msgstr "" #: ../Doc/library/pathlib.rst:702 msgid "" "Glob the given *pattern* in the directory represented by this path, yielding " "all matching files (of any kind)::" msgstr "" #: ../Doc/library/pathlib.rst:710 msgid "" "The \"``**``\" pattern means \"this directory and all subdirectories, " "recursively\". In other words, it enables recursive globbing::" msgstr "" #: ../Doc/library/pathlib.rst:721 msgid "" "Using the \"``**``\" pattern in large directory trees may consume an " "inordinate amount of time." msgstr "" #: ../Doc/library/pathlib.rst:727 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:733 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:736 ../Doc/library/pathlib.rst:745 #: ../Doc/library/pathlib.rst:762 ../Doc/library/pathlib.rst:771 #: ../Doc/library/pathlib.rst:780 ../Doc/library/pathlib.rst:789 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:742 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:751 msgid "" "Return ``True`` if the path points to a symbolic link, ``False`` otherwise." msgstr "" #: ../Doc/library/pathlib.rst:753 msgid "" "``False`` is also returned if the path doesn't exist; other errors (such as " "permission errors) are propagated." msgstr "" #: ../Doc/library/pathlib.rst:759 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:768 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:777 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:786 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:795 msgid "" "When the path points to a directory, yield path objects of the directory " "contents::" msgstr "" #: ../Doc/library/pathlib.rst:811 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:817 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:823 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:828 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:832 msgid "" "If *parents* is false (the default), a missing parent raises :exc:" "`FileNotFoundError`." msgstr "" #: ../Doc/library/pathlib.rst:835 msgid "" "If *exist_ok* is false (the default), :exc:`FileExistsError` is raised if " "the target directory already exists." msgstr "" #: ../Doc/library/pathlib.rst:838 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:842 msgid "The *exist_ok* parameter was added." msgstr "" #: ../Doc/library/pathlib.rst:848 msgid "" "Open the file pointed to by the path, like the built-in :func:`open` " "function does::" msgstr "" #: ../Doc/library/pathlib.rst:860 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:866 msgid "Return the binary contents of the pointed-to file as a bytes object::" msgstr "" #: ../Doc/library/pathlib.rst:879 msgid "Return the decoded contents of the pointed-to file as a string::" msgstr "" #: ../Doc/library/pathlib.rst:887 msgid "The optional parameters have the same meaning as in :func:`open`." msgstr "" #: ../Doc/library/pathlib.rst:894 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:909 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:915 msgid "" "Make the path absolute, resolving any symlinks. A new path object is " "returned::" msgstr "" #: ../Doc/library/pathlib.rst:924 msgid "" "\"``..``\" components are also eliminated (this is the only method to do " "so)::" msgstr "" #: ../Doc/library/pathlib.rst:930 msgid "" "If the path doesn't exist, :exc:`FileNotFoundError` is raised. If an " "infinite loop is encountered along the resolution path, :exc:`RuntimeError` " "is raised." msgstr "" #: ../Doc/library/pathlib.rst:937 msgid "" "This is like calling :meth:`Path.glob` with \"``**``\" added in front of the " "given *pattern*:" msgstr "" #: ../Doc/library/pathlib.rst:950 msgid "Remove this directory. The directory must be empty." msgstr "" #: ../Doc/library/pathlib.rst:955 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:959 msgid "" "An :exc:`OSError` can be raised if either file cannot be accessed for some " "reason." msgstr "" #: ../Doc/library/pathlib.rst:974 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:988 msgid "" "The order of arguments (link, target) is the reverse of :func:`os.symlink`'s." msgstr "" #: ../Doc/library/pathlib.rst:994 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:1003 msgid "" "Remove this file or symbolic link. If the path points to a directory, use :" "func:`Path.rmdir` instead." msgstr "" #: ../Doc/library/pathlib.rst:1009 msgid "" "Open the file pointed to in bytes mode, write *data* to it, and close the " "file::" msgstr "" #: ../Doc/library/pathlib.rst:1018 msgid "An existing file of the same name is overwritten." msgstr "" #: ../Doc/library/pathlib.rst:1025 msgid "" "Open the file pointed to in text mode, write *data* to it, and close the " "file::" msgstr ""