Asynchronous Retrieving Rust rSYNc Client
A tokio-based rsync wire protocol client library for listing files on and downloading from rsyncd servers.
Status
Incredibly alpha. It seems to do the thing, which is: retrieve a list of files on the server, and then retrieve some of those files whole. But don't look at it sharply…
Limitations
- Rsyncd only, no execute-over-ssh.
- Rsync protocol 27.0 only (Fortunately, newer rsyncds do fallbacks.)
- Dates are parsed as i32. (I hope this library and maybe even rsync are dead by 2038…)
- The MOTD and error messages are
loged, but can't otherwise be intercepted. - Protocol error handling is probably flawed.
- Use of
anyhow. - No tests
Related crates
- rsyn
is probably closest in functionality, implements an rsync wire protocol client. Sadly, the library is aimed directly at implementing an rsync client CLI clone, so getting a
Readfor the retrieved files is not possible. - rrsync implements its own wire protocol(?).
- rsync-list
seems to parse the output of executing
rsync. Brr. - librsync-sys, librsync-ffi, fast_rsync only do the delta calculation. arrsync may depend on them in the future.
- libsyncr remains a mystery to me.