acd_cli aims to provide a command line interface to Amazon Cloud Drive written in Python 3. It is currently in alpha stage.
##Features
- local node caching
- addressing of nodes via a pathname (e.g.
/Photos/kitten.jpg
) - tree listing of files and folders
- upload/download of single files and directories
- background hashing
- folder creation
- trashing/restoring
- moving/renaming nodes
##Planned
- "smart" folder syncing
- shell completion
- processing of incremental changes
- ... minor stuff
##Quick start If you have not done so already, register a security profile with Amazon and whitelist your profile for the Cloud Drive API. Refer to https://developer.amazon.com/public/apis/experience/cloud-drive/content/getting-started for further details.
As this is a local application, your security profile must include http://localhost
as an allowed return url.
If you select your profile in the the 'Security Profile Management' (https://developer.amazon.com/iba-sp/overview.html), this setting can be found in the 'Web Settings' tab, named 'Allowed Return URLs'.
Enter your security profile's client credentials ('Client ID' and 'Client Secret') into the JSON file named client_data
.
On the first start of the program (try ./acd_cli.py sync
), you will have to complete the OAuth procedure.
You will be asked to visit a URL, log into Amazon and paste the URL that you have been redirected to into the console.
##Usage
The following actions are built in
sync (s) refresh node list cache; necessary for many actions
clear-cache (cc) clear node cache
tree (t) print directory tree [uses cached data]
upload (ul) file and directory upload to a remote destination
overwrite (ov) overwrite node A [remote] with file B [local]
download (dl) download a remote file; will overwrite local files
create (c, mkdir) create folder
list-trash (lt) list trashed nodes [uses cached data]
trash (tr) move to trash
restore (re) restore from trash
children (ls) list folder's children [uses cached data]
move (mv) move node A into folder B
rename (rn) rename a node
And some more
resolve (rs) resolve a path to a node id
add-child add a node to a parent folder
remove-child remove a node from a parent folder
usage show drive usage data
quota show drive quota
metadata print a node's metadata
changes list changes
Please run ./acd_cli.py --help
to get a current list of the available actions. You may also get a list of further arguments and their order of an action by calling ./acd_cli.py [action] --help
.
You may provide most node arguments as a 22 character ID or a UNIX-style path. Trashed nodes' paths might not be able to be resolved correctly; use their ID instead.
##Usage example
$ ./acd_cli.py sync
# Syncing... Done.
$ ./acd_cli.py tree
# [PHwiEv53QOKoGFGqYNl8pw] [A] /
$ ./acd_cli.py create /egg/
$ ./acd_cli.py create /egg/bacon/
$ ./acd_cli.py upload local/spam/ /egg/bacon/
#Current directory: local/spam/
#Current file: local/spam/sausage
# [##################################################] 100.00% of 20.0MiB
#Current file: local/spam/lobster
# [##################################################] 100.00% of 10.0MiB
[...]
$ ./acd_cli.py tree
# [PHwiEv53QOKoGFGqYNl8pw] [A] /
# [ ... ] [A] /egg/
# [ ... ] [A] /egg/bacon/
# [ ... ] [A] /egg/bacon/spam/
# [ ... ] [A] /egg/bacon/spam/sausage
# [...]
##Known Issues
- Nodes with multiple parents might mess up the cache
Feel free to use the bug tracker to add issues. You might find the --verbose
and --debug
options helpful.
##Dependencies
- pycurl
- requests
- sqlalchemy
- dateutils
##Changelog
new:
- overwriting of files
- recursive upload/download
- hashing of downloaded files
- clear-cache action
fixes:
- remove-child accepted status code
- fix for upload of files with Unicode characters
other:
- changed database schema