rsynconfig v2.6.3

rsynconfig

One config file for all rsync.

Installation

npm: npm i -g rsynconfig

yarn: yarn global add rsynconfig

make: make > uses npm under the hood

Usage

Run rsynconfig -h for more information about CLI arguments

Create template '.rsynconfig.toml' file

rsynconfig init

Example

Edit or create .rsynconfig.toml file into root of the project:

exclude = ['.rsync-filter']

[[destinations]]
name = 'sshtest'
src = './dir0/'
delete = false
flags = 'u'
[destinations.ssh.dest]
  host = 'localhost'
  user = 'lil'
  path = '/dir1/'
  key = './my.key'

[[destinations]]
name = 'localtest'
src = 'dir0/'
dest = 'dir1/'
delete = true
flags = 'dra'

Examples by others

• lil5 link

Please contact me I would love to have more examples.

Run synchronization

rsynconfig run localtest

# dry run
rsynconfig dry localtest

# name can be a glob to run multiple
rsynconfig run *test

# async run
# possibly handy for remote synchronization with large files
rsynconfig async localtest

# restore
# restore files from given dest to src
# delete is always false; flags is 'a'
rsynconfig restore localtest

Config file options

Not Another Markup Language (NAML)

Using -c <filename>.<exten> you can make your config file under the following extentions:

• json
• hjson
• json5
• cson
• yaml
• toml
• ini

Nodejs Module

const rsynconfig = require('rsynconfig')

rsynconfig(configFile, destinationsName, cwd)
.then((result) => {
  // result.names[...]
  // result.logs[...]
})
.catch(error => {
  if (error) {
    DEBUG
    ? console.error(error.message)
    : console.error(error.stack);
  }

  // ..
})

Globals are used for log verbosity

global.DEBUG = true
global.QUIET = false

License

MIT.