dropsync

A simple Dropbox CLI-client written in Python, using the official Dropbox-API.

Installation

pipx install git+https://github.com/Herrminator/dropsync.git

You need Python with pipx installed (python -m pip install pipx).

Usage

usage: dbxmirror [-h] [-d {download,upload,both}] [-x EXCLUDE] [-i INCLUDE] [-k KEEP] [-y TRSYMLINK] [-n] [-l] [-t TOKEN] [-T TIMEOUT] [-m METADB] [-R]
                   [-Y] [-D] [-v] [--dry-run] [-V]
                   local [remote]

positional arguments:
  local
  remote

options:
  -h, --help            show this help message and exit
  -d {download,upload,both}, --direction {download,upload,both}
  -x EXCLUDE, --exclude EXCLUDE
                        RegEx matching remote path
  -i INCLUDE, --include INCLUDE
                        RegEx overriding exclude
  -k KEEP, --keep KEEP  RegEx preventing delete
  -y TRSYMLINK, --trsymlink TRSYMLINK
                        Translate path for symlinks: '<org>;<local>'
  -n, --no-delete       Only transfer, don't delete files
  -l, --login           Force new login
  -t TOKEN, --token TOKEN
                        Use an existing token. E.g. from https://www.dropbox.com/developers/apps/info/60ya9v6io1n23e5#settings
  -T TIMEOUT, --timeout TIMEOUT
                        Timeout for remote dropbox operations
  -m METADB, --metadb METADB
                        Metadata file. Always located in local folder
  -R, --resetmeta
  -Y, --ignsymlink      Ignore symlink errors
  -D, --dir-only        Only synchronize directory structure
  -v, --verbose         Specify multiple times to increase verbosity
  --dry-run             Do not transfer or delete any files
  -V, --version         Print version and exit

m

Test Scripts

For convenience and platform compatibility testing, a script to run unit tests is included. This script accepts the same parameters as python -m unittest.

For online tests, you need a developer Token 😢, which can be set via the environment variable DBXMIRROR_DEVELOPER_TOKEN. Online tests work out-of-the-box, if your Dropbox has a folder named /tmp/test/sync. Otherwise you can set it to any other folder using DBXMIRROR_TEST_FOLDER. Be careful to choose a rather small one, as every file in it will be transferred temporarily.

Limitations

For now, dbxmirror is download only!