mirror of
https://github.com/rclone/rclone
synced 2024-12-02 11:53:45 +01:00
bff702a6f1
This adds an additional parameter to the creation of each flag. This specifies one or more flag groups. This **must** be set for global flags and **must not** be set for local flags. This causes flags.md to be built with sections to aid comprehension and it causes the documentation pages for each command (and the `--help`) to be built showing the flags groups as specified in the `groups` annotation on the command. See: https://forum.rclone.org/t/make-docs-for-mortals-not-only-rclone-gurus/39476/
68 lines
2.0 KiB
Go
68 lines
2.0 KiB
Go
// Package moveto provides the moveto command.
|
|
package moveto
|
|
|
|
import (
|
|
"context"
|
|
|
|
"github.com/rclone/rclone/cmd"
|
|
"github.com/rclone/rclone/fs/operations"
|
|
"github.com/rclone/rclone/fs/sync"
|
|
"github.com/spf13/cobra"
|
|
)
|
|
|
|
func init() {
|
|
cmd.Root.AddCommand(commandDefinition)
|
|
}
|
|
|
|
var commandDefinition = &cobra.Command{
|
|
Use: "moveto source:path dest:path",
|
|
Short: `Move file or directory from source to dest.`,
|
|
Long: `
|
|
If source:path is a file or directory then it moves it to a file or
|
|
directory named dest:path.
|
|
|
|
This can be used to rename files or upload single files to other than
|
|
their existing name. If the source is a directory then it acts exactly
|
|
like the [move](/commands/rclone_move/) command.
|
|
|
|
So
|
|
|
|
rclone moveto src dst
|
|
|
|
where src and dst are rclone paths, either remote:path or
|
|
/path/to/local or C:\windows\path\if\on\windows.
|
|
|
|
This will:
|
|
|
|
if src is file
|
|
move it to dst, overwriting an existing file if it exists
|
|
if src is directory
|
|
move it to dst, overwriting existing files if they exist
|
|
see move command for full details
|
|
|
|
This doesn't transfer files that are identical on src and dst, testing
|
|
by size and modification time or MD5SUM. src will be deleted on
|
|
successful transfer.
|
|
|
|
**Important**: Since this can cause data loss, test first with the
|
|
` + "`--dry-run` or the `--interactive`/`-i`" + ` flag.
|
|
|
|
**Note**: Use the ` + "`-P`" + `/` + "`--progress`" + ` flag to view real-time transfer statistics.
|
|
`,
|
|
Annotations: map[string]string{
|
|
"versionIntroduced": "v1.35",
|
|
"groups": "Filter,Listing,Important,Copy",
|
|
},
|
|
Run: func(command *cobra.Command, args []string) {
|
|
cmd.CheckArgs(2, 2, command, args)
|
|
fsrc, srcFileName, fdst, dstFileName := cmd.NewFsSrcDstFiles(args)
|
|
|
|
cmd.Run(true, true, command, func() error {
|
|
if srcFileName == "" {
|
|
return sync.MoveDir(context.Background(), fdst, fsrc, false, false)
|
|
}
|
|
return operations.MoveFile(context.Background(), fdst, fsrc, dstFileName, srcFileName)
|
|
})
|
|
},
|
|
}
|