renku mv¶
Move or rename a file, a directory, or a symlink.
Description¶
Moving a file that belongs to a dataset will update its metadata to include its new path and commit. Moreover, tracking information in an external storage (e.g. Git LFS) will be updated.
Commands and options¶
renku mv¶
Move files and check repository for potential problems.
renku mv [OPTIONS] [SOURCES]... DESTINATION
Options
- -f, --force¶
Override existing files.
- -v, --verbose¶
Show move sources and destinations.
- --to-dataset <to_dataset>¶
A target dataset to move files to.
Arguments
- SOURCES¶
Optional argument(s)
- DESTINATION¶
Required argument
Examples¶
Move operation fails if a destination already exists in the repo;
use --force
flag to overwrite them.
If you want to move files to another dataset use --to-dataset
along with
destination’s dataset name. This removes source paths from all datasets’
metadata that include them (if any) and adds them to the destination’s dataset
metadata.
The following command moves data/src
and README
to data/dst
directory and adds them to target-dataset
’s metadata. If the source files
belong to one or more datasets then they will be removed from their metadata.
$ renku mv data/src README data/dst --to-dataset target-dataset