macpie.shelltools.copy_file_same_dir

macpie.shelltools.copy_file_same_dir(filepath, new_file_name=None)

Copy a file into the same directory, by default appending “_copy” to filename, unless new_file_name is specified. This mimics behavior of copy and pasting a file into the same directory on a macOS, where multiple copies will start appending incrementing integers so the filename (e.g. _copy_1, _copy_2).

Parameters:

filepathstr, Path

Filepath of file to copy

new_file_namestr, default None

New filename of copied file

Returns:

Path

Filepath of copied file

Examples

>>> copied_filepath = copy_file_same_dir('afile.csv')
>>> copied_filepath
PosixPath('/same/dir/afile_copy.csv')

>>> copied_filepath = copy_file_same_dir('afile.csv')
>>> copied_filepath
PosixPath('/same/dir/afile_copy_2.csv')

>>> copied_filepath = copy_file_same_dir('afile.csv', new_file_name='renamed.txt')
>>> copied_filepath
PosixPath('/same/dir/renamed.txt')