Merge pull request #193 from ipfs/tests/options-block

`block stat` + tests + readme update

Author: daviddias

README.md

@@ -81,6 +81,8 @@ The tests folder also contains great examples that can be used to understand how
 
 ##### block
 
+- [examples](https://github.com/ipfs/js-ipfs-api/blob/master/test/api/block.spec.js)
+
 ##### object
 
 **Curl**

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()
+    })
+  })
 })