method_decorator.rb 0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 559bd0649a3e4219ad6ad1782d517a0452cb0fe51a3ccb7f65fdc8578d94ef9d
+  data.tar.gz: 441faacb41756a39fffbf9f3d53e18eb86d8139730c7da45859f7e521772476d
+SHA512:
+  metadata.gz: 538be9989bfbabde4d8a852de4d63c7621b689b5c34b2e0799d3627eacd3376eed278428e5a77606507dda3f0b8b1c243a87c2e5772105f1f75b3c831b556a8c
+  data.tar.gz: baa3b765012839d5d8ee9f6ec11fc983b1066fde8ebeed5a6b0731066e9eccf5c58b5e42cd6374db001902f0b70707bd2b73a97490b09486b78094fbcb92b68e

data/.gitignore

@@ -0,0 +1,9 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+sandbox/

data/Gemfile

@@ -0,0 +1,5 @@
+source "https://rubygems.org"
+
+git_source(:github) {|repo_name| "https://github.com/#{repo_name}" }
+
+gemspec

data/Gemfile.lock

@@ -0,0 +1,22 @@
+PATH
+  remote: .
+  specs:
+    method-decorator (0.1)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    minitest (5.13.0)
+    rake (10.5.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.17)
+  method-decorator!
+  minitest (~> 5.0)
+  rake (~> 10.0)
+
+BUNDLED WITH
+   1.17.3

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2019 Isty001
+
+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,83 @@
+# MethodDecorator
+
+Method decorator implementation for Ruby, similar to Python. 
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'method-decorator'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install method-decorator
+
+## Usage and Examples
+
+Decorators can be used to wrap around method calls. Decoators can have their own arguments, including blocks. When the method is called, each decorator will be called in order, receiving the caller instance, the return value of the previous decorator, and the method's arguments and block.
+
+```ruby
+class Multiply < Decorator::Base
+  def call(this, args, ret, &block)
+    multiplier, = @decorator_args
+
+    return multiplier * ret if ret
+
+    multiplier * original(this, *args, &block)
+  end
+end
+
+class Controller
+  extend Decorator::DecoratorAware
+
+  Multiply(2)
+  Multiply(3)
+  def index
+    10
+  end
+end
+
+puts Controller.new.index # 60
+```
+
+Decorators can have names other than the class:
+
+```ruby
+class DivideDecorator < Decorator::Base
+  decorator_name :divide
+
+  def call(this, args, ret, &block)
+    #
+  end
+end
+```
+They can also receive their own block:
+
+```ruby
+class Route < Decorator::Base
+  def call(this, args, ret, &block)
+    @decorator_block.call
+  end
+end
+
+class Controller
+  extend Decorator::DecoratorAware
+
+  Route(:get, '/') { p "hello" }
+  def index
+    10
+  end
+end
+
+Controller.new.index  # Hello
+```
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,10 @@
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test"
+  t.libs << "lib"
+  t.test_files = FileList["test/**/*_test.rb"]
+end
+
+task :default => :test

data/lib/method_decorator.rb

@@ -0,0 +1,73 @@
+module Decorator
+  VERSION = '0.1'
+
+  module DecoratorAware
+    attr_accessor :method_decorator_map
+
+    class << self
+      attr_accessor :decorators, :registry
+    end
+
+    def method_missing(name, *args, &block)
+      klass = Decorator::DecoratorAware.registry&.key(name)
+
+      return super unless klass
+
+      @decorators ||= []
+      @decorators << [klass, args, block]
+    end
+
+    def method_added(name)
+      return if @decorators.empty?
+
+      decorators = @decorators.clone
+      @decorators = []
+
+      @method_decorator_map ||= {}
+      @method_decorator_map[name] = []
+
+      decorators.each do |klass, args, block|
+        @method_decorator_map[name] << klass.new(instance_method(name), *args, &block)
+      end
+
+      class_eval "
+      def #{name}(*args, &block)
+        ret = nil
+        self.class.method_decorator_map[:#{name}].each do |decorator|
+          ret = decorator.call(self, args, ret, &block)
+        end
+        ret
+      end"
+
+      @decorators = []
+    end
+  end
+
+  class Base
+    class << self
+      def decorator_name(name)
+        Decorator::DecoratorAware.registry ||= {}
+        Decorator::DecoratorAware.registry[self] = name.to_sym
+      end
+
+      def inherited(klass)
+        Decorator::DecoratorAware.registry ||= {}
+        Decorator::DecoratorAware.registry[klass] = klass.name.to_sym
+      end
+    end
+
+    def initialize(method, *args, &block)
+      @method = method
+      @decorator_args = args
+      @decorator_block = block
+    end
+
+    def original(this, *args, &block)
+      @method.bind(this).call(*args, &block)
+    end
+
+    def call(this, *args, &block)
+      raise NotImplementedError.new(self.class.name + '.' + __method__.to_s + ' method must be implemented')
+    end
+  end
+end

data/method_decorator.gemspec

@@ -0,0 +1,28 @@
+lib = File.expand_path("../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+require_relative "lib/method_decorator"
+
+Gem::Specification.new do |spec|
+  spec.name          = "method_decorator.rb"
+  spec.version       = Decorator::VERSION
+  spec.authors       = ["Isty001"]
+  spec.email         = ["isty001@gmail.com"]
+
+  spec.summary       = %q{Chainable method decorator implementation}
+  spec.description   = %q{Flexible method decorator implementation for Ruby, to wrap around method calls}
+  spec.homepage      = "https://github.com/Isty001/method_decorator.rb"
+  spec.license       = "MIT"
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files         = Dir.chdir(File.expand_path('..', __FILE__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  end
+
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.17"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "minitest", "~> 5.0"
+end

metadata

@@ -0,0 +1,94 @@
+--- !ruby/object:Gem::Specification
+name: method_decorator.rb
+version: !ruby/object:Gem::Version
+  version: '0.1'
+platform: ruby
+authors:
+- Isty001
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2019-11-07 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.17'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.17'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+description: Flexible method decorator implementation for Ruby, to wrap around method
+  calls
+email:
+- isty001@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- README.md
+- Rakefile
+- lib/method_decorator.rb
+- method_decorator.gemspec
+homepage: https://github.com/Isty001/method_decorator.rb
+licenses:
+- MIT
+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: []
+rubygems_version: 3.0.6
+signing_key: 
+specification_version: 4
+summary: Chainable method decorator implementation
+test_files: []