Metadata-Version: 2.1
Name: drive_cli
Version: 1.0.3
Summary: CLI client for Google Drive
Home-page: https://github.com/nurdtechie98/drive-cli
Author: Chirag Shetty
Author-email: nurdtechie98@gmail.com
License: UNKNOWN
Description: <p align="center">
          <a href="" rel="noopener">
         <img height=200px src="https://i.imgur.com/QEcBZSh.png" alt="Briefly-logo"></a>
        </p>
        
        <h1 align="center">Drive Cli</h1>
        
        <div align="center">
        
        [![PyPI version](https://badge.fury.io/py/drive-cli.svg)](https://badge.fury.io/py/drive-cli)
        [![](https://img.shields.io/badge/python-3.4+-blue.svg)](https://www.python.org/download/releases/3.4.0/)
        [![contributions welcome](https://img.shields.io/badge/contributions-welcome-brightgreen.svg?style=flat)](https://github.com/nurdtechie98/drive-cli/issues)
        [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
        [![HitCount](http://hits.dwyl.io/nurdtechie98/drive-cli.svg)](http://hits.dwyl.io/nurdtechie98/drive-cli)
        
        <h4>Get the ability to access <strong>Google Drive</strong> without leaving your terminal.</h4>
        
        </div>
        
        -----------------------------------------
        ### Inspiration
        
        * Google Drive has become a vital part of our day to day life. As much as non-programmer use it, so do programmers in several situations,where we need not use git/github. 
        
        * Drive-CLI is a command line utility tool for google drive which helps you access,sync, download,upload.. 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 :massage:  
        
        ------------------------------------------
        ### Features
        
        - `view-file` :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
        - `rm` :remove particular file or folder
        - `ls` :list put all the files present in the drive of equivalent current directory
        - `status` :list changes made to local files since last pull or pull
        - `pull` :get latest changes from drive to local files
        - `push` :push the changes made in remote to drive
        
        ------------------------------------------
        ### Installation
        * For Usage
        ```sh
            #install using pip 
            $ pip install drive-cli
        ```
        * For Development
            * clone the repo
            ```sh
                $ git clone https://github.com/nurdtechie98/drive-cli.git
            ```
            * get your client_secret.json from [Oauth](https://console.cloud.google.com/apis/credentials/oauthclient). Make sure to enable [Drive Api](https://console.cloud.google.com/apis/library/drive.googleapis.com?q=Drive) for the project.
            * rename the client secret as oauth.json and place it inside [drive_cli](./drive_cli) directory.
            * install the package
            ```sh
                # move into package directory
                $ cd drive-cli
                # install package in edit mode
                $ pip install -e . #note the dot
            ```
        
        ------------------------------------------
        ### Usage
        #### Help 
        Any command in particular command or the entire list of commands can be displayed using **help** command
        ```sh
        $ drive --help
        
        Usage: drive [OPTIONS] COMMAND [ARGS]...
        
        Options:
          --help  Show this message and exit.
        
        Commands:
          add_remote  upload any existing file to drive
          clone       download any file using sharing link or file ID it will be
                      automatically tracked henceforth
          login       login to your google account and authenticate the service
          logout      logout from the account logged in with
          ls          list out all the files present in this directory in the drive
                      for tracked directories
          pull        get latest updates from online drive of the file
          push        push modification from local files to the drive
          rm          delete a particular file in drive
          status      list changes commited since last sync
          view-files  filter search files and file ID for files user has access to
        
        ```
        #### Add Remote
        Existing files or folders that have not been added to drive can be added and get tracked. 
        Incase you need to add a particular file use file flag.
        The file folder can also be added inside particular parent folder in the drive using the file id of the folder
        
        ```sh
        # adding entire folder named test to drive
        $ cd test
        $ drive add_remote
        Created a tracked directory
        uploading .DS_Store
        uploading main.js
        uploading test.html
        uploading style.css
        
        # adding a particular file(mailer.py) in current directory
        $ drive add_remote --file mailer.py
        uploaded mailer.py
        
        #adding the file or folder inside particular parent file(test) using its file id
        $ drive add_remote --file mailer.py --pid 1RJOWpW5MuP9RXpgZbp9OdauhaBtJd49g
        uploaded mailer.py
        content added under directory test
        
        ```
        
        #### 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.
        
        ```sh
        # using file id note: since it is goodle doc it will be asked for a choice to select from
        $ drive clone --id 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 --link 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
        
        ```
        
        ------------------------------------------
        ### Uninstalling
        
        ```sh
            $ pip uninstall drive-cli
        ```
        ------------------------------------------
        ### Contributing
        
         * We're are open to `enhancements` & `bug-fixes` :smile:.
         * Feel free to add issues and submit patches
        
        ------------------------------------------
        ### Author
        Chirag Shetty - [nurdtechie98](https://github.com/nurdtechie98)
        
        See also the list of [contributors](https://github.com/nurdtechie98/drive-cli/graphs/contributors) who participated in this project.
        
        ------------------------------------------
        ### License
        This project is licensed under the MIT - see the [LICENSE](./LICENSE) file for details
        
        
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: End Users/Desktop
Classifier: Natural Language :: English
Classifier: Topic :: Utilities
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
