https://github.com/martimm/rsync
https://github.com/martimm/rsync
Last synced: 3 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/martimm/rsync
- Owner: MARTIMM
- License: artistic-2.0
- Created: 2016-11-03T16:16:58.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2020-06-01T07:37:42.000Z (about 5 years ago)
- Last Synced: 2025-04-09T21:52:55.626Z (3 months ago)
- Language: Raku
- Size: 23.4 KB
- Stars: 1
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Copying/backing up files using rsync
[](https://travis-ci.org/MARTIMM/RSync)
[](http://www.perlfoundation.org/artistic_license_2_0)
## Synopsis
An example TOML configuration might be
```
# Basic setup
[filters]
filter-sequence = [ 'i=include', 'e=exclude', 'f=filter', 'e=ex2']
exclude = [ 'old', 'Old', '*~']
ex2 = [ '*.html']
include = [ '*.pdf' ]
filter = [ '- Test/', '- test' ]
[options]
dry-run = true
verbose = 2
times = true
log = true
# My fotos
[targets.fotos]
source = '/home/Data/Fotos/'
[options.fotos]
log = false
dry-run = false
[filters.fotos]
exclude = [ '.precomp']
filter = [ ]
# On remote machine
[options.fotos.remote]
log = true
[targets.fotos.remote]
destination = '[email protected]:/home/Data/Fotos/'
# Duplicates
[options.fotos.dup]
dry-run = true
[targets.fotos.dup]
sources = [ '/home/Foo/Fotos/', '/home/Bar/Fotos/' ]
destination = '/mnt/Backup/Fotos/'
```
The following command;
```
fcopy config.toml fotos dup
```
will result in the rsync command and run
```
rsync --dry-run --times --verbose=2 --include='*.pdf' --exclude='.precomp' --exclude='*.html' '/home/Foo/Fotos/' '/home/Bar/Fotos/' '/mnt/Backup/Fotos/'
```
## Description
Rsync can be used from the commandline. The number of options is awsome and because of that difficult to remember. You can use the command from a script started by the cron schedular but, because there are so many options, it is difficult to remember what it does when you look at the command again. This distribution helps to replace those scripts with a command ```fcopy``` which merges one or more toml configuration files and construct the rsync command for you. The TOML file is easy to read and therefore easy to maintain.
## Documentation
See pod documentation in pdf format at
* [fcopy program](https://github.com/MARTIMM/RSync/blob/master/doc/fcopy.pdf)
* [File::RSync module](https://github.com/MARTIMM/RSync/blob/master/doc/RSync.pdf)
* [Release notes](https://github.com/MARTIMM/RSync/blob/master/doc/CHANGES.md)
## Versions of PERL, MOARVM
This project is tested with latest Rakudo built on MoarVM implementing Raku v6.d.
## Changes
* 2020-05-31 0.3.2
* make test changes after some errors.
* setup directory to do a real copy with data from config
## Authors
```
Marcel Timmerman (MARTIMM on github)
```