About

This is a small cli application that integrates with Google Drive. The application is able to perform the following tasks:

1. Authenticate the user using OAuth 2.0.
2. List files in the user’s Google Drive.
3. Upload a file to the user’s Google Drive.
4. Download a file from the user’s Google Drive.
5. Delete a file from the user’s Google Drive

Here's why:

• Allows the user to quickly manage their google drive from the terminal
• Improves efficiency by preventing the user from having to switch away from their terminal

Getting Started

To get a local copy up and running follow these simple example steps.

Prerequisites

Install dependencies using the following methods.

• Git
• Python 3.10.7 or greater
• The pip package management tool
• A Google Cloud project.
• A Google account with Google Drive enabled.

Installation

1. Clone the repo

   git clone [email protected]:Jorgensonnj/google-ftp.git

2. Install python packages

   pip install --upgrade google-api-python-client google-auth-httplib2 google-auth-oauthlib

   or

   sudo pacman -S python-google-api-python-client python-google-auth-httplib2 python-google-auth-oauthlib

3. Create Google Account with Google Drive API enabled
4. Create Google Cloud Project
5. Create and save credentials for a desktop application as a JSON file named creds.json, and move the file to your google-ftp project root directory

Usage

Here are some examples of the cli in use

• Listing all files

  ./gftp.py ls

• Uploading a file

  ./gftp.py ucp ~/test.docx

• Downloading a file

  ./gftp.py dcp "test.docx" ~/test.docx

• Removing a file

  ./gftp.py rm "test.docx"

Testing

How to test

1. Navigate to project root directory

   cd /path/to/google-ftp

2. Run Tests

   python3 -m test.tests

Assumptions

• The user is familiar with the command line and is able to execute the program
• The user is more comfortable giving a file name from their google drive than providing a file id
• The google drive contains only files and no folders
• The user is able to save files to their file system