active_method 1.2.0 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0b23c787014f849b2af42c1c7df267235e94e4b15e85de7bfe8aca97a86f6c38
-  data.tar.gz: '02742652085c1b7dde6e0b02c416c1bd7a6be9713fe33f348e45bdb56ba01e06'
+  metadata.gz: b181be6c86bef5b467ce95e50c45fc7518c21e459fda43745410ec16e38263fe
+  data.tar.gz: 29b824f426b078e8237808012871aa355d316c291850daddc1e736576fb29850
 SHA512:
-  metadata.gz: b99542a6f439c9758bcedcc024de0f079ddd95d43e0b71c5fd2aa88d9a02bdbbe4719cbed7bc2b6c096dda49686878c9cd3dfa41132dd1e51a7f367d2f5f9d9a
-  data.tar.gz: 45fd84df3b3c2a5d51dcfaf73b498a335ee9cc416788b881e526b01afdfad34d90da170167b440b2ffe7c9576b0167e2c6fea717940961f77cdb45eab82381da
+  metadata.gz: 02ba2481e2d0ae0cfa55f31c74720b52f19ee28b753f343ebdfada18c1ee0abfb809bb43cfd50636fedd9c3815a35510eebf38c1d0a50f9c6f1a0fa7035ebc73
+  data.tar.gz: f3ce2172f62eb8a43be03a84602691a8d75240c001ab22c9805332f8ddc24b4e70c68c5c0c5541a22d596eb6f4d2436b83188aa0c65229c55e45384f8d48b582

data/CHANGELOG.md

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

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.0"
+  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.0
+  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