composable_decorator 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: bd64fc6e7e0eb6eb8ade1ec99a2bad446c873674
-  data.tar.gz: b6def650c067d09960452e9c85d03bf2776905c9
+  metadata.gz: ab7452f0819960368e842bb6ebcfeaa1419a058d
+  data.tar.gz: 7bca3b3cdb974c0f5498b82300bd5d519e2d661c
 SHA512:
-  metadata.gz: 6fef48689f211503b63b9ae06d81d18ee2a42068c3f850f00033792a5bb98c4fc5da3b586a0b633f68e35552a5173000eb720339d9d65c9a4de54985d4dc7fa5
-  data.tar.gz: ca5b1ddd0df506f203068d2b221a9cfad409153c19e021bae32f962b9960d5dd484b4af7fb212753c6a82a78e10c110c699efa9c8514d479e9bc924446d5e776
+  metadata.gz: 9e8a40c6d12b76bc7cd62de3618c9e3e4b9ab182b184688acb8e1eef32f45bb5ac55d52ea5e3dc83e164ee9f885b3ab53f142e55b08da303018dcd1fb92f4092
+  data.tar.gz: 1cb8a7c80b335881b971ca5c89e0cf5cdab3756daf25779ab37dc6488b700c7fb0c9e2127382b3dfae602e1432a492de9c7b7916b770659585adeb646d469714

data/README.md

@@ -57,7 +57,6 @@ end
 class User < ActiveRecord::Base
   extend Name
   extend PhoneNumber
-  # more functionality runs here to work with AR relationships
 end
 
 # we can then decorate the model in the controller

data/lib/composable_decorator.rb

@@ -1,17 +1,14 @@
 require_relative "./composable_decorator/version"
-require_relative './composable_decorator/class_methods'
-require_relative './composable_decorator/instance_methods'
+require_relative './composable_decorator/dsl'
+require_relative './composable_decorator/models'
 
 module ComposableDecorator
-  def self.included(mod)
-    mod.extend ClassMethods
-    mod.include InstanceMethods
-  end
 end
 
 module ActiveRecord
   class Base
-    include ComposableDecorator
+    extend ComposableDecorator::DSL
+    include ComposableDecorator::Models
   end
 end
 

data/lib/composable_decorator/dsl.rb

@@ -0,0 +1,54 @@
+module ComposableDecorator
+  module DSL
+    # # declares the order of decorators applied to an instance
+    # # that calls the #decorate method
+    #
+    # class AdminUser
+    #   decorate_with UserDecorator, AdminDecorator
+    #
+    # # The above code results in #decorate first decorating the instance
+    # # with the UserDecorator, then the AdminDecorator
+    #
+    # @Param +decorators+ is an <Array> of classes
+    def decorate_with(*decorators)
+      define_method(:decorators) { decorators }
+    end
+
+    # # delegates all of the decorated methods for each association.
+    #
+    # module PostDecorator
+    #   def full_name
+    #     "#{name} {created_at}"
+    #
+    # class Post
+    #   decorate_with PostDecorator
+    #
+    # class Author
+    #   has_many :posts
+    #   delegate_decorated_to :posts
+    #
+    # # The above code allows you to call:
+    #
+    # author.decorate
+    # author.post_full_name
+    #
+    # # Like Rails's #delegate method, you can choose to allow_nil
+    # # or to prefix the delegated method. Both default to true.
+    #
+    # @Param +associations+ is an <Array> of symbols
+    def delegate_decorated_to(*associations, prefix: true, allow_nil: true, handle_nil_with: '')
+      define_delegate_decorated_methods(
+        associations: associations,
+        prefix: prefix,
+        allow_nil: allow_nil,
+        handle_nil_with: handle_nil_with)
+    end
+
+    def define_delegate_decorated_methods(associations: [], prefix: true, allow_nil: true, handle_nil_with: '')
+      define_method(:delegate_decorated_associations) { associations }
+      define_method(:delegate_decorated_prefix) { prefix }
+      define_method(:delegate_decorated_allow_nil) { allow_nil }
+      define_method(:delegate_decorated_handle_nil_with) { handle_nil_with }
+    end
+  end
+end

data/lib/composable_decorator/models.rb

@@ -0,0 +1,53 @@
+module ComposableDecorator
+  module Models
+    def self.included(base)
+      base.extend DSL
+
+      base.define_delegate_decorated_methods
+    end
+
+    def decorate
+      add_decorators
+      decorate_associations
+      delegate_decorated_association_methods
+
+      self
+    end
+
+    private def add_decorators
+      decorators.each do |decorator|
+        extend(decorator)
+      end
+    end
+
+    private def decorate_associations
+      method_delegate_decorated_associations.each do |assoc|
+        public_send(assoc).try(:decorate)
+      end
+    end
+
+    private def delegate_decorated_association_methods
+      class_delegate_decorated_associations.each do |klass|
+        methods = class_decorated_methods(klass)
+
+        self.class.delegate(
+          *methods,
+          to: klass.to_s.underscore,
+          prefix: delegate_decorated_prefix,
+          allow_nil: delegate_decorated_allow_nil)
+      end
+    end
+
+    private def class_decorated_methods(klass)
+      klass.new.decorators.map(&:instance_methods).flatten
+    end
+
+    private def class_delegate_decorated_associations
+      delegate_decorated_associations.map { |a| a.to_s.camelize.constantize }
+    end
+
+    private def method_delegate_decorated_associations
+      delegate_decorated_associations
+    end
+  end
+end

data/lib/composable_decorator/version.rb

@@ -1,3 +1,3 @@
 module ComposableDecorator
-  VERSION = "0.1.0"
+  VERSION = "0.1.1"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: composable_decorator
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Adam Steel
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2015-11-28 00:00:00.000000000 Z
+date: 2015-11-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -71,6 +71,8 @@ files:
 - bin/setup
 - composable_decorator.gemspec
 - lib/composable_decorator.rb
+- lib/composable_decorator/dsl.rb
+- lib/composable_decorator/models.rb
 - lib/composable_decorator/version.rb
 homepage: https://www.github.com/adsteel/composable_decorator
 licenses:
@@ -92,7 +94,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.5.0
+rubygems_version: 2.4.8
 signing_key: 
 specification_version: 4
 summary: A simple, composable decorator pattern for Ruby.