spaced 0.3.0 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4be5f8b778afea6200764ac30e9588cd76ebedd1e6414c3abf7c2b57fadf9fc1
-  data.tar.gz: 01de2584949b4f50211847ba3a2fd11081f7d2e8b30769117d6016ed665596c7
+  metadata.gz: 496fc25b4cc4a7b4d8332661ace97b36a26ee5cb9592bfeb06e1743483c47c3b
+  data.tar.gz: 96b4ddf6c1c5e89ead4f894ced1f71c2b2a671c7838766572f94f85462bedf82
 SHA512:
-  metadata.gz: 29031788d5ab97c24364206b47583f63d37ed9f2186b541cd10003d7cdfd94f96711d638b485823085d400301d4e8c37302b587f40d4ee1e2cb4a674c2a3e6b6
-  data.tar.gz: f0854fa0e2813f899fc32b85e57c72b1f44845aa4574f7c419ce5e7ba5f65ad0dfd5b07e4c6de55f2514b95da1abd51627bbec0c0363e936a650a0ace847e06b
+  metadata.gz: 4751df5962de7c88361b534dff26007baeed5a91bd8a4f796aa75d6ff31f5a48c10c8b9dc8d53528af00f9089cc8bc8865b3c97b209227cb5c9dab96f84f4c33
+  data.tar.gz: eb9fd26c2e44f605bf9c9f733b22263ff86a0f5fd4d8003fe1457544b3a4b2a7f08ac13b3132a7447230c3017aab6c1c4bce5d407ee4bc56d53a6fc4dd86f8ef

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    spaced (0.2.0)
+    spaced (0.3.0)
 
 GEM
   remote: https://rubygems.org/

data/README.md

@@ -1,6 +1,8 @@
 # Spaced
 
-Spaced is a super simple and convenient way to isolate and namespace a collection of related methods.
+Spaced is a super simple and convenient way to isolate and namespace a collection of related methods into any class.
+
+## Usage
 
 ```ruby
 class User
@@ -16,14 +18,6 @@ class User
       api.read_tweet id
     end
 
-    def call(msg)
-      create msg
-    end
-
-    def predicate
-      subject.twitter_id?
-    end
-
     private
 
       def api
@@ -38,12 +32,41 @@ end
 user = User.new
 id = user.twitter.create("Spaced man!")
 user.twitter.read(id)
-user.twitter!("Spaced man!") # calls the `call` method.
-user.twitter? # calls the `predicate` method.
 ```
 
 In the example above, `namespace` creates and initializes a new class `Twitter` and returns it from the `#twitter` method. The parent class - in this case `User` - is available at `#parent` and `@parent` from within the namespace.
 
+## Magic bang and predicate methods
+
+If you define a `call` method in your namespaced class, you can then conveniently call that with a bang method:
+
+```ruby
+class User < Spaced::Base
+  include Spaced
+
+  namespace :tweet do
+    def call(content)
+      create_tweet content
+    end
+  end
+end
+
+user = User.new
+user.tweet!('my new tweet') # Will call the `#call` method with whatever arguments you give it.
+```
+
+There is also an equivalent `predicate` method:
+
+```ruby
+namespace :tweet do
+  def predicate
+    false
+  end
+end
+user = User.new
+user.tweet? # Will call the `#predicate` method.
+```
+
 ## Installation
 
 Add this line to your application's Gemfile:

data/lib/spaced/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Spaced
-  VERSION = "0.3.0"
+  VERSION = "0.3.1"
 end

data/lib/spaced.rb

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require_relative "spaced/version"
-require "forwardable"
 
 module Spaced
   def self.included(base)
@@ -20,7 +19,7 @@ module Spaced
         raise "#{klass} must be a subclass of Spaced::Base" unless klass < Spaced::Base
       else
         class_name = name.to_s.split("_").collect(&:capitalize).join
-        klass = eval <<-RUBY, binding, __FILE__, __LINE__ + 1 # rubocop:disable Security/Eval
+        klass = module_eval <<-RUBY, __FILE__, __LINE__ + 1
         #{self}::#{class_name} = Class.new(Base, &)  # Parent::Namespace = Class.new(Base, &)
         RUBY
       end
@@ -41,21 +40,22 @@ module Spaced
       # Define the bang and predicate methods.
       methods = klass.instance_methods(false)
 
-      if methods.include?(:call) || methods.include?(:predicate)
-        extend Forwardable
-        def_delegator :"#{name}", :call, :"#{name}!" if methods.include?(:call)
-        def_delegator :"#{name}", :predicate, :"#{name}?" if methods.include?(:predicate)
+      if methods.include?(:call)
+        module_eval <<-RUBY, __FILE__, __LINE__ + 1
+          def #{name}!(...); #{name}.call(...); end # def user!(...); user.call(...); end
+        RUBY
       else
-        unless methods.include?(:call)
-          define_method :"#{name}!" do
-            raise NoMethodError, "undefined method `#{name}!' for #<#{klass}>. Have you defined `#{klass}#call`?"
-          end
+        define_method :"#{name}!" do
+          raise NoMethodError, "undefined method `#{name}!' for #<#{klass}>. Have you defined `#{klass}#call`?", caller
         end
+      end
 
-        unless methods.include?(:predicate)
-          define_method :"#{name}?" do
-            raise NoMethodError, "undefined method `#{name}?' for #<#{klass}>. Have you defined `#{klass}#predicate`?"
-          end
+      if methods.include?(:predicate)
+        define_method(:"#{name}?") { send(name).predicate }
+      else
+        define_method :"#{name}?" do
+          raise NoMethodError, "undefined method `#{name}?' for #<#{klass}>. Have you defined `#{klass}#predicate`?",
+                caller
         end
       end
     end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: spaced
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.3.1
 platform: ruby
 authors:
 - Joel Moss
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2022-10-05 00:00:00.000000000 Z
+date: 2022-10-06 00:00:00.000000000 Z
 dependencies: []
 description:
 email: