Fix example in IO docs

CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.9.1 (15 Jan 2020)
+- [new] add `fromPromise` and `toPromise` to `Either` -- thanks to @wookieb ( #223 )
+- [fix] fix `.isInstance` method -- thanks to @wookieb ( #221 )
+- [new] add `Either.fromTry` -- thanks to @rparree ( #211 )
+- [new] add `Maybe.fromEmpty` -- thanks to @customcommander ( #214 )
+
 ## 0.9.0 (19 Nov 2018)
 
 ### rc.3 (18 Nov 2018)

README.md

@@ -1,8 +1,10 @@
 # monet.js
 
-[![Build Status](https://travis-ci.org/monet/monet.js.png)](https://travis-ci.org/monet/monet.js)
+[![Build Status](https://travis-ci.org/monet/monet.js.svg)](https://travis-ci.org/monet/monet.js)
+
+
+For people who wish they didn't have to program in JavaScript. [documentation](https://github.com/monet/monet.js/tree/master/docs/README.md)
 
-For people who wish they didn't have to programme in JavaScript. [documentation](https://github.com/monet/monet.js/tree/master/docs/README.md)
 
 ## Introduction
 
@@ -24,7 +26,7 @@ Full detailed documentation can be found [here](https://github.com/monet/monet.j
 npm install monet --save
 
 # or to install a specific version
-npm install [email protected].0
+npm install [email protected].1
 ```
 
 ### Download
@@ -88,7 +90,7 @@ Please see [Ken Scambler](http://twitter.com/KenScambler)'s [excellent talk](htt
 Written and maintained by Chris Myers [@cwmyers](https://twitter.com/cwmyers) and Jakub Strojewski [@ulfryk](https://twitter.com/ulfryk). Follow Monet.js at [@monetjs](http://twitter.com/monetjs).
 
 [functionalJava]: http://functionaljava.org/
-[gitZip]: https://github.com/monet/monet.js/archive/v0.9.0.zip
-[gitTar]: https://github.com/monet/monet.js/archive/v0.9.0.tar.gz
+[gitZip]: https://github.com/monet/monet.js/archive/v0.9.1.zip
+[gitTar]: https://github.com/monet/monet.js/archive/v0.9.1.tar.gz
 [npm]: https://www.npmjs.com/
 [scalaz]: https://github.com/scalaz/scalaz

docs/EITHER.md

@@ -30,6 +30,20 @@ const success = val.right()
 const failure = 'some error'.left()
 ```
 
+### Creating an Either from an exception
+
+```javascript
+const i = 1;
+Either.fromTry(() => i.toPrecision(500))
+```
+
+
+### Creating an Either from a Promise
+```javascript
+Either.fromPromise(Promise.resolve({foo: 'bar'})) // Promise of Either.Right
+Either.fromPromise(Promise.reject(new Error('error'))) // Promise of Either.Left
+```
+
 ## Methods
 
 ### map
@@ -213,6 +227,14 @@ Either[E,A].toMaybe(): Maybe[A]
 
 Converts to a `Maybe` dropping the left side.
 
+### toPromise
+
+```scala
+Either[E,A].toPromise(): Promise[A]
+```
+
+Converts to resolved Promise on the right side and rejected Promise on the left side.
+
 ### ...and undocumented
 - equals
 - join

docs/IO.md

@@ -95,7 +95,7 @@ const read = id => IO(() => $(id).text())
 const write = id => value => IO(() => $(id).text(value))
 ```
 
-You can call `write(id)` until you are blue in the face but all it will do is return an `IO` with a function inside.
+You can call `write(id)('foo')` until you are blue in the face but all it will do is return an `IO` with a function inside.
 
 We can now call `map` and `flatMap` to chain this two effects together. Say we wanted to read from a `div`, convert all the text to uppercase and then write back to that `div`.
 

docs/MAYBE.md

@@ -1,6 +1,6 @@
 # Maybe
 
-The `Maybe` type is the most common way of representing *nothingness* (or the `null` type) with making the possibilities of `NullPointer` issues disappear.
+The `Maybe` type is the most common way of representing *nothingness* (or the `null` type) while making the possibilities of `NullPointer` issues disappear.
 
 `Maybe` is effectively abstract and has two concrete subtypes: `Some` (also `Just`) and `None` (also `Nothing`).
 
@@ -45,6 +45,14 @@ Maybe.fromFalsy(false)
 Maybe.fromUndefined()
 Maybe.fromUndefined(undefined)
 // => None
+
+Maybe.fromEmpty()
+Maybe.fromEmpty(undefined)
+Maybe.fromEmpty(null)
+Maybe.fromEmpty('')
+Maybe.fromEmpty([])
+Maybe.fromEmpty({})
+// => None
 ```
 
 **It's important to note that monet `Maybe` implementation treats `null` and `undefined` values in special way. Any attempt to provide `null` or `undefined` to constructor (other than `fromNull` or `fromFalsy`) will cause exception (also `fromUndefined(null)` will throw). Same will happen if it's mapped to `null` or `undefined`.**

docs/READER.md

@@ -24,7 +24,7 @@ One quick win would be to `curry` the `createPrettyName` function, and make `ren
 ```javascript
 const createPrettyName = name => printer => printer.write("hello " + name)
 
-const render = () => createPrettyName("Tom")
+const render = createPrettyName("Tom") // render(printer)
 ```
 
 This is better, but what if `render` wants to perform some sort of operation on the result of `createPrettyName`? It would have to apply

docs/VALIDATION.md

@@ -55,7 +55,7 @@ Fail('grr').map(val => val + 1)
 Validation[E,A].failMap(fn: E => F): Validation[F,A]
 ```
 
-This will apply the supplied function over the left side of the either, if one exists, otherwise it returns the `Either` untouched. For example:
+This will apply the supplied function over the fail side of the validation, if one exists, otherwise it returns the `Success` untouched. For example:
 
 ```javascript
 Success('lol').failMap(e => e + 1)