either (#16)

README.md

@@ -9,7 +9,7 @@
 <p align="center">
   <a href="https://www.npmjs.com/package/tinyfunk"><img src="https://img.shields.io/npm/v/tinyfunk.svg" alt="npm version" style="max-width:100%;"></a>
   <a href="https://www.npmjs.com/package/tinyfunk"><img src="https://img.shields.io/npm/dm/tinyfunk.svg" alt="npm downloads" style="max-width:100%;"></a>
-  <a href="#"><img src="https://img.shields.io/badge/gzip--size-1.53%20kB-blue.svg" alt="gzip-size" style="max-width:100%;"></a>
+  <a href="#"><img src="https://img.shields.io/badge/gzip--size-1.55%20kB-blue.svg" alt="gzip-size" style="max-width:100%;"></a>
   <br />
   <a href="https://travis-ci.org/flintinatux/tinyfunk"><img src="https://travis-ci.org/flintinatux/tinyfunk.svg?branch=master" alt="Build Status" style="max-width:100%;"></a>
   <a href="https://coveralls.io/github/flintinatux/tinyfunk?branch=master"><img src="https://coveralls.io/repos/github/flintinatux/tinyfunk/badge.svg?branch=master" alt="Coverage Status" style="max-width:100%;"></a>
@@ -86,6 +86,7 @@ If you've lived with FP long enough, you are likely familiar with most of the fu
 | `defaultTo` | `a -> a -> a` |
 | `dissoc` | `k -> { k: v } -> { k: v }` |
 | `dissocPath` | `[k] -> { k: v } -> { k: v }` |
+| `either` | `(a -> Boolean) -> (a -> Boolean) -> (a -> Boolean)` |
 | `evolve` | `{ k: (v -> v) } -> { k: v } -> { k: v }` |
 | `filter` | `(a -> Boolean) -> [a] -> [a]` |
 | `find` | `(a -> Boolean) -> [a] -> a` |

src.js

@@ -123,6 +123,11 @@ const dissocPath = curry(([ head, ...tail ], obj) =>
   dissoc(head, obj)
 )
 
+// either :: (a -> Boolean) -> (a -> Boolean) -> (a -> Boolean)
+const either = curry((f, g, x) =>
+  f(x) || g(x)
+)
+
 // evolve :: { k: (v -> v) } -> { k: v } -> { k: v }
 const evolve = curry((xfrms, obj) => {
   return mapObj(_xfrm(xfrms), obj)
@@ -429,6 +434,7 @@ _assign(exports, {
   defaultTo,
   dissoc,
   dissocPath,
+  either,
   evolve,
   filter,
   find,

test/either.js

@@ -0,0 +1,20 @@
+const { expect } = require('chai')
+
+const { either, prop } = require('..')
+
+describe('either', () => {
+  const f = prop('f')
+  const g = prop('g')
+
+  const obj = { g: 'h' }
+
+  it('wraps two functions in an || operation', () =>
+    expect(either(f, g, obj)).to.equal('h')
+  )
+
+  it('is curried', () => {
+    expect(either(f)(g, obj)).to.equal('h')
+    expect(either(f, g)(obj)).to.equal('h')
+    expect(either(f)(g)(obj)).to.equal('h')
+  })
+})