active_method 1.2.1 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cfbff213fde68c49d9a524d227aa9dc651160bbe5b72973b62991d718e092d08
-  data.tar.gz: 2b40034fb74458e547196d8c990ca6cf814950c2be638aefdd9829df4c10fcc2
+  metadata.gz: b181be6c86bef5b467ce95e50c45fc7518c21e459fda43745410ec16e38263fe
+  data.tar.gz: 29b824f426b078e8237808012871aa355d316c291850daddc1e736576fb29850
 SHA512:
-  metadata.gz: ee417c29294f6ef9ce18f397eddc770c420ca370d460fa4e831708f3f8e673493971eae1fc6522776c7a440d3721eb1308584dbc1310cb8b259c096040822012
-  data.tar.gz: 50a1753a7745ab0248fcbc54164a3a93b9b8bfccb446fe2bc1b12b69bb2f4b61e5dd92d781e5ea64e1eb32ad7e595486d64a03481307afab67c92c2a4553c26f
+  metadata.gz: 02ba2481e2d0ae0cfa55f31c74720b52f19ee28b753f343ebdfada18c1ee0abfb809bb43cfd50636fedd9c3815a35510eebf38c1d0a50f9c6f1a0fa7035ebc73
+  data.tar.gz: f3ce2172f62eb8a43be03a84602691a8d75240c001ab22c9805332f8ddc24b4e70c68c5c0c5541a22d596eb6f4d2436b83188aa0c65229c55e45384f8d48b582

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 ## [Unreleased]
 
+## [1.3.0] - 2022-12-23
+
+- Support &block
+
 ## [1.2.1] - 2022-11-21
 
 - Build on main branch

data/README.md

@@ -1,132 +1,78 @@
 # ActiveMethod
 
-Refactor your obscure method to a method object with `ActiveMethod`
+Method is an object in Ruby, but we need **a real method object**. Welcome to `ActiveMethod`!
 
-## Installation
+- **Clean scope** without module
+- **High maintainability** with tiny method objects
+- Make wrting OO **easy**, then writing OO **everywhere**
 
-Install the gem and add to the application's Gemfile by executing:
+![](./hero.png)
 
-    $ bundle add active_method
+## Installation
 
-If bundler is not being used to manage dependencies, install the gem by executing:
+```bash
+$ bundle add active_method
+```
 
-    $ gem install active_method
+## API
 
-## Usage
+**It just do what a method do, and nothing else!**
 
-Refactor `Foo#bar` to `Bar` with `ActiveMethod`
+### Define method object
 
 ```ruby
-class Foo
-  def bar(a, b, c: , d:)
-    puts "a: #{a}"
-    puts "b: #{b}"
-    puts "c: #{c}"
-    puts "d: #{d}"
-
-    buzz
-  end
+class User
+  include ActiveMethod
 
-  def buzs
-    puts 'buzz'
-  end
+  active_method :foo
+  active_method :bar, MyBar
+  active_method :build_one, class_method: true
+end
+
+module Util
+  active_method :parse_url, module_function: true
 end
 ```
 
-Refactor to:
+### Declaring arguments
 
 ```ruby
-class Bar < ActiveMethod::Base
+class Foo < ActiveMethod::Base
   argument :a
   argument :b, default: 2
   keyword_argument :c
   keyword_argument :d, default: 4
 
   def call
-    puts "a: #{a}"
-    puts "b: #{b}"
-    puts "c: #{c}"
-    puts "d: #{d}"
-
-    foo.buzz
+    puts "a: #{a}, b: #{b}, c: #{c}, d: #{d}"
   end
 end
 
-class Foo
-  include ActiveMethod
-
-  active_method :bar
-end
-
-Bar.call(1)
-# =>  a: 1
-# =>  b: 2
-# =>  c: nil
-# =>  d: 4
-# =>  buzz
-
-Bar.call(1, 3)
-# =>  a: 1
-# =>  b: 3
-# =>  c: nil
-# =>  d: 4
-# =>  buzz
-
-Bar.call(1, 3, c: 6)
-# =>  a: 1
-# =>  b: 3
-# =>  c: 6
-# =>  d: 4
-# =>  buzz
-
-Bar.call(1, 3, c: 4, d: 5)
-# =>  a: 1
-# =>  b: 3
-# =>  c: 4
-# =>  d: 5
-# =>  buzz
+User.new.foo('aa', 3, c: 'cc', d: 5)
+#=> a: aa, b: 3, c: cc, d: 5
 ```
 
-### Work on module
+### Get the owner of the method
 
 ```ruby
-class Hi < ActiveMethod::Base
-  argument :name
-
-  def call
-    "Hi, #{name}"
-  end
-end
-
-module Say
+class User
   include ActiveMethod
-
-  active_method :hi, module_function: true
+  attr_accessor :name
+  attr_accessor :fromal_name
+  active_method :hi
 end
 
-Say.hi('John')
-# => "Hi, John"
-```
-
-### Work as a class method
-
-```ruby
-class BuildARobot < ActiveMethod::Base
-  argument :name
-
+class Hi < ActiveMethod::Base
   def call
-    "#{robot_factory} build a robot called #{name}"
+    puts "Hi, I'm a #{@__method_owner.fromal_name}. Please call me #{user.name}"
   end
 end
 
-class RobotFactory
-  include ActiveMethod
-
-  active_method :build_a_robot, class_method: true
-end
-
-RobotFactory.build_a_robot
-# => "RobotFactory build a robot called B-2"
+user = User.new
+user.name = 'ActiveMethod'
+user.fromal_name = 'method object'
+user.hi
+#=> Hi, I'm a method objectc, please call me ActiveMethod
 ```
 
 ## Development

data/lib/active_method/base.rb

@@ -17,8 +17,8 @@ module ActiveMethod
       end
       alias_method :on, :[]
 
-      def call(*args)
-        new(*args).call
+      def call(*args, &block)
+        new(*args).call(&block)
       end
 
       def arguments

data/lib/active_method/executor.rb

@@ -8,10 +8,10 @@ module ActiveMethod
       @owner = owner
     end
 
-    def call(*args)
+    def call(*args, &block)
       method = method_class.new(*args)
       method.__set_owner(owner)
-      method.call
+      method.call(&block)
     end
 
   end

data/lib/active_method/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ActiveMethod
-  VERSION = "1.2.1"
+  VERSION = "1.3.0"
 end

data/lib/active_method.rb

@@ -16,13 +16,13 @@ module ActiveMethod
       method_class ||= Util.constantize self, Util.camel_case(name)
 
       if options[:class_method]
-        define_singleton_method name do |*args|
-          method_class[self].call(*args)
+        define_singleton_method name do |*args, &block|
+          method_class[self].call(*args, &block)
         end
 
       else
-        define_method name do |*args|
-          method_class[self].call(*args)
+        define_method name do |*args, &block|
+          method_class[self].call(*args, &block)
         end
 
         if options[:module_function]

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: active_method
 version: !ruby/object:Gem::Version
-  version: 1.2.1
+  version: 1.3.0
 platform: ruby
 authors:
 - Hopper Gee
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2022-11-21 00:00:00.000000000 Z
+date: 2022-12-23 00:00:00.000000000 Z
 dependencies: []
 description: Refactor your obscure method to a method object
 email:
@@ -23,6 +23,7 @@ files:
 - LICENSE.txt
 - README.md
 - Rakefile
+- hero.png
 - lib/active_method.rb
 - lib/active_method/base.rb
 - lib/active_method/executor.rb