/drive-cli

A command line interface for accessing google drive

Primary LanguagePythonMIT LicenseMIT

Briefly-logo

Drive Cli

PyPI version Python version Build Status License: MIT

Get the ability to access Google Drive without leaving your terminal.


Inspiration

  • Google Drive has become a vital part of our day to day life. As much as non-programmers use it, so do programmers in several situations, where we need not use git/github.

  • Drive-CLI is a command-line utility for google drive which helps you access, sync, download, upload, etc. directly to your drive without leaving the command-line. The best part being the commands are similar to git CLI so that you can easily remember them 💆


Features

  • view-files: list your files; filter them by name, type.
  • clone: download file/folder from drive using sharing link or file ID and get it linked.
  • add-remote: upload existing local file to drive and get it linked.
  • cat: view files contents of text format without actually downloading them.
  • rm: remove particular file or folder.
  • ls: list all the files present in the drive of equivalent current directory.
  • status: list changes made to local files since last push or pull.
  • pull: get latest changes from drive to local files.
  • push: push the local changes to drive.

Demo


Installation

  • For Usage
    #install using pip 
    $ pip install drive-cli
  • For Development
    • clone the repo
        $ git clone https://github.com/nurdtechie98/drive-cli.git
    • get your client_secret.json from Oauth. Make sure to enable Drive Api for the project.
    • rename the client secret to oauth.json and place it in the drive_cli directory.
    • install the package:
        # move into package directory
        $ cd drive-cli
        # install package in edit mode
        $ pip install -e . #note the dot

Usage

Clone

Download a file or folder present in drive using its file id or its sharing link. In case it is a folder it gets tracked.

# using file id note: since it is google doc it will be asked for a choice to select from
$ drive clone 1syTNkfXoc3pzpJSL0Z5LDioTFc46_LjzHjDDUvk90ks
Choose type to export to
 (ENTER to select, s to stop):

 => pdf
    txt
    doc
    zip
    html
    rtf
    odt
Preparing: watson script for download
downloading file  [####################################]  100%
completed download of watson script

# using file sharing link
$ drive clone https://docs.google.com/document/d/1syTNkfXoc3pzpJSL0Z5LDioTFc46_LjzHjDDUvk90ks
Choose type to export to
 (ENTER to select, s to stop):

 => pdf
    txt
    doc
    zip
    html
    rtf
    odt
Preparing: watson script for download
downloading file  [####################################]  100%
completed download of watson script

for further in depth documetation checkout our wiki.


Uninstalling

    $ pip uninstall drive-cli

Contributing

  • We're are open to enhancements & bug-fixes 😄. Take a look here to get started
  • Feel free to add issues and submit patches

Author

Chirag Shetty - nurdtechie98

See also the list of contributors who participated in this project.


License

This project is licensed under the MIT - see the LICENSE file for details.