]> git.ipfire.org Git - thirdparty/Python/cpython.git/commit
GH-125413: Add private metadata methods to `pathlib.Path.info` (#129897)
authorBarney Gale <barney.gale@gmail.com>
Mon, 17 Feb 2025 19:15:25 +0000 (19:15 +0000)
committerGitHub <noreply@github.com>
Mon, 17 Feb 2025 19:15:25 +0000 (19:15 +0000)
commit7fcace99bbe1716c3e9713804e5bffaebdc8dd8f
tree0fb1a905454a744346aed55f6225cebfa18713ff
parentbd1642c6e569d6b328e4296e14355178d3a79778
GH-125413: Add private metadata methods to `pathlib.Path.info` (#129897)

Add the following private methods to `pathlib.Path.info`:

- `_posix_permissions()`: the POSIX file permissions (`S_IMODE(st_mode)`)
- `_file_id()`: the file ID (`(st_dev, st_ino)`)
- `_access_time_ns()`: the access time in nanoseconds (`st_atime_ns`)
- `_mod_time_ns()`: the modify time in nanoseconds (`st_mtime_ns`)
- `_bsd_flags()`: the BSD file flags (`st_flags`)
- `_xattrs()`: the file extended attributes as a list of key, value pairs,
  or an empty list if `listxattr()` or `getxattr()` fail in an ignorable
  way.

These methods replace `LocalCopyReader.read_metadata()`, and so we can
delete the `CopyReader` and `LocalCopyReader` classes. Rather than reading
metadata via `source._copy_reader.read_metadata()`, we instead call
`source.info._posix_permissions()`, `_access_time_ns()`, etc.

Preserving metadata is only supported for local-to-local copies at the
moment. To support copying metadata between arbitrary `ReadablePath` and
`WritablePath` objects, we'd need to make the new methods public and
documented.

Co-authored-by: Petr Viktorin <encukou@gmail.com>
Lib/pathlib/_abc.py
Lib/pathlib/_local.py
Lib/pathlib/_os.py
Lib/test/test_pathlib/test_pathlib.py