mirror of
https://github.com/rclone/rclone.git
synced 2025-11-23 21:44:49 +02:00
d4edf8ac18
As of v1.71, bisync is officially out of beta.
Some history:
- bisync was born in 2018 as https://github.com/cjnaz/rclonesync-V2
by @cjnaz, written in python.
- In 2021, @ivandeex ported it to go with @cjnaz's support.
https://github.com/rclone/rclone/pull/5164
- It was introduced as an "experimental" feature in v1.58.
6210e22ab5
- In 2023, bisync needed a new maintainer, and @nielash volunteered.
https://forum.rclone.org/t/bisync-bugs-and-feature-requests/37636
- Later in 2023, bisync received a major overhaul and was relabeled "beta"
(from "experimental"). https://github.com/rclone/rclone/pull/7410
- In 2024, integration tests were introduced for bisync (which previously had
only unit tests). https://github.com/rclone/rclone/pull/7693
- As of August 2025, bisync is stable and integration tests are passing on all
of the "flagship" backends.
Development doesn't stop here, of course. But bisync has come a long way since
its "experimental" days, and the "beta" tag is no longer needed.
65 lines
2.7 KiB
Go
65 lines
2.7 KiB
Go
package bisync
|
|
|
|
import (
|
|
"strconv"
|
|
"strings"
|
|
)
|
|
|
|
func makeHelp(help string) string {
|
|
replacer := strings.NewReplacer(
|
|
"|", "`",
|
|
"{MAXDELETE}", strconv.Itoa(DefaultMaxDelete),
|
|
"{CHECKFILE}", DefaultCheckFilename,
|
|
// "{WORKDIR}", DefaultWorkdir,
|
|
)
|
|
return replacer.Replace(help)
|
|
}
|
|
|
|
var shortHelp = `Perform bidirectional synchronization between two paths.`
|
|
|
|
var rcHelp = makeHelp(`This takes the following parameters
|
|
|
|
- path1 - a remote directory string e.g. |drive:path1|
|
|
- path2 - a remote directory string e.g. |drive:path2|
|
|
- dryRun - dry-run mode
|
|
- resync - performs the resync run
|
|
- checkAccess - abort if {CHECKFILE} files are not found on both filesystems
|
|
- checkFilename - file name for checkAccess (default: {CHECKFILE})
|
|
- maxDelete - abort sync if percentage of deleted files is above
|
|
this threshold (default: {MAXDELETE})
|
|
- force - Bypass maxDelete safety check and run the sync
|
|
- checkSync - |true| by default, |false| disables comparison of final listings,
|
|
|only| will skip sync, only compare listings from the last run
|
|
- createEmptySrcDirs - Sync creation and deletion of empty directories.
|
|
(Not compatible with --remove-empty-dirs)
|
|
- removeEmptyDirs - remove empty directories at the final cleanup step
|
|
- filtersFile - read filtering patterns from a file
|
|
- ignoreListingChecksum - Do not use checksums for listings
|
|
- resilient - Allow future runs to retry after certain less-serious errors, instead of requiring resync.
|
|
- workdir - server directory for history files (default: |~/.cache/rclone/bisync|)
|
|
- backupdir1 - --backup-dir for Path1. Must be a non-overlapping path on the same remote.
|
|
- backupdir2 - --backup-dir for Path2. Must be a non-overlapping path on the same remote.
|
|
- noCleanup - retain working files
|
|
|
|
See [bisync command help](https://rclone.org/commands/rclone_bisync/)
|
|
and [full bisync description](https://rclone.org/bisync/)
|
|
for more information.`)
|
|
|
|
var longHelp = shortHelp + makeHelp(`
|
|
|
|
[Bisync](https://rclone.org/bisync/) provides a
|
|
bidirectional cloud sync solution in rclone.
|
|
It retains the Path1 and Path2 filesystem listings from the prior run.
|
|
On each successive run it will:
|
|
- list files on Path1 and Path2, and check for changes on each side.
|
|
Changes include |New|, |Newer|, |Older|, and |Deleted| files.
|
|
- Propagate changes on Path1 to Path2, and vice-versa.
|
|
|
|
Bisync is considered an **advanced command**, so use with care.
|
|
Make sure you have read and understood the entire [manual](https://rclone.org/bisync)
|
|
(especially the [Limitations](https://rclone.org/bisync/#limitations) section) before using,
|
|
or data loss can result. Questions can be asked in the [Rclone Forum](https://forum.rclone.org/).
|
|
|
|
See [full bisync description](https://rclone.org/bisync/) for details.
|
|
`)
|