Skip to content

A Node module for abstracting file management and interfacing with a variety of cloud storages. Currently a work in progress.

License

Notifications You must be signed in to change notification settings

marcdubs/many-cloud

Repository files navigation

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. Many Cloud keeps things simple by automatically refreshing OAuth2 tokens and by providing an object-oriented approach to dealing with Files and Folders.

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").abstraction("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
Azure File Share Yes
Azure Blob Yes
More to come!

About

A Node module for abstracting file management and interfacing with a variety of cloud storages. Currently a work in progress.

Resources

License

Stars

Watchers

Forks

Packages

No packages published