© 2014 Thomas Khyn © 2003 Anand B Pillai
Advanced directory tree synchronisation tool
based on Python robocopier by Anand B Pillai
From the command line:
dirsync <sourcedir> <targetdir> [options]
From python:
from dirsync import sync sync(sourcedir, targetdir, action, **options)
Chosing one option among the following ones is mandatory
| --diff, -d | Only report difference between sourcedir and targetdir |
| --sync, -s | Synchronize content between sourcedir and targetdir |
| --update, -u | Update existing content between sourcedir and targetdir |
If you use one of the above options (e.g. sync) most of the time, you
may consider defining the action option in a Configuration file parsed
by dirsync.
| --verbose, -v | Provide verbose output |
| --purge, -p | Purge files when synchronizing (does not purge by default) |
| --force, -f | Force copying of files, by trying to change file permissions |
| --nodirection, -n | |
| Update files in source directory from target directory (only updates target from source by default) | |
| --create, -c | Create target directory if it does not exist (By default, target directory should exist.) |
| --modtime, -m | Only compare file's modification times for an update (By default, compares source file's creation time also) |
| --ignore, -x patterns | |
| Regex patterns to ignore | |
| --only, -o patterns | |
| Regex patterns to include (exclude every other) | |
| --exclude, -e patterns | |
| Regex patterns to exclude | |
| --include, -i patterns | |
| Regex patterns to include (with precedence over excludes) | |
Note
Configuration files are only used when using the command line, and ignored when dirsync is called from within Python.
If you want to use predefined options all the time, or if you need specific options when 'dirsyncing' a specific source directory, dirsync looks for two configuration files, by order or priority (the last takes precedence):
%HOME%/.dirsync source/directory/.dirsync
Warning
Any source/directory/.dirsync file is automatically excluded from the
files to compare. You have to explicitly include using the --include
option it if you want it to be covered by the comparison.
The command line options always override the values defined in the configuration files.
The configuration files must have a defaults section, and the options are
as defined above. The only exception is for the option action, which can
take 3 values diff, sync or update.
Example config file:
[defaults] action = sync create = True
From python, you may not want to have the output sent to stdout. To do so,
you can simply pass your custom logger via the logger keyword argument of
the sync function:
sync(sourcedir, targetdir, action, logger=my_logger, **options)