Skip to main content

a command line interface and FUSE filesystem for Amazon Cloud Drive

Project description

Donate via PayPal Join the Gitter chat PyPi

acd_cli

acd_cli provides a command line interface to Amazon Drive and allows Unix users to mount their drive using FUSE for read and (sequential) write access. It is currently in beta stage.

Node Cache Features

  • local caching of node metadata in an SQLite database

  • addressing of remote nodes via a pathname (e.g. /Photos/kitten.jpg)

  • file search

CLI Features

  • tree or flat listing of files and folders

  • simultaneous uploads/downloads, retry on error

  • basic plugin support

File Operations

  • upload/download of single files and directories

  • streamed upload/download

  • folder creation

  • trashing/restoring

  • moving/renaming nodes

Documentation

The full documentation is available at https://acd-cli.readthedocs.io.

Quick Start

Have a look at the known issues, then follow the setup guide and authorize. You may then use the program as described in the usage guide.

CLI Usage Example

In this example, a two-level folder hierarchy is created in an empty drive. Then, a relative local path local/spam is uploaded recursively using two connections.

$ acd_cli sync
  Getting changes...
  Inserting nodes..

$ acd_cli ls /
  [PHwiEv53QOKoGFGqYNl8pw] [A] /

$ acd_cli mkdir /egg/
$ acd_cli mkdir /egg/bacon/

$ acd_cli upload -x 2 local/spam/ /egg/bacon/
  [################################]   100.0% of  100MiB  12/12  654.4KB/s

$ acd_cli tree
  /
      egg/
          bacon/
              spam/
                  sausage
                  spam
  [...]

The standard node listing format includes the node ID, the first letter of its status and its full path. Possible statuses are “AVAILABLE” and “TRASH”.

Known Issues

It is not possible to upload files using Python 3.2.3, 3.3.0 and 3.3.1 due to a bug in the http.client module.

API Restrictions

  • the current upload file size limit is 50GiB

  • uploads of large files >10 GiB may be successful, yet a timeout error is displayed (please check the upload by syncing manually)

  • storage of node names is case-preserving, but not case-sensitive (this should not concern Apple users)

  • it is not possible to share or delete files

Contribute

Have a look at the contributing guidelines.

Recent Changes

0.3.2

  • added --remove-source-files argument to upload action

  • added --times` argument to download action for preservation of modification times

  • added streamed overwrite action

  • fixed upload of directories containing broken symlinks

  • disabled FUSE autosync by default

  • added timeout handling for uploads of large files

  • fixed exit status >=256

  • added config files

  • added syncing to/from file

  • fixed download of files with failed (incomplete) chunks

0.3.1

  • general improvements for FUSE

  • FUSE write support added

  • added automatic logging

  • sphinx documentation added

0.3.0

  • FUSE read support added

0.2.2

  • sync speed-up

  • node listing format changed

  • optional node listing coloring added (for Linux or via LS_COLORS)

  • re-added possibility for local OAuth

0.2.1

  • curl dependency removed

  • added job queue, simultaneous transfers

  • retry on error

0.2.0

  • setuptools support

  • workaround for download of files larger than 10 GiB

  • automatic resuming of downloads

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

acdcli-0.3.2.tar.gz (53.3 kB view details)

Uploaded Source

Built Distribution

acdcli-0.3.2-py3-none-any.whl (62.2 kB view details)

Uploaded Python 3

File details

Details for the file acdcli-0.3.2.tar.gz.

File metadata

  • Download URL: acdcli-0.3.2.tar.gz
  • Upload date:
  • Size: 53.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for acdcli-0.3.2.tar.gz
Algorithm Hash digest
SHA256 9c094cb7f11c5586cfd6fbd4e7409d8ace1aaf14080847958fc69ee56fef69aa
MD5 aa1093375a490adceee69544ae3c92ea
BLAKE2b-256 e744bdc8b77f7e9156db61da67d5e423215a9c6993036cbaf1bbe2dfabb6a07f

See more details on using hashes here.

File details

Details for the file acdcli-0.3.2-py3-none-any.whl.

File metadata

File hashes

Hashes for acdcli-0.3.2-py3-none-any.whl
Algorithm Hash digest
SHA256 972a1801ccefbe1df9cb9c2d8af30b4d8adbb9b441acc032249366c1b725c9ea
MD5 860f2618a60d47d47f471fc48208bb3b
BLAKE2b-256 df5dd96fcc1368623228ea2eaa86b58aa05381b2b652b8250e310ac69164aa6c

See more details on using hashes here.

Supported by

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