Skip to main content

Python ctypes wrapper for librsync.

Project description

SmartFile

A SmartFile Open Source project. Read more about how SmartFile uses and contributes to Open Source software.

Travis CI Status Code Coverage Latest PyPI version Number of PyPI downloads

Introduction

A ctypes wrapper for librsync. Provides signature(), delta(), and patch() functions.

There are three steps necessary to synchronize a file. Two steps are performed on the source file and one on the destination.

  1. Generate a signature for the destination file.

  2. Generate a delta for the source file (using the signature).

  3. Patch the destination file using the generated delta.

Usually, these steps involve remote systems. Here is an example of synchronizing two local files.

import librsync

# The destination file.
dst = file('Resume-v1.0.pdf', 'rb')

# The source file.
src = file('Resume-v1.2.pdf', 'rb')

# Where we will write the synchronized copy.
synced = file('Resume-latest.pdf', 'wb')

# Step 1: prepare signature of the destination file
signature = librsync.signature(dst)

# Step 2: prepare a delta of the source file
delta = librsync.delta(src, signature)

# Step 3: synchronize the files.
# In many cases, you would overwrite the destination with the result of
# synchronization. However, by default a new file is created.
librsync.patch(dst, delta, synced)

Extending

This wrapper only exposes the most common operations that librsync provides. It is not meant to be a full wrapper, but should cover most use-cases. You can easily extend this wrapper. Information about librsync is available in it’s manual which is linked below (I wish I had found this BEFORE writing this wrapper!)

http://rproxy.samba.org/doxygen/librsync/refman.pdf

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

python-librsync-0.1-5.tar.gz (5.0 kB view details)

Uploaded Source

File details

Details for the file python-librsync-0.1-5.tar.gz.

File metadata

File hashes

Hashes for python-librsync-0.1-5.tar.gz
Algorithm Hash digest
SHA256 9f4fcb94f5cbffb281b2c8caafe635c0859809e3f9fddac5f1b717b10c78e776
MD5 2ef0ae3aff4f91003a8e4b98190cc2af
BLAKE2b-256 c341dddea6524fb9d8a8444946fc63d7b6b5bc0686e1323e0823aee2bf4cf333

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page