kami-gsuite 0.1.0

Kami Google Drive

---

Simple functions to create folder and upload files using google drive api

📝 Table of Contents

• About
• Getting Started
• Deployment
• Usage
• Built Using
• TODO
• Contributing
• Authors
• Acknowledgments

🧐 About

This package arose from the need to simplify the google drive management tasks of applications created by the Kami CO software development team.

Currently the package has 6 functions: get_service, connect, get_folder_id, create_folder, upload_file, upload_files

🏁 Getting Started

These instructions will get you a copy of the package and a daily use example.

Prerequisites

• python >= 3.9
• kami-logging >= 0.2.0
• google-api-core >= 2.11.0
• google-api-python-client >= 2.50.0
• google-auth-httplib2 >= 0.1.0
• google-auth-oauthlib >= 0.5.2
• google-auth >= 2.7.0
• googleapis-common-protos >= 1.56.2

Installing

$pip install kami-gdrive

🎈 Usage

To get work with this package first you need to create an project and an agent and get json file with correspondent credentials jus the way of google drive api documentation find here

The 6 functions available are:

• get_service():

Get a service that communicates to a Google API.

Args:

• api_name : The name of the api to connect to.
• api_version : The api version to connect to.
• scopes : A list auth scopes to authorize for the application.
• key_file_location : The path to a valid service account JSON key file.

Returns: A service that is connected to the specified API.

• connect(service_account_credentials):

Connect with google drive api service.

Args:

• service_account_credentials : The path to a valid service account JSON key file.

Returns: A google drive api service.

• get_folder_id(parent_folder_id, folder_name):

Get id of a folder in driver if its exists.

Args:

• parent_folder_id : Id to root or parent folder when search will begin.
• folder_name : Searched folder name

Returns: Id to folder or None

• create_folder(parent_folder_id, folder_name):

• Create New Folder in especified parent folder.

Args:

• parent_folder_id : Id to root or parent folder when new folder will be created.
• folder_name : Name for the new folder

Returns: Id to new folder or None

• upload_file(folder_id, this_file):

• Upload an local file to especified folder on google drive.

Args:

• folder_id : Id to the folder when this file will be uploaded.
• this_file : Absolute or Relative full path to the local file.

Returns: Show an log with the result of process

• upload_files(folder_id, files_list):

• Upload an list of local file to especified folder on google drive.

Args:

• folder_id : Id to the folder when this file will be uploaded.
• files_list : List of Absolute or Relative full path to the each local file.

Returns: Show an log with the result of process

example:

from kami_gdrive import create_folder, get_folder_id, upload_file
root_folder_id = '1eAnlW53WAOJn-eaLdM2AqRYnl0ui9qrL'
my_new_folder_id = create_folder(root_folder_id, 'my_new_folder')
local_file = 'Path/To/My/file.ext'
upload_file(my_new_folder_id, local_file)

Result:

⛏️ Built Using

• Python - Database
• Logging - Server Framework

✍️ Authors

• @maicondmenezes - Idea & Initial work

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

🎉 Acknowledgements

• References:
  • Arjancodes: Github, Youtube, Twitter
  • Eduardo Mendes: Github, Youtube, Twitter