goto-bus-stop/imgur-blob-store

upload and download images from imgur through an abstract-blob-store compatible interface

imgur-blob-store

A blob store that stores images on Imgur.

Installation

With npm:

npm install --save imgur-blob-store

Usage

var fs = require('fs')
var spawn = require('child_process').spawn
var imgur = require('imgur-blob-store')

var store = imgur({
  token: 'abcdef123456'
})

// writing to imgur
fs.createReadStream('/tmp/my-image.png')
  .pipe(store.createWriteStream(function (err, img) {
    if (err) throw err
    // removing images--requires the deletehash
    store.remove({ deletehash: img.deletehash }, function () {})
  }))

// reading from imgur
var feh = spawn('feh', ['-'])
store.createReadStream('qzq4eCj').pipe(feh.stdin)

// exists
store.exists('pU7nQnP', function (err, exists) {
})

API

var imgur = require('imgur-blob-store')(options)

Available options are:

• token - an imgur API client ID. Get one from https://api.imgur.com/oauth2/addclient

imgur.createWriteStream(options, cb)

Returns a writable stream. options is optional and ignored, imgur will assign a key for you.

cb is called with (err, metadata) when the upload failed or completed. metadata is the data object returned by imgur (https://apidocs.imgur.com/#58306db8-0a6f-4aa1-a021-bdad565f153e). Some useful properties are:

• key - The ID of the image, for use with createReadStream and other methods
• deletehash - The deletehash of the image, for use with remove()
• link - The publically accessible URL to the image
• type - Detected mime type
• width / height - Image dimensions
• size - Size of the image in bytes, this can be different from the original size because imgur compresses images

imgur.createReadStream(options)

Returns a readable stream. options.key should be an imgur image ID.

imgur.exists(options, cb)

Checks if an image exists. options.key should be an imgur image ID. Calls cb with (err, exists).

imgur.remove(options, cb)

Deletes an image from imgur. options.deletehash should be the image's delete hash. Calls cb with (err).

License

MIT

imgur-blob-store's Issues

Action required: Greenkeeper could not be activated 🚨

🚨 You need to enable Continuous Integration on all branches of this repository. 🚨

To enable Greenkeeper, you need to make sure that a commit status is reported on all branches. This is required by Greenkeeper because we are using your CI build statuses to figure out when to notify you about breaking changes.

Since we did not receive a CI status on the greenkeeper/initial branch, we assume that you still need to configure it.

If you have already set up a CI for this repository, you might need to check your configuration. Make sure it will run on all new branches. If you don’t want it to run on every branch, you can whitelist branches starting with greenkeeper/.

We recommend using Travis CI, but Greenkeeper will work with every other CI service as well.