b2cloud v0.5.3

B2Cloud

A module for interacting with Back Blaze B2Cloud

Configuration

In ~/.b2cloud.json place your credentials

i.e. { "accountId": "", "applicationKey": "" }

Helpers

• function getBucketByName(bucketName, callback)
  • Retreives a bucket object by its name, rather than by bucketId
• function uploadFile(filePath, bucketName, callback)
  • Uploads a file
• function downloadFile(name, bucketName, savePath, range, callback)
  • Downloads a file
  • Range is an optional object with properties start and end i.e. { start: 0, end: 1000 }
  • Range is number of bytes (inclusive) that will be downloaded
  • See b2 documentation https://www.backblaze.com/b2/docs/b2_download_file_by_name.html

Please note this is being actively worked on and will soon support all API operations as listed here:

https://www.backblaze.com/b2/docs/

I also will be adding helpers methods such as uploadFile, getBucketByName to make it easier to use

Documentation

All methods can use promises or callbacks

Installation

npm install b2cloud

Setup a file .b2cloud in your home folder. Setup like this:,

{
        "accountId": "",
        "applicationKey": ""
}

Usage Example:

    var b2cloud = require('b2cloud');

    return b2cloud.authorize.getBasicAuth().then(function(auth) {
        console.log('authenticated', auth);

    });

Classes

Authorize

Kind: global class

• Authorize
  • new Authorize(cache)
  • .getBasicAuth([callback]) ⇒ object

new Authorize(cache)

authorize.getBasicAuth(callback) ⇒ object

Fetches an authenticated session for interacting with b2cloud.

Kind: instance method of Authorize Returns: object - auth Returns an authenticated session

Bucket

Kind: global class

• Bucket
  • new Bucket(cache)
  • .createBucket(name, type, [callback]) ⇒ object
  • .deleteBucket(bucketId, [callback]) ⇒ object
  • .listBuckets([callback]) ⇒ object
  • .getBucketByName(name, [callback]) ⇒ object
  • .listBucketFiles(name, [startFileName], [maxFileCount], [callback]) ⇒ object

new Bucket(cache)

bucket.createBucket(name, type, callback) ⇒ object

Creates a bucket in the b2cloud

Kind: instance method of Bucket Returns: object - The response from b2_create_bucket

bucket.deleteBucket(bucketId, callback) ⇒ object

Deletes a bucket from the b2cloud

Kind: instance method of Bucket Returns: object - The response from b2_create_bucket

bucket.listBuckets(callback) ⇒ object

Lists all buckets you have created.

Kind: instance method of Bucket Returns: object - The response from b2_list_buckets

bucket.getBucketByName(name, callback) ⇒ object

Helper function that returns a bucket object by its name.

Kind: instance method of Bucket Returns: object - The response from b2_list_buckets

bucket.listBucketFiles(name, startFileName, maxFileCount, callback) ⇒ object

Lists all files inside of a bucket.

Kind: instance method of Bucket Returns: object - The response from b2_list_file_names See: https://www.backblaze.com/b2/docs/b2_list_file_names.html

File

Kind: global class

• File
  • new File(cache)
  • .getUploadUrl(bucketName, [callback]) ⇒ object
  • .uploadFile(filePath, bucketName, [callback]) ⇒ object
  • .downloadFile(name, bucketName, savePath, range, [callback]) ⇒ Promsise
  • .deleteFileVersion(fileName, fileId, [callback]) ⇒ *

new File(cache)

Class constructor, instantiates auth and bucket classes

file.getUploadUrl(bucketName, callback) ⇒ object

Gets the uploadUrl for uploadinga file to b2cloud

Kind: instance method of File Returns: object - - The response from b2_get_upload_url

file.uploadFile(filePath, bucketName, callback) ⇒ object

Helper function that automatically generates the uploadUrl, hashes the file and uploads it to b2cloud.

Kind: instance method of File Returns: object - - The newly created b2cloud object.

file.downloadFile(name, bucketName, savePath, range, callback) ⇒ Promsise

Downloads a file from b2cloud

Kind: instance method of File Returns: Promsise - That resolves if the file is downloaded succesfully, otherwise rejects. See: https://www.backblaze.com/b2/docs/b2_download_file_by_name.html

file.deleteFileVersion(fileName, fileId, callback) ⇒ *

Deletes a specific version of a file from b2cloud.

Kind: instance method of File