add feature block stat + test + readme reference to tests as examples

Author: daviddias

src/api/block.js

@@ -5,6 +5,7 @@ const argCommand = require('../cmd-helpers').argCommand
 module.exports = send => {
   return {
     get: argCommand(send, 'block/get'),
+    stat: argCommand(send, 'block/stat'),
     put (file, cb) {
       if (Array.isArray(file)) {
         return cb(null, new Error('block.put() only accepts 1 file'))

test/api/block.spec.js

@@ -25,4 +25,13 @@ describe('.block', () => {
         })
     })
   })
+
+  it('block.stat', done => {
+    apiClients['a'].block.stat(blorbKey, (err, res) => {
+      expect(err).to.not.exist
+      expect(res).to.have.property('Key')
+      expect(res).to.have.property('Size')
+      done()
+    })
+  })
 })