A Node module for abstracting file management and interfacing with a variety of cloud storages. Currently a work in progress.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.

README.md

Many-Cloud

Build Status Coverage Status npm version

Many Cloud is an open source utility that creates an interface for many cloud platforms found online that, after authentication, abstracts out which cloud service you are manipulating for the sake of simplicity.

Documentation

Steps to use: Firstly, you need to authenticate with whatever cloud services you will be using. For more information, see the authentication docs. Here is an example for authenticating with Google Drive:

//Initial authentication
let connection  = require("many-cloud").integration("GoogleDrive")({
	authentication_token:  authentication_token,
	redirect_uri:  redirect_uri
});

//Future authentication
let connection = require("many-cloud").integration("GoogleDrive")({
	access_token:  access_token,
	expiry_date:  expiry_date,
	refresh_token:  refresh_token,
	token_type:  "Bearer",
	force_reset:  true //Optionally forces a refresh of the access token
});

Authenticate the users with whatever integration you are using and then you will have access to the file/folder Abstractions. Here's an example:

//Require the folder abstraction
const Folder = require("many-cloud/abstractions/folder");

//Get the root folder of our connection (to any of the supported drives)
let root_folder = new Folder("root", connection);

//List the files in the root folder
//This will return an array of File and Folder abstractions
let file_list = await root_folder.list_files();
//Download all of the files in the root folder (but not the folders)
for(let i = 0; i < file_list.length; i++) {
	if(file_list[i].type === 'file') {
		let name = await file_list[i].get_name();
		await file_list[i].download_to('some/local/storage/' + name);
	}
}

Supported Cloud Services

Platform Supported
Google Drive Yes
Box Yes
S3 Yes
Dropbox To do
More to come!