anything 0.0.1

data/README.md

@@ -0,0 +1,74 @@
+Anything
+========
+
+Anything is a simple Ruby object with two significant facets to its behaviour:
+
+1. `Anything === a` is true for all values of `a`.
+2. `Anything == a` is also true for all values of `a`.
+
+It therefore follows that:
+
+    case a
+    when Anything
+      :always
+    else
+      :never
+    end
+
+will always evaluate to `:always`, and that:
+
+    case [a, b]
+    when ["X", Anything]
+      :x
+    when [Anything, "Y"]
+      :y
+    else
+      :z
+    end
+
+is equivalent to:
+
+    if a == "X"
+      :x
+    elsif b == "Y"
+      :y
+    else
+      :z
+    end
+
+These properties let us take nested code like:
+
+    case platform
+    when "linux"
+      case architecture
+      when /i\d86/
+        "linux_x86"
+      when "x86_64"
+        "linux_amd64"
+      else
+        raise "unsupported architecture"
+      end
+    when "darwin"
+      "mac"
+    else
+      raise "unsupported platform"
+    end
+
+and rewrite it using a pattern-matching idiom:
+
+    require "anything"
+
+    case [platform, architecture]
+    when ["linux", /i\d86/]
+      "linux_32_bit"
+    when ["linux", "x86_64"]
+      "linux_64_bit"
+    when ["linux", Anything]
+      raise "unsupported architecture"
+    when ["darwin", Anything]
+      "mac"
+    else
+      raise "unsupported platform"
+    end
+
+Whether it's actually useful or not is left to you to decide.

data/Rakefile

@@ -0,0 +1,44 @@
+require "rubygems"
+require "rake/gempackagetask"
+require "rake/testtask"
+
+task :default => [:test]
+
+Rake::TestTask.new("test") do |t|
+  t.libs   << "test"
+  t.pattern = "test/**/test_*.rb"
+  t.verbose = true
+end
+
+task :default => :test
+
+require "rake/testtask"
+Rake::TestTask.new do |t|
+  t.libs << "test"
+  t.test_files = FileList["test/**/*_test.rb"]
+  t.verbose = true
+end
+
+spec = Gem::Specification.new do |s|
+  s.name              = "anything"
+  s.version           = "0.0.1"
+  s.summary           = "An object that matches anything. May be useful for pattern matching in case statements."
+  s.author            = "Paul Battley"
+  s.email             = "pbattley@gmail.com"
+
+  s.has_rdoc          = false
+
+  s.files             = %w(Rakefile README.md) + Dir.glob("{bin,test,lib}/**/*")
+  s.executables       = FileList["bin/**"].map { |f| File.basename(f) }
+
+  s.require_paths     = ["lib"]
+end
+
+Rake::GemPackageTask.new(spec) do |pkg|
+  pkg.gem_spec = spec
+end
+
+desc 'Clear out generated packages'
+task :clean => [:clobber_package] do
+  rm "#{spec.name}.gemspec"
+end

data/lib/anything.rb

@@ -0,0 +1,9 @@
+Anything = Object.new
+
+def Anything.===(other)
+  true
+end
+
+def Anything.==(other)
+  true
+end

data/test/test_anything.rb

@@ -0,0 +1,39 @@
+$:.unshift File.join(File.dirname(__FILE__), "..", "lib")
+require "test/unit"
+require "anything"
+
+class AnythingTest < Test::Unit::TestCase
+
+  def test_should_match_in_case_when_alone
+    actual =
+      case "foo"
+      when Anything
+        :expected
+      else
+        :unexpected
+      end
+    assert_equal :expected, actual
+  end
+
+  def test_should_match_in_case_when_in_array
+    actual =
+      case ["foo", "bar"]
+      when ["foo", Anything]
+        :expected
+      else
+        :unexpected
+      end
+    assert_equal :expected, actual
+  end
+
+  def test_should_match_in_case_when_in_nested_array
+    actual =
+      case ["foo", ["bar", "baz"]]
+      when ["foo", ["bar", Anything]]
+        :expected
+      else
+        :unexpected
+      end
+    assert_equal :expected, actual
+  end
+end

metadata

@@ -0,0 +1,58 @@
+--- !ruby/object:Gem::Specification 
+name: anything
+version: !ruby/object:Gem::Version 
+  version: 0.0.1
+platform: ruby
+authors: 
+- Paul Battley
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-01-04 00:00:00 +00:00
+default_executable: 
+dependencies: []
+
+description: 
+email: pbattley@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- Rakefile
+- README.md
+- test/test_anything.rb
+- lib/anything.rb
+has_rdoc: true
+homepage: 
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: An object that matches anything. May be useful for pattern matching in case statements.
+test_files: []
+