github/rclone
1
Fork 0
mirror of https://github.com/rclone/rclone synced 2025-01-03 03:46:24 +01:00
Code Releases Activity

use pipes as inline code markup for copy, move, and sync

Browse Source
This commit is contained in:
Marvin Rösch 2024-10-18 07:41:04 +02:00
parent d766c54c98
commit a291eed98f
No known key found for this signature in database
GPG Key ID: 851D6C792B4D68FD
3 changed files with 58 additions and 59 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

35
cmd/copy/copy.go
View File

@ -98,39 +98,38 @@ for more info.
## Logger Flags ## Logger Flags
The ` + "`--differ`" + `, ` + "`--missing-on-dst`" + `, ` + "`--missing-on-src`" + `, ` + The |--differ|, |--missing-on-dst|, |--missing-on-src|, |--match| and |--error| flags write paths,
"`--match`" + ` and ` + "`--error`" + ` flags write paths, one per line, to the file name (or one per line, to the file name (or stdout if it is |-|) supplied. What they write is described
stdout if it is ` + "`-`" + `) supplied. What they write is described in the in the help below. For example |--differ| will write all paths which are present
help below. For example ` + "`--differ`" + ` will write all paths which are on both the source and destination but different.
present on both the source and destination but different.
The ` + "`--combined`" + ` flag will write a file (or stdout) which contains all The |--combined| flag will write a file (or stdout) which contains all
file paths with a symbol and then a space and then the path to tell file paths with a symbol and then a space and then the path to tell
you what happened to it. These are reminiscent of diff files. you what happened to it. These are reminiscent of diff files.
- ` + "`= path`" + ` means path was found in source and destination and was identical - |= path| means path was found in source and destination and was identical
- ` + "`- path`" + ` means path was missing on the source, so only in the destination - |- path| means path was missing on the source, so only in the destination
- ` + "`+ path`" + ` means path was missing on the destination, so only in the source - |+ path| means path was missing on the destination, so only in the source
- ` + "`* path`" + ` means path was present in source and destination but different. - |* path| means path was present in source and destination but different.
- ` + "`! path`" + ` means there was an error reading or hashing the source or dest. - |! path| means there was an error reading or hashing the source or dest.
The ` + "`--dest-after`" + ` flag writes a list file using the same format flags The |--dest-after| flag writes a list file using the same format flags
as [` + "`lsf`" + `](/commands/rclone_lsf/#synopsis) (including [customizable options as [|lsf|](/commands/rclone_lsf/#synopsis) (including [customizable options
for hash, modtime, etc.](/commands/rclone_lsf/#synopsis)) for hash, modtime, etc.](/commands/rclone_lsf/#synopsis))
Conceptually it is similar to rsync's ` + "`--itemize-changes`" + `, but not identical Conceptually it is similar to rsync's |--itemize-changes|, but not identical
-- it should output an accurate list of what will be on the destination -- it should output an accurate list of what will be on the destination
after the copy. after the copy.
When the ` + "`--no-traverse`" + ` flag is set, all logs involving files that exist only When the |--no-traverse| flag is set, all logs involving files that exist only
on the destination will be incomplete or completely missing. on the destination will be incomplete or completely missing.
Note that these logger flags have a few limitations, and certain scenarios Note that these logger flags have a few limitations, and certain scenarios
are not currently supported: are not currently supported:
- ` + "`--max-duration`" + ` / ` + "`CutoffModeHard`" + ` - |--max-duration| / |CutoffModeHard|
- ` + "`--compare-dest`" + ` / ` + "`--copy-dest`" + ` - |--compare-dest| / |--copy-dest|
- server-side moves of an entire dir at once - server-side moves of an entire dir at once
- High-level retries, because there would be duplicates (use ` + "`--retries 1`" + ` to disable) - High-level retries, because there would be duplicates (use |--retries 1| to disable)
- Possibly some unusual error scenarios - Possibly some unusual error scenarios
Note also that each file is logged during the copy, as opposed to after, so it Note also that each file is logged during the copy, as opposed to after, so it

35
cmd/move/move.go
View File

@ -74,39 +74,38 @@ for more info.
## Logger Flags ## Logger Flags
The ` + "`--differ`" + `, ` + "`--missing-on-dst`" + `, ` + "`--missing-on-src`" + `, ` + The |--differ|, |--missing-on-dst|, |--missing-on-src|, |--match| and |--error| flags write paths,
"`--match`" + ` and ` + "`--error`" + ` flags write paths, one per line, to the file name (or one per line, to the file name (or stdout if it is |-|) supplied. What they write is described
stdout if it is ` + "`-`" + `) supplied. What they write is described in the in the help below. For example |--differ| will write all paths which are present
help below. For example ` + "`--differ`" + ` will write all paths which are on both the source and destination but different.
present on both the source and destination but different.
The ` + "`--combined`" + ` flag will write a file (or stdout) which contains all The |--combined| flag will write a file (or stdout) which contains all
file paths with a symbol and then a space and then the path to tell file paths with a symbol and then a space and then the path to tell
you what happened to it. These are reminiscent of diff files. you what happened to it. These are reminiscent of diff files.
- ` + "`= path`" + ` means path was found in source and destination and was identical - |= path| means path was found in source and destination and was identical
- ` + "`- path`" + ` means path was missing on the source, so only in the destination - |- path| means path was missing on the source, so only in the destination
- ` + "`+ path`" + ` means path was missing on the destination, so only in the source - |+ path| means path was missing on the destination, so only in the source
- ` + "`* path`" + ` means path was present in source and destination but different. - |* path| means path was present in source and destination but different.
- ` + "`! path`" + ` means there was an error reading or hashing the source or dest. - |! path| means there was an error reading or hashing the source or dest.
The ` + "`--dest-after`" + ` flag writes a list file using the same format flags The |--dest-after| flag writes a list file using the same format flags
as [` + "`lsf`" + `](/commands/rclone_lsf/#synopsis) (including [customizable options as [|lsf|](/commands/rclone_lsf/#synopsis) (including [customizable options
for hash, modtime, etc.](/commands/rclone_lsf/#synopsis)) for hash, modtime, etc.](/commands/rclone_lsf/#synopsis))
Conceptually it is similar to rsync's ` + "`--itemize-changes`" + `, but not identical Conceptually it is similar to rsync's |--itemize-changes|, but not identical
-- it should output an accurate list of what will be on the destination -- it should output an accurate list of what will be on the destination
after the move. after the move.
When the ` + "`--no-traverse`" + ` flag is set, all logs involving files that exist only When the |--no-traverse| flag is set, all logs involving files that exist only
on the destination will be incomplete or completely missing. on the destination will be incomplete or completely missing.
Note that these logger flags have a few limitations, and certain scenarios Note that these logger flags have a few limitations, and certain scenarios
are not currently supported: are not currently supported:
- ` + "`--max-duration`" + ` / ` + "`CutoffModeHard`" + ` - |--max-duration| / |CutoffModeHard|
- ` + "`--compare-dest`" + ` / ` + "`--copy-dest`" + ` - |--compare-dest| / |--copy-dest|
- server-side moves of an entire dir at once - server-side moves of an entire dir at once
- High-level retries, because there would be duplicates (use ` + "`--retries 1`" + ` to disable) - High-level retries, because there would be duplicates (use |--retries 1| to disable)
- Possibly some unusual error scenarios - Possibly some unusual error scenarios
Note also that each file is logged during the move, as opposed to after, so it Note also that each file is logged during the move, as opposed to after, so it

47
cmd/sync/sync.go
View File

@ -3,6 +3,7 @@ package sync
import ( import (
"context" "context"
"strings"
"github.com/rclone/rclone/cmd" "github.com/rclone/rclone/cmd"
"github.com/rclone/rclone/fs/config/flags" "github.com/rclone/rclone/fs/config/flags"
@ -29,7 +30,8 @@ func init() {
var commandDefinition = &cobra.Command{ var commandDefinition = &cobra.Command{
Use: "sync source:path dest:path", Use: "sync source:path dest:path",
Short: `Make source and dest identical, modifying destination only.`, Short: `Make source and dest identical, modifying destination only.`,
Long: `Sync the source to the destination, changing the destination // Warning! "|" will be replaced by backticks below
Long: strings.ReplaceAll(`Sync the source to the destination, changing the destination
only. Doesn't transfer files that are identical on source and only. Doesn't transfer files that are identical on source and
destination, testing by size and modification time or MD5SUM. destination, testing by size and modification time or MD5SUM.
Destination is updated to match source, including deleting files Destination is updated to match source, including deleting files
@ -38,7 +40,7 @@ want to delete files from destination, use the
[copy](/commands/rclone_copy/) command instead. [copy](/commands/rclone_copy/) command instead.
**Important**: Since this can cause data loss, test first with the **Important**: Since this can cause data loss, test first with the
` + "`--dry-run` or the `--interactive`/`-i`" + ` flag. |--dry-run| or the |--interactive|/|i| flag.
rclone sync --interactive SOURCE remote:DESTINATION rclone sync --interactive SOURCE remote:DESTINATION
@ -61,55 +63,54 @@ destination that is inside the source directory.
Rclone will sync the modification times of files and directories if Rclone will sync the modification times of files and directories if
the backend supports it. If metadata syncing is required then use the the backend supports it. If metadata syncing is required then use the
` + "`--metadata`" + ` flag. |--metadata| flag.
Note that the modification time and metadata for the root directory Note that the modification time and metadata for the root directory
will **not** be synced. See https://github.com/rclone/rclone/issues/7652 will **not** be synced. See https://github.com/rclone/rclone/issues/7652
for more info. for more info.
**Note**: Use the ` + "`-P`" + `/` + "`--progress`" + ` flag to view real-time transfer statistics **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. **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. See [this forum post](https://forum.rclone.org/t/sync-not-clearing-duplicates/14372) for more info.
## Logger Flags ## Logger Flags
The ` + "`--differ`" + `, ` + "`--missing-on-dst`" + `, ` + "`--missing-on-src`" + `, ` + The |--differ|, |--missing-on-dst|, |--missing-on-src|, |--match| and |--error| flags write paths,
"`--match`" + ` and ` + "`--error`" + ` flags write paths, one per line, to the file name (or one per line, to the file name (or stdout if it is |-|) supplied. What they write is described
stdout if it is ` + "`-`" + `) supplied. What they write is described in the in the help below. For example |--differ| will write all paths which are present
help below. For example ` + "`--differ`" + ` will write all paths which are on both the source and destination but different.
present on both the source and destination but different.
The ` + "`--combined`" + ` flag will write a file (or stdout) which contains all The |--combined| flag will write a file (or stdout) which contains all
file paths with a symbol and then a space and then the path to tell file paths with a symbol and then a space and then the path to tell
you what happened to it. These are reminiscent of diff files. you what happened to it. These are reminiscent of diff files.
- ` + "`= path`" + ` means path was found in source and destination and was identical - |= path| means path was found in source and destination and was identical
- ` + "`- path`" + ` means path was missing on the source, so only in the destination - |- path| means path was missing on the source, so only in the destination
- ` + "`+ path`" + ` means path was missing on the destination, so only in the source - |+ path| means path was missing on the destination, so only in the source
- ` + "`* path`" + ` means path was present in source and destination but different. - |* path| means path was present in source and destination but different.
- ` + "`! path`" + ` means there was an error reading or hashing the source or dest. - |! path| means there was an error reading or hashing the source or dest.
The ` + "`--dest-after`" + ` flag writes a list file using the same format flags The |--dest-after| flag writes a list file using the same format flags
as [` + "`lsf`" + `](/commands/rclone_lsf/#synopsis) (including [customizable options as [|lsf|](/commands/rclone_lsf/#synopsis) (including [customizable options
for hash, modtime, etc.](/commands/rclone_lsf/#synopsis)) for hash, modtime, etc.](/commands/rclone_lsf/#synopsis))
Conceptually it is similar to rsync's ` + "`--itemize-changes`" + `, but not identical Conceptually it is similar to rsync's |--itemize-changes|, but not identical
-- it should output an accurate list of what will be on the destination -- it should output an accurate list of what will be on the destination
after the sync. after the sync.
Note that these logger flags have a few limitations, and certain scenarios Note that these logger flags have a few limitations, and certain scenarios
are not currently supported: are not currently supported:
- ` + "`--max-duration`" + ` / ` + "`CutoffModeHard`" + ` - |--max-duration| / |CutoffModeHard|
- ` + "`--compare-dest`" + ` / ` + "`--copy-dest`" + ` - |--compare-dest| / |--copy-dest|
- server-side moves of an entire dir at once - server-side moves of an entire dir at once
- High-level retries, because there would be duplicates (use ` + "`--retries 1`" + ` to disable) - High-level retries, because there would be duplicates (use |--retries 1| to disable)
- Possibly some unusual error scenarios - Possibly some unusual error scenarios
Note also that each file is logged during the sync, as opposed to after, so it Note also that each file is logged during the sync, as opposed to after, so it
is most useful as a predictor of what SHOULD happen to each file is most useful as a predictor of what SHOULD happen to each file
(which may or may not match what actually DID.) (which may or may not match what actually DID.)
`, `, "|", "`"),
Annotations: map[string]string{ Annotations: map[string]string{
"groups": "Sync,Copy,Filter,Listing,Important", "groups": "Sync,Copy,Filter,Listing,Important",
}, },