cloudsync README

Python Cloud Synchronization Library

Installation

pip install cloudsync

# install provider support
pip install cloudsync-gdrive

Command-line Example

cloudsync sync --help

cloudsync sync file:c:/users/me/documents gdrive:/mydocs

# on linux you can pass -D for 'daemon mode', which will detatch and run in the background

Example of a single cloud provider integration

import cloudsync

# Get a generic client_id and client_secret. Do not use this in production code.
# For more information on getting your own client_id and client_secret, see README_OAUTH.md
oauth_config = cloudsync.command.utils.generic_oauth_config('gdrive')

# get an instance of the gdrive provider class
provider = cloudsync.create_provider('gdrive', oauth_config=oauth_config)

# Start the oauth process to login in to the cloud provider
creds = provider.authenticate()

# Use the credentials to connect to the cloud provider
provider.connect(creds)

# Perform cloud operations
for entry in provider.listdir_path("/"):
    print(entry.path)

Example of a syncronization between two cloud providers

import cloudsync
import tempfile
import time

# a little setup
local_root = tempfile.mkdtemp()
remote_root = "/cloudsync_test/" + time.strftime("%Y%m%d%H%M")
provider_name = 'gdrive'
print("syncronizing between %s locally and %s on %s" % (local_root, remote_root, provider_name))

# Get a generic client_id and client_secret. Do not use this in production code.
# For more information on getting your own client_id and client_secret, see README_OAUTH.md
cloud_oauth_config = cloudsync.command.utils.generic_oauth_config(provider_name)

# get instances of the local file provider and cloud provider from the provider factory
local = cloudsync.create_provider("filesystem")
remote = cloudsync.create_provider(provider_name, oauth_config=cloud_oauth_config)

# Authenticate with the remote provider using OAuth
creds = remote.authenticate()

# Connect with the credentials acquired by authenticating with the provider
local.namespace = local_root  # filesystem provider wants to know the root namespace before connecting
local.connect(None)
remote.connect(creds)

# Create the folder on google drive to syncronize locally
print("Creating folder %s on %s" % (remote_root, provider_name))
remote.mkdirs(remote_root)  # provider.mkdirs() will automatically create any necessary parent folders

# Specify which folders to syncronize
sync_roots = (local_root, remote_root)

# instantiate a new sync engine and start syncing
sync = cloudsync.CloudSync((local, remote), roots=sync_roots)
sync.start()

# should sync this file as soon as it's noticed by watchdog
local_hello_path = local.join(local_root, "hello.txt")
print("Creating local file %s" % local_hello_path)
with open(local_hello_path, "w") as f:
    f.write("hello")

# note remote.join, NOT os.path.join... Gets the path separator correct
remote_hello_path = remote.join(remote_root, "hello.txt")

# wait for sync to upload the new file to the cloud
while not remote.exists_path(remote_hello_path):
    time.sleep(1)

remote_hello_info = remote.info_path(remote_hello_path)

# rename in the cloud
local_goodbye_path = local.join(local_root, "goodbye.txt")
remote_goodbye_path = remote.join(remote_root, "goodbye.txt")
print("renaming %s to %s on %s" % (remote_hello_path, remote_goodbye_path, provider_name))
remote.rename(remote_hello_info.oid, remote_goodbye_path)  # rename refers to the file to rename by oid

# wait for sync to cause the file to get renamed locally
while not local.exists_path(local_goodbye_path):
    time.sleep(1)

print("synced")

sync.stop(forever=True)
local.disconnect()
remote.disconnect()

Metadata

Release files for cloudsync 3.4.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for cloudsync 3.4.0
File	Size	Uploaded
cloudsync-3.4.0.tar.gz	262.1 kB	Nov 16, 2022	Details

Built distribution (wheel)

Table of built distributions (wheels) for cloudsync 3.4.0
File	Interpreter	ABI	Platform	Reset
cloudsync-3.4.0-py3-none-any.whl 226.1 kB Nov 16, 2022	Python 3	none	any	Details

Total release size: 488.1 kB

Release files / cloudsync-3.4.0.tar.gz

Download URL	cloudsync-3.4.0.tar.gz
Size	262.1 kB
Tags	Source
SHA-256 checksum How to use checksums	`621c19411799f43f4e4631b154187b2b5d80ce737dd19ef955fdc972bb8fb72a`
BLAKE2b-256 checksum How to use checksums	`e87a8dd486af89197e8b70a2b6ba93cce7668f5e7c586462c521359259475121`
Upload date	Nov 16, 2022
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`python-requests/2.27.1`

Release files / cloudsync-3.4.0-py3-none-any.whl

Download URL	cloudsync-3.4.0-py3-none-any.whl
Size	226.1 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`f12f89979d39bfbbcfbee41db518196cfe1a705a349cc24ebeaa43276aba4f5e`
BLAKE2b-256 checksum How to use checksums	`c4068a2bc3e81d38ba289095007e3ebcbdb36fed0f03f17eb85b1cf0841a3663`
Upload date	Nov 16, 2022
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`python-requests/2.27.1`