asynchronous generic cloud drive library
Project description
wcpan.drive
Asynchronous generic cloud drive library.
This package needs a driver to actually work with a cloud drive.
Example Usage
from wcpan.drive.core.drive import (
DriveFactory, download_to_local, upload_from_local,
)
async def simple_demo():
# Load config and data from default locations.
factory = DriveFactory()
factory.load_config()
async with factory() as drive:
# Check for authorization.
if not await drive.is_authorized():
# Start OAuth 2.0 process
url = await drive.get_oauth_url()
# ... The user visits the url ...
# Get tokens from the user.
token = ...
# Finish OAuth 2.0 process.
await drive.set_oauth_token(token)
# It is important to keep cache in sync.
async for change in drive.sync():
print(change)
# Get the root node.
root_node = await drive.get_root_node()
# Get a node.
node = await drive.get_node_by_path('/path/to/drive/file')
# List children.
children = await drive.get_children(root_node)
# Make a folder.
new_folder = await drive.create_folder(root_node, 'folder_name')
# Download file.
await download_to_local(drive, node, '/tmp')
# Upload file.
new_file = await upload_from_local(drive, root_node, '/path/to/local/file')
# Traverse drive.
async for root, folders, files in drive.walk(root_node):
print(root, folders, files)
async def config_demo():
factory = DriveFactory()
# Read config files from here.
# The default is $HOME/.config/wcpan.drive.
# These files are what you want to keep and backup.
factory.config_path = '/tmp/config'
# Put generated files here.
# The default is $HOME/.local/share/wcpan.drive.
# These files should be safely deleted.
factory.data_path = '/tmp/data'
# Setup cache database, will write to data folder.
factory.database = 'nodes.sqlite'
# Setup driver class.
factory.driver = 'some.random.driver.RandomDriver'
# load config file from config folder
# this will not overwrite the above given values
factory.load_config()
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
wcpan.drive.core-3.0.0.tar.gz
(19.0 kB
view hashes)
Built Distribution
Close
Hashes for wcpan.drive.core-3.0.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0fc272d746deb710df45b7397238c06811854880eac98add798175a5b865fe80 |
|
MD5 | f00da398e41956cb6ce9ad97827545a8 |
|
BLAKE2b-256 | fa15a67c2e4ba080f9c227fb93733d1c536db4ff54b013559752abd1f508fb59 |