Simple and safe python wrapper for calling system rsync
Project description
sysrsync
Simple and safe native rsync wrapper for Python 3
Requirements
- rsync
- python 3.6+
development:
- poetry (be sure to have both poetry and pip upgraded to the latest version)
Installation
pip install sysrsync
Basic rules
- Syncs source contents by default, so it adds a trailing slash to the end of source, unless
sync_source_contents=False
is specified - Removes trailing slash from destination
- Extra arguments are put right after
rsync
- Breaks if
source_ssh
anddestination_ssh
are both set
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'
- sync whole folder
import sysrsync
sysrsync.run(source='/home/user/files',
destination='/home/server/',
sync_source_contents=False)
# runs 'rsync /home/user/files /home/server'
- sync folder contents
import sysrsync
sysrsync.run(source='/home/user/files',
destination='/home/server/',
sync_source_contents=True)
# runs 'rsync /home/user/files/ /home/server'
- 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 destination_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.3.2.tar.gz
(4.7 kB
view hashes)