Class Pipe<T>

This is useful when you need to do a series of operations on an object, perhaps conditionally.

example

Say we have a Collection of items, and want to apply some transformations and filtering based on arguments:

const collection = collect([1, 2, 3, 4, 5, 6, 7, 8, 9])

function transform(collection, evensOnly = false, returnEntireCollection = false) {
    return Pipe.wrap(collection)
       .when(evensOnly, coll => {
           return coll.filter(x => !(x % 2))
       })
       .unless(returnEntireCollection, coll => {
           return coll.take(3)
       })
       .tap(coll => {
           return coll.map(x => x * 2))
       })
       .get()
}

transform(collection)  // => Collection[2, 4, 6]

transform(collection, true)  // => Collection[4, 8, 12]

transform(collection, false, true)  // => Collection[2, 4, 6, 8, 10, 12, 14, 16, 18]