102 lines · 3.8 KB · Go
RawDownload
// Package sync provides the sync command.package sync import (	"context"	"strings" 	"github.com/rclone/rclone/cmd"	"github.com/rclone/rclone/fs/config/flags"	"github.com/rclone/rclone/fs/operations"	"github.com/rclone/rclone/fs/operations/operationsflags"	"github.com/rclone/rclone/fs/sync"	"github.com/spf13/cobra") var (	createEmptySrcDirs = false	loggerOpt          = operations.LoggerOpt{}	loggerFlagsOpt     = operationsflags.AddLoggerFlagsOptions{}) func init() {	cmd.Root.AddCommand(commandDefinition)	cmdFlags := commandDefinition.Flags()	flags.BoolVarP(cmdFlags, &createEmptySrcDirs, "create-empty-src-dirs", "", createEmptySrcDirs, "Create empty source dirs on destination after sync", "")	operationsflags.AddLoggerFlags(cmdFlags, &loggerOpt, &loggerFlagsOpt)	loggerOpt.LoggerFn = operations.NewDefaultLoggerFn(&loggerOpt)} var commandDefinition = &cobra.Command{	Use:   "sync source:path dest:path",	Short: `Make source and dest identical, modifying destination only.`,	// Warning! "|" will be replaced by backticks below	Long: strings.ReplaceAll(`Sync the source to the destination, changing the destinationonly.  Doesn't transfer files that are identical on source anddestination, testing by size and modification time or MD5SUM.Destination is updated to match source, including deleting filesif necessary (except duplicate objects, see below). If you don'twant to delete files from destination, use the[copy](/commands/rclone_copy/) command instead. **Important**: Since this can cause data loss, test first with the|--dry-run| or the |--interactive|/|i| flag.     rclone sync --interactive SOURCE remote:DESTINATION Note that files in the destination won't be deleted if there were anyerrors at any point.  Duplicate objects (files with the same name, onthose providers that support it) are also not yet handled. It is always the contents of the directory that is synced, not thedirectory itself. So when source:path is a directory, it's the contents ofsource:path that are copied, not the directory name and contents.  Seeextended explanation in the [copy](/commands/rclone_copy/) command if unsure. If dest:path doesn't exist, it is created and the source:path contentsgo there. It is not possible to sync overlapping remotes. However, you may excludethe destination from the sync with a filter rule or by putting an exclude-if-present file inside the destination directory and sync to adestination that is inside the source directory. Rclone will sync the modification times of files and directories ifthe backend supports it. If metadata syncing is required then use the|--metadata| flag. Note that the modification time and metadata for the root directorywill **not** be synced. See https://github.com/rclone/rclone/issues/7652for more info. **Note**: Use the |-P|/|--progress| flag to view real-time transfer statistics **Note**: Use the |rclone dedupe| command to deal with "Duplicate object/directory found in source/destination - ignoring" errors.See [this forum post](https://forum.rclone.org/t/sync-not-clearing-duplicates/14372) for more info. `, "|", "`") + operationsflags.Help(),	Annotations: map[string]string{		"groups": "Sync,Copy,Filter,Listing,Important",	},	Run: func(command *cobra.Command, args []string) {		cmd.CheckArgs(2, 2, command, args)		fsrc, srcFileName, fdst := cmd.NewFsSrcFileDst(args)		cmd.Run(true, true, command, func() error {			ctx := context.Background()			close, err := operationsflags.ConfigureLoggers(ctx, fdst, command, &loggerOpt, loggerFlagsOpt)			if err != nil {				return err			}			defer close() 			if loggerFlagsOpt.AnySet() {				ctx = operations.WithSyncLogger(ctx, loggerOpt)			} 			if srcFileName == "" {				return sync.Sync(ctx, fdst, fsrc, createEmptySrcDirs)			}			return operations.CopyFile(ctx, fdst, fsrc, srcFileName, srcFileName)		})	},}