Python module that wraps system calls to rsync
Project description
sysrsync
Python module that wraps system calls to rsync
Requirements
- rsync
- python 3.6+
development:
- pipenv (be sure to have both pipenv and pip upgraded to the latest version)
Usage
- Basic file sync
import sysrsync
sysrsync.run(source='/home/user/foo.txt',
destination='/home/server/bar')
# runs 'rsync /home/users/foo.txt /home/server/files'
- ssh with options
import sysrsync
sysrsync.run(source='/home/user/files',
destination='/home/server/files',
destination_ssh='myserver',
options=['-a'])
# runs 'rsync -a /home/users/files/ myserver:/home/server/files'
- exclusions
import sysrsync
sysrsync.run(source='/home/user/files',
destination='/home/server/files',
destination_ssh='myserver',
options=['-a'],
exclusions=['file_to_exclude', 'unwanted_file'])
# runs 'rsync -a /home/users/files/ myserver:/home/server/files --exclude file_to_exclude --exclude unwanted_file'
API
sysrsync.run
argument | type | default | description |
---|---|---|---|
cwd | str | os.getcwd() |
working directory in which subprocess will run the rsync command |
strict | bool | True |
raises RsyncError when rsync return code is different than 0 |
verbose | bool | False |
verbose mode: currently prints rsync command before executing |
**kwargs | dict | Not Applicable | arguments that will be forwarded to call to sysrsync.get_rsync_command |
returns: subprocess.CompletedProcess
raises: RsyncError
when strict = True
and rsync return code is different than 0 (Success)
sysrsync.get_rsync_command
argument | type | default | description |
---|---|---|---|
source | str | - | Source folder or file |
destination | str | - | Destination folder |
source_ssh | Optional[str] | None | Remote ssh client where source is located |
destination_ssh | Optional[str] | None | Remote ssh client where destination is located |
exclusions | Iterable[str] | [] | List of excluded patterns as in rsync's --exclude |
sync_source_contents | bool | True | Abstracts the elusive trailing slash behaviour that source normally has when using rsync directly, i.e. when a trailing slash is present in source , the folder's content is synchronized with destination. When no trailing slash is present, the folder itself is synchronized with destination. |
options | Iterable[str] | [] | List of options to be used right after rsync call, e.g. ['-a', '-v'] translates to rsync -a -v |
returns: List[str]
-> the compiled list of commands to be used directly in subprocess.run
raises: RemotesError
when both source_ssh
and target_ssh
are set. Normally linux rsync distribution disallows source and destination to be both remotes.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
sysrsync-0.1.2.tar.gz
(4.7 kB
view hashes)