matchrb 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: fb61077f3da5e5af7fd2ef01dbdd248b0c4ad5d1
+  data.tar.gz: bf16bb6c22c929cf20e1a2c1595b143fe3664951
+SHA512:
+  metadata.gz: e3fd2a0e2667e685a329abb316db4514ae39f6de64fd6d708f9c52573d0d0d876770dcb6b2e46a8842b2362d701fc8bdb0a0646ce63c7fb80213ed3a3a2095b3
+  data.tar.gz: 1298b29f54502424a1e77fb12d880f89ce99bc7af0c91861d378ddab9014848721961f4304090a7917775d1848dfe91a2c1a47fde95d97fa6c74aad62d471ccc

data/.gitignore

@@ -0,0 +1,22 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in matchrb.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,24 @@
+Copyright (c) 2014 Diogo Lisboa
+
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification,
+are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+this list of conditions and the following disclaimer in the documentation and/or
+other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

data/README.md

@@ -0,0 +1,55 @@
+# matchrb
+
+**matchrb** (pronounced 'matcherby') provides a simple but powerful way to do
+pattern matching in Ruby.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'matchrb'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install matchrb
+
+## Usage
+
+`matchrb` implements two methods, `#match` and `#otherwise`. You can use them
+globaly like so:
+
+```ruby
+require 'matchrb/global'
+
+object = 100
+match object,
+  String    => "object is a string",
+  Integer   => "object is an integer",
+  otherwise => "object is...just an object"
+```
+
+or, to avoid name clashes, use them individually:
+
+```ruby
+require 'matchrb'
+
+object = 100
+Matchrb.match object,
+  String            => "object is a string",
+  Integer           => "object is an integer",
+  Matchrb.otherwise => "object is...just an object"
+```
+
+That's it!
+
+## Contributing
+
+1. Fork it ( https://github.com/dlisboa/matchrb/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new Pull Request

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+
+desc "Run tests"
+task :test do
+  puts %x[ruby spec/*]
+end

data/lib/matchrb/global.rb

@@ -0,0 +1,2 @@
+require 'matchrb'
+Object.include(Matchrb)

data/lib/matchrb/version.rb

@@ -0,0 +1,3 @@
+module Matchrb
+  VERSION = "0.0.1"
+end

data/lib/matchrb.rb

@@ -0,0 +1,26 @@
+require "matchrb/version"
+
+module Matchrb
+  extend self
+
+  def match(something, patterns)
+    apply = lambda do |action, value|
+      return action unless action.respond_to?(:to_proc)
+
+      action = action.to_proc
+      action.arity.zero? ? action[] : action[value]
+    end
+
+    patterns.each do |pattern, action|
+      if (value = pattern === something)
+        return apply[action, value]
+      end
+    end
+
+    nil
+  end
+
+  def otherwise
+    Object
+  end
+end

data/matchrb.gemspec

@@ -0,0 +1,22 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'matchrb/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "matchrb"
+  spec.version       = Matchrb::VERSION
+  spec.authors       = ["Diogo Lisboa"]
+  spec.email         = ["diogoslisboa@gmail.com"]
+  spec.summary       = %q{A tiny play on pattern matching in Ruby.}
+  spec.description   = <<-EOS
+    matchrb (pronounced 'matcherby') provides a simple but powerful way to do
+    pattern matching in Ruby.
+  EOS
+  spec.homepage      = "https://github.com/dlisboa/matchrb"
+  spec.license       = "BSD"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.test_files    = spec.files.grep(%r{spec})
+  spec.require_paths = ["lib"]
+end

data/spec/match_spec.rb

@@ -0,0 +1,144 @@
+$:.unshift File.expand_path("../../lib", __FILE__)
+
+require "minitest/autorun"
+require "minitest/spec"
+
+require "matchrb/global"
+
+describe "match" do
+  describe "when the pattern is a class" do
+    it "matches the kind of the object" do
+      Foo = Class.new
+      foo = Foo.new
+
+      result = match foo,
+        Foo => "foo is Foo"
+
+      result.must_equal "foo is Foo"
+    end
+  end
+
+  describe "when the pattern is a Regexp" do
+    it "matches the regex against the object" do
+      result = match "this is a string",
+        /this is not a string/ => false,
+        /this is a.*/ => true
+
+      result.must_equal true
+    end
+  end
+
+  describe "when no pattern is matched" do
+    it "returns nil" do
+      result = match "this is a string",
+        Integer => false,
+        Class => true
+
+      result.must_equal nil
+    end
+  end
+
+  describe "when the action is an object" do
+    it "returns that object" do
+      someobject = Object.new
+
+      result = match 1,
+        Integer => someobject
+
+      result.object_id.must_equal someobject.object_id
+    end
+  end
+
+  describe "when the action is a :to_proc'able object" do
+    it "returns the result of calling that object" do
+      Identity = Class.new do
+        def initialize(number)
+          @number = number
+        end
+
+        def to_proc
+          -> { @number }
+        end
+      end
+
+      result = match 1,
+        Integer => Identity.new(10)
+
+      result.must_equal 10
+    end
+  end
+
+  describe "when an `otherwise' pattern is given" do
+    it "matches that pattern if no other is matched before" do
+      result = match "this is a string",
+        666 => true,
+        /the quick brown fox/ => false,
+        otherwise => "none matched"
+
+      result.must_equal "none matched"
+    end
+
+    it "matches more specific patterns before that" do
+      result = match "this is a string",
+        String => true,
+        Class => false,
+        otherwise => "none matched"
+
+      result.must_equal true
+    end
+  end
+
+  it "matches any predicate if it returns true for that object" do
+    Twice = Class.new do
+      def self.===(object)
+        object % 2 == 0
+      end
+    end
+
+    number = 21 * 2
+
+    result = match number,
+      Twice => "it's twice something"
+
+    result.must_equal "it's twice something"
+  end
+
+  describe "when passed an 'extractor'" do
+    it "it calls the action with the extracted value" do
+      Multiple = Class.new do
+        def self.of(number)
+          new(number)
+        end
+
+        def initialize(number)
+          @number = number
+        end
+
+        def ===(object)
+          object % @number == 0 ? object/@number : false
+        end
+      end
+
+      number = 99
+
+      result = match number,
+        Multiple.of(3) => ->(value) { value }
+
+      result.must_equal 33
+    end
+  end
+
+  describe "when used as control flow" do
+    it "returns from outer context when using `proc'" do
+      def foobar
+        match 1,
+          Integer => proc { return 666 }
+
+        10
+      end
+
+      foobar.must_equal 666
+    end
+  end
+end
+

metadata

@@ -0,0 +1,59 @@
+--- !ruby/object:Gem::Specification
+name: matchrb
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Diogo Lisboa
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-04-26 00:00:00.000000000 Z
+dependencies: []
+description: |2
+      matchrb (pronounced 'matcherby') provides a simple but powerful way to do
+      pattern matching in Ruby.
+email:
+- diogoslisboa@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/matchrb.rb
+- lib/matchrb/global.rb
+- lib/matchrb/version.rb
+- matchrb.gemspec
+- spec/match_spec.rb
+homepage: https://github.com/dlisboa/matchrb
+licenses:
+- BSD
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: A tiny play on pattern matching in Ruby.
+test_files:
+- matchrb.gemspec
+- spec/match_spec.rb
+has_rdoc: