https://github.com/hopsoft/pipe_envy

Elixir style pipe operator for Ruby
https://github.com/hopsoft/pipe_envy

data-transformation elixir ruby

Last synced: 1 day ago
JSON representation

Elixir style pipe operator for Ruby

• Host: GitHub
• URL: https://github.com/hopsoft/pipe_envy
• Owner: hopsoft
• License: mit
• Created: 2017-07-28T20:46:32.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2017-08-02T03:33:44.000Z (over 7 years ago)
• Last Synced: 2024-12-26T10:05:06.992Z (15 days ago)
• Topics: data-transformation, elixir, ruby
• Language: Ruby
• Size: 16.6 KB
• Stars: 47
• Watchers: 4
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
[![Lines of Code](http://img.shields.io/badge/lines_of_code-30-brightgreen.svg?style=flat)](http://blog.codinghorror.com/the-best-code-is-no-code-at-all/)

[![Code Status](http://img.shields.io/codeclimate/github/hopsoft/pipe_envy.svg?style=flat)](https://codeclimate.com/github/hopsoft/pipe_envy)

[![Dependency Status](http://img.shields.io/gemnasium/hopsoft/pipe_envy.svg?style=flat)](https://gemnasium.com/hopsoft/pipe_envy)

[![Build Status](http://img.shields.io/travis/hopsoft/pipe_envy.svg?style=flat)](https://travis-ci.org/hopsoft/pipe_envy)

[![Coverage Status](https://img.shields.io/coveralls/hopsoft/pipe_envy.svg?style=flat)](https://coveralls.io/r/hopsoft/pipe_envy?branch=master)

[![Downloads](http://img.shields.io/gem/dt/pipe_envy.svg?style=flat)](http://rubygems.org/gems/pipe_envy)

[![Sponsor](https://app.codesponsor.io/embed/QMSjMHrtPhvfmCnk5Hbikhhr/hopsoft/pipe_envy.svg)](https://app.codesponsor.io/link/QMSjMHrtPhvfmCnk5Hbikhhr/hopsoft/pipe_envy)

# PipeEnvy

## WARNING

This lib is experimental & is probably not a good idea.

> PipeEnvy overrides the pipe operator `|` on Array & Integer.

> It also adds it to Object.

## Fun Stuff

[Elixir's pipe operator](https://elixir-lang.org/getting-started/enumerables-and-streams.html#the-pipe-operator)

is very cool & supports intuitive reasoning about data transformations similar to [Unix pipelines](https://en.wikipedia.org/wiki/Pipeline_(Unix)).

```elixir

"Elixir Rocks" |> String.upcase |> String.split # => ["ELIXIR", "ROCKS"]

```

Rubyists can now enjoy this same mental model of data transformation.

```sh

gem install pipe_envy

```

```ruby

require "pipe_envy"

# refinements that apply extensions to Object, Array, & Integer in the current scope

using PipeEnvy

"Ruby Rocks" | :upcase | :split # => ["RUBY", "ROCKS"]

```

Here's a more sophisticated albeit contrived example.

*Notice that methods which require arguments are piped as Arrays.*

```ruby

magic = (1..100) \

  | :to_a \

  | [:select!, -> (i) { i.even? }] \

  | [:map, -> (i) { i ** 10 }] \

  | :sum \

  | Math.method(:sqrt) \

  | :to_s \

  | :chars \

  | :reverse \

  | [:[], 3] \

  | :to_i

# => 7

```

Be sure to check out [Chainable Methods](https://github.com/akitaonrails/chainable_methods) which offers similar behavior.

Here's another example similar to the one on the `chainable_methods` repo.

```ruby

magic = "foo bar http://github.com/hopsoft/pipe_envy foo bar" \

  | URI.method(:extract) \

  | :first \

  | URI.method(:parse) \

  | :open \

  | :readlines \

  | :join \

  | Nokogiri::HTML.method(:parse) \

  | [:css, "h1"] \

  | :first \

  | :text \

  | :strip

# => "hopsoft/pipe_envy"

```