vim-arsync 🐙

vim plugin for asynchronous synchronisation of remote files and local files using rsync

Main features

sync up or down project folder using rsync (with compression options etc. -> -avzhe ssh )
ignore certains files or folder based on configuration file
asynchronous operation
project based configuration file
auto sync up on file save
works with ssh-keys (recommended) or plaintext password in config file

Installation

Dependencies

rsync
vim8 or neovim
sshpass (optional: only needed when using plaintext password in config file)

Using vim-plug

Place this in your .vimrc:

Plug 'kenn7/vim-arsync'

... then run the following in Vim:

:source %
:PlugInstall

Configuration

Create a .vim-arsync file on the root of your project that contains the following:

remote_host     example.com
remote_user    john
remote_port    22
remote_passwd  secret 
remote_path     ~/temp/
local_path    /home/ken/temp/vuetest/
ignore_path     ["build/","test/"]
ignore_dotfiles 1
auto_sync_up    0
remote_or_local remote
sleep_before_sync 0

Required fields are:

remote_host remote host to connect (must have ssh enabled)
remote_path remote folder to be synced

Optional fields are:

remote_user username to connect with
remote_passwd password to connect with (requires sshpass) (needed if not using ssh-keys)
remote_port remote ssh port to connect to (default is 22)
local_path local folder to be synced (defaults to folder of .vim-arsync)
ignore_path list of ingored files/folders
ignore_dotfiles set to 1 to not sync dotfiles (e.g. .vim-arsync)
auto_sync_up set to 1 for activating automatic upload syncing on file save
remote_or_local set to 'local' if you want to perform syncing localy
sleep_before_sync set to x seconds if you want to sleep before sync(like compiling a file before syncing)

NB: fields can be commented out with #

Usage

If auto_sync_up is set to 1, the plugin will automatically launch the :ARsyncUP command everytime a buffer is saved.

Commands

:ARshowConf shows detected configuration
:ARsyncUp Syncs files up to the remote (upload local to remote)
:ARsyncUpDelete Syncs files up to the remote (upload local to remote) and delete remote files not existing on local (be careful with that)
:ARsyncDown Syncs files down from the remote (download remote to local)

Commands can be mapped to keyboard shortcuts enhance operations

TODO

run more tests
handle -u (update) feature of rsync ?
deactivate auto sync on error
better handle comments in conf file

Acknoledgements

This plugin was inspired by vim-hsftp but vim-arsync offers more (rsync, ignore, async...).

This plugins ships with the async.vim library for async operation with vim and neovim.

Gao-Yifeng/vim-arsync