override-parens 0.0.1

data/.gitignore

@@ -0,0 +1,35 @@
+*.gem
+*.rbc
+/.config
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/test/tmp/
+/test/version_tmp/
+/tmp/
+
+## Specific to RubyMotion:
+.dat*
+.repl_history
+build/
+
+## Documentation cache and generated files:
+/.yardoc/
+/_yardoc/
+/doc/
+/rdoc/
+
+## Environment normalisation:
+/.bundle/
+/vendor/bundle
+/lib/bundler/man/
+
+# for a library or gem, you might want to ignore these files since the code is
+# intended to run in multiple environments; otherwise, check them in:
+# Gemfile.lock
+# .ruby-version
+# .ruby-gemset
+
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc

data/LICENSE

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 Ben Christel
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

data/README.md

@@ -0,0 +1,57 @@
+# override-parens
+
+A few gems and Ruby libraries - notably the `JSON` library that comes with Ruby - give you shorthands like the following:
+
+```ruby
+JSON('{}') == JSON.parse('{}')
+```
+
+Ruby doesn't actually let you override the method call operator - what's really going on is that the JSON library defines a method `JSON` on Kernel, and Ruby tolerates methods that have the same name as a class or module.
+
+This gem lets you hide that piece of trickery and pretend that it's possible to override parentheses in Ruby.
+
+```ruby
+require 'override-parens'
+
+class MyClass
+  include OverrideParens
+
+  def self.parens(foo)
+    new(foo)
+  end
+
+  def initialize(foo)
+    @foo = foo
+  end
+end
+
+MyClass(1)
+```
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'override-parens'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install override-parens
+
+## Dependencies
+
+`override-parens` only works on **Ruby 1.9.3** and above.
+
+## Contributing
+
+1. Fork it ( https://github.com/benchristel/override-parens/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/lib/override_parens.rb

@@ -0,0 +1,30 @@
+module OverrideParens
+  def self.included(base)
+    namespace = base.name.split('::')[0...-1]
+    unqualified_name = base.name.split('::')[-1]
+    immediate_namespace = namespace.inject(Kernel) { |mod, const_name| mod.const_get const_name }
+
+    immediate_namespace.class_eval do
+      define_method(unqualified_name) do |*args, &block|
+        base.parens(*args, &block)
+      end
+
+      define_singleton_method(unqualified_name) do |*args, &block|
+        base.parens(*args, &block)
+      end
+
+      private unqualified_name
+    end
+
+    def base.parens(*args)
+      raise NotImplementedError.new "To use OverrideParens, you must implement #{self.name}.parens, e.g.:" +
+        %Q{
+class #{self.name}
+  def self.parens(*args)
+    # ...
+  end
+end
+}
+    end
+  end
+end

data/override-parens.gemspec

@@ -0,0 +1,18 @@
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+Gem::Specification.new do |s|
+  version = "0.0.1"
+
+  s.name          = "override-parens"
+  s.version       = version
+  s.platform      = Gem::Platform::RUBY
+  s.license       = "MIT"
+  s.authors       = ["Ben Christel"]
+  s.homepage      = "http://github.com/benchristel/override-parens"
+  s.summary       = "override-parens-#{version}"
+  s.description   = "Add the method call operator (parentheses) to classes and modules, e.g. MyClass(foo)"
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = s.files.grep(/^test/)
+  s.require_paths = ["lib"]
+end

data/test.rb

@@ -0,0 +1,125 @@
+gem 'minitest'
+require 'minitest/autorun'
+require_relative 'lib/override_parens'
+
+class OuterClass
+  include OverrideParens
+
+  def self.parens(arg)
+    "outer #{arg}"
+  end
+
+  class MiddleClass
+    include OverrideParens
+
+    def self.parens(arg)
+      "middle class #{arg}"
+    end
+
+    class InnerClass
+      include OverrideParens
+
+      def self.parens(arg)
+        "inner class #{arg}"
+      end
+    end
+  end
+
+  module NotImplemented
+    include OverrideParens
+  end
+end
+
+module OuterModule
+  include OverrideParens
+
+  def self.parens(arg)
+    "outer module #{arg}"
+  end
+
+  module InnerModule
+    include OverrideParens
+
+    def self.parens(arg)
+      "inner module #{arg}"
+    end
+  end
+
+  module ClassInModule
+    include OverrideParens
+
+    def self.parens(arg)
+      "class in module #{arg}"
+    end
+  end
+end
+
+class Shadowed
+  include OverrideParens
+
+  def self.parens(arg)
+    "hidden by inner class"
+  end
+end
+
+class TestParens < MiniTest::Test
+  def test_overriding_parens_on_a_class
+    assert_equal 'outer 1', OuterClass(1)
+  end
+
+  def test_overriding_parens_on_a_module
+    assert_equal 'outer module 1', OuterModule(1)
+  end
+
+  def test_overriding_parens_on_an_inner_class
+    assert_equal 'middle class 1', OuterClass::MiddleClass(1)
+  end
+
+  def test_overriding_parens_on_a_deeply_nested_class
+    assert_equal 'inner class 1', OuterClass::MiddleClass::InnerClass(1)
+  end
+
+  def test_overriding_parens_on_a_nested_module
+    assert_equal 'inner module 1', OuterModule::InnerModule(1)
+  end
+
+  def test_overriding_parens_on_a_class_in_a_module
+    assert_equal 'class in module 1', OuterModule::ClassInModule(1)
+  end
+
+  class Shadowed
+    include OverrideParens
+
+    def self.parens(arg)
+      "shadowed #{arg}"
+    end
+  end
+
+  def test_namespace_local_classes_shadow_top_level_classes
+    assert_equal 'shadowed 1', Shadowed(1)
+  end
+
+  def test_shadowed_classes_are_still_accessible_from_kernel
+    assert_equal "hidden by inner class", Kernel::Shadowed(1)
+  end
+
+  def test_no_funny_business
+    result = begin
+      OuterClass.new.MiddleClass(1)
+    rescue NoMethodError
+      "raised"
+    end
+
+    assert_equal "raised", result
+  end
+
+  def test_exception_when_parens_is_not_implemented
+    result = begin
+      OuterClass::NotImplemented(1)
+    rescue NotImplementedError => e
+      e.message
+    end
+
+    assert result.include? 'OuterClass::NotImplemented'
+  end
+end

metadata

@@ -0,0 +1,53 @@
+--- !ruby/object:Gem::Specification
+name: override-parens
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Ben Christel
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-04-19 00:00:00.000000000 Z
+dependencies: []
+description: Add the method call operator (parentheses) to classes and modules, e.g.
+  MyClass(foo)
+email: 
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- LICENSE
+- README.md
+- lib/override_parens.rb
+- override-parens.gemspec
+- test.rb
+homepage: http://github.com/benchristel/override-parens
+licenses:
+- MIT
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: override-parens-0.0.1
+test_files:
+- test.rb