Backup_Repos/beets
1
0
Fork 0
mirror of https://github.com/beetbox/beets.git synced 2026-02-26 17:21:24 +01:00
Code Issues Projects Releases Wiki Activity

Expand docstring for reflink utility

Browse source
This commit is contained in:
Adrian Sampson 2017-10-29 15:57:01 -04:00 committed by Ruben De Smet
parent 43f27506bf
commit b78c510ff2
1 changed files with 10 additions and 4 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

14
beets/util/__init__.py
View file

@ -548,12 +548,18 @@ def hardlink(path, dest, replace=False):
def reflink(path, dest, replace=False, fallback=False):
"""Create a reflink from `dest` to `path`. Raises an `OSError` if
`dest` already exists, unless `replace` is True. Does nothing if
`path` == `dest`. When `fallback` is True, `reflink` falls back on
`copy` when the filesystem does not support reflinks.
"""Create a reflink from `dest` to `path`.
Raise an `OSError` if `dest` already exists, unless `replace` is
True. If `path` == `dest`, then do nothing.
If reflinking fails and `fallback` is enabled, try copying the file
instead. Otherwise, raise an error without trying a plain copy.
May raise an `ImportError` if the `reflink` module is not available.
"""
import reflink as pyreflink
if samefile(path, dest):
return