Adds API for ipfs.files.get.

Author: hackergrrl

README.md

@@ -57,9 +57,44 @@ A valid (read: that follows this interface) IPFS core implementation, must expos
 
 ## Files
 
+### `get`
+
+> Get [UnixFS][] files from IPFS.
+
+##### `Go` **WIP**
+
+##### `JavaScript` - ipfs.files.get(hash, [callback])
+
+Where `hash` is an IPFS multiaddress or multihash.
+
+`callback` must follow `function (err, stream) {}` signature, where `err` is an
+error if the operation was not successful. `stream` will be a Readable stream,
+outputting objects of the form
+
+```js
+{
+  path: '/tmp/myfile.txt',
+  content: Readable stream
+}
+```
+
+If no `callback` is passed, a promise is returned with the Readable stream.
+
+Example:
+
+```js
+ipfs.files.get('QmQ2r6iMNpky5f1m4cnm3Yqw8VSvjuKpTcK1X7dBR1LkJF', function (err, stream) {
+  stream.on('data', (file) => {
+    console.log(file.path)
+    file.content.pipe(process.stdout)
+  })
+})
+```
+
+
 ### `add`
 
-> Add files and data to IPFS.
+> Add [UnixFS][] files and data to IPFS.
 
 ##### `Go` **WIP**
 
@@ -433,3 +468,4 @@ If no `callback` is passed, a [promise][] is returned.
 [DAGNode]: https://github.com/vijayee/js-ipfs-merkle-dag
 [multihash]: http://github.com/jbenet/multihash
 [promise]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise
+[UnixFS]: https://github.com/ipfs/specs/tree/master/unixfs