strong_concerns 0.0.2 → 0.0.3

data/README.md

@@ -8,11 +8,13 @@ But this pattern is easilly can be abused:
   when you just spliting object behavior physicaly, not logicaly, you've got messy code.
 
 The core point is tracking the internal interface between an object and a concern!
-Minimal & explicit interface forward you to craft more clean and reusable concerns.
+Minimal & explicit interface force you to craft more clean and reusable concerns.
 The ideal concern is ruby's Enumerable, which require only one method to be implemented in hosting class.
 
 Gem **strong_concerns** is technically helping you to create concerns in a right way.
 
+For dependency tracing you should turn on role before usage (DCI inspired)!
+
 ## Installation
 
 Add this line to your application's Gemfile:
@@ -31,11 +33,15 @@ Or install it yourself as:
 
 ``` ruby
 
-module AgeAssertions
+module Old
 
   # list methods required for concern
   def self.require_methods
-    %w[age]
+    %w[bith_date]
+  end
+
+  def age
+    ((Date.today - bith_date)/365.0).to_i
   end
 
   def young?
@@ -61,23 +67,16 @@ module Searchable
   end
 end
 
-class Person
-
-  attr :age
-  attr :name
+class Person < Struct.new(:name, :bith_date)
 
   def self.all
     [new('nicola', 33), new('ivan', 33)]
   end
 
-  def initialize( name, age)
-    @name, @age = name, age
-  end
-
   extend StrongConcerns
 
-  concern AgeAssertions,
-    exports_methods: %w[young? reproductive?],
+  concern Old,
+    exports_methods: %w[age young? reproductive?],
     old: 70,
     young: 14
 
@@ -85,12 +84,17 @@ class Person
     exports_methods: %w[find_by_name]
 end
 
-nicola = Person.new('nicola', 33)
+nicola = Person.new('nicola', Date.parse('1980-03-05'))
+
+nicola.reproductive? #=> raise RoleNotActive error
+nicola.as(Old)
+
 if nicola.reproductive?
   puts "Cool, make me a child!"
 end
 
-Person.find_by_name('nicola') #=> Person(name: 'nicola')
+Person.as(Searchable)
+.find_by_name('nicola') #=> Person(name: 'nicola')
 ```
 
 ## Contributing

data/lib/strong_concerns.rb

@@ -1,50 +1,75 @@
-require 'forwardable'
+$:.unshift(File.dirname(__FILE__)) unless $:.include?(File.dirname(__FILE__))
 require "strong_concerns/version"
 
 module StrongConcerns
-  class Intermediate
-    extend Forwardable
-    attr_accessor :options
+  class RoleNotActive < StandardError; end
 
-    def initialize(subject, options)
-      @__subject = subject
-      @options = options
+  autoload :Intermediate, 'strong_concerns/intermediate'
+  autoload :Reflection, 'strong_concerns/reflection'
+
+  module InstanceMethods
+    def as(mod)
+      role_instance(mod).activate
+      self
     end
 
-    def method_missing(meth)
-      raise NameError.new("Looks like you not list method <#{meth}> in self.require_methods of concern or misspelled it")
+    def role_instances
+      @role_instances ||= {}
     end
 
-    def inspect
-      "Intermediate<#{self.methods}>"
+    def role_instance(mod)
+      role_instances[mod] ||= self.class
+      .find_instance_role(mod)
+      .instance(self)
     end
   end
 
-  def class_concern(mod, options)
-    intermediate_class = prepare_intermediate(mod)
-    options.fetch(:exports_methods).each do |meth|
-      self.define_singleton_method meth do |*args, &block|
-	((@__strong_concerns ||= {})[mod.to_s] ||= intermediate_class.new(self, options)).send(meth,*args, &block)
-      end
-    end
+  def self.extended(base)
+    base.send(:extend, Reflection)
+    base.send(:extend, ClassMethods)
+    base.send(:include, InstanceMethods)
+    super
   end
 
   def concern(mod, options)
-    intermediate_class = prepare_intermediate(mod)
+    self.add_instance_role(mod, options)
     options.fetch(:exports_methods).each do |meth|
       self.send(:define_method, meth) do |*args, &block|
-	((@__strong_concerns ||= {})[mod.to_s] ||= intermediate_class.new(self, options)).send(meth,*args, &block)
+	inter = role_instance(mod)
+	unless inter.active?
+	  raise RoleNotActive.new("Your call method <#{meth}> of inactive role <#{mod.name}>!")
+	end
+	inter.send(meth,*args, &block)
       end
     end
   end
 
-  private
+  module ClassMethods
+    def as(mod)
+      role_instance(mod).activate
+      self
+    end
+
+    def role_instances
+      @role_instances ||= {}
+    end
+
+    def role_instance(mod)
+      role_instances[mod] ||= self.find_class_role(mod).instance(self)
+    end
+  end
 
-  def prepare_intermediate(mod)
-    Class.new(Intermediate).tap do |kls|
-      kls.send(:include, mod)
-      meths = mod.require_methods
-      kls.def_delegators :@__subject, *meths
+  def class_concern(mod, options)
+    self.add_class_role(mod, options)
+    options.fetch(:exports_methods).each do |meth|
+      self.define_singleton_method meth do |*args, &block|
+	inter = role_instance(mod)
+	unless inter.active?
+	  raise RoleNotActive.new("Your call method <#{meth}> of inactive role <#{mod.name}>!")
+	end
+	inter.inactivate
+	inter.send(meth,*args, &block)
+      end
     end
   end
 end

data/lib/strong_concerns/intermediate.rb

@@ -0,0 +1,48 @@
+require 'forwardable'
+
+# two way proxy
+module StrongConcerns
+  class Intermediate
+    extend Forwardable
+
+    def self.prepare(mod)
+      Class.new(Intermediate).tap do |kls|
+	kls.send(:include, mod)
+	meths = mod.require_methods
+	kls.def_delegators :@__subject__, *meths
+      end
+    end
+
+    attr_accessor :options
+
+    def activate
+      @active = true
+    end
+
+    def inactivate
+      @active = false
+    end
+
+    def active?
+      @active
+    end
+
+    def inactive?
+      not active?
+    end
+
+    def initialize(subject, options)
+      @__subject__ = subject
+      @options = options
+      @active = false
+    end
+
+    def method_missing(meth)
+      raise NameError.new("Looks like you not list method <#{meth}> in self.require_methods of concern or misspelled it")
+    end
+
+    def inspect
+      "Intermediate<#{self.methods}>"
+    end
+  end
+end

data/lib/strong_concerns/reflection.rb

@@ -0,0 +1,44 @@
+module StrongConcerns
+  class Role
+    attr  :mod
+
+    def initialize(mod, options)
+      @mod = mod
+      @options = options
+    end
+
+    def intermediate_class
+      @intermediate_class ||= Intermediate.prepare(@mod)
+    end
+
+    def instance(subject)
+      intermediate_class.new(subject, @options)
+    end
+  end
+
+  module Reflection
+    def add_class_role(mod, options)
+      self.class_roles[mod] = Role.new(mod, options)
+    end
+
+    def add_instance_role(mod, options)
+      self.instance_roles[mod] = Role.new(mod, options)
+    end
+
+    def find_instance_role(mod)
+      instance_roles[mod]
+    end
+
+    def find_class_role(mod)
+      class_roles[mod]
+    end
+
+    def instance_roles
+      @instance_roles ||= {}
+    end
+
+    def class_roles
+      @class_roles ||= {}
+    end
+  end
+end

data/lib/strong_concerns/version.rb

@@ -1,3 +1,3 @@
 module StrongConcerns
-  VERSION = "0.0.2"
+  VERSION = "0.0.3"
 end

data/spec/intermediate_spec.rb

@@ -0,0 +1,40 @@
+require 'spec_helper'
+describe StrongConcerns::Intermediate do
+  class A
+    def meth
+      "ups"
+    end
+  end
+
+  module B
+    def self.require_methods
+      %w[meth]
+    end
+
+    def decorated_meth
+      "#{meth}#{options[:opt1]}"
+    end
+  end
+
+  subject do
+    obj = A.new
+    kls = described_class.prepare(B)
+    kls.new(obj, opt1: '!!!')
+  end
+
+  it "should turn of/on" do
+    subject.should_not be_active
+    subject.activate
+    subject.should be_active
+    subject.inactivate
+    subject.should be_inactive
+  end
+
+  it "should delegate methods" do
+    subject.meth.should == 'ups'
+  end
+
+  it "should call role methods" do
+    subject.decorated_meth.should == 'ups!!!'
+  end
+end

data/spec/reflection_spec.rb

@@ -0,0 +1,35 @@
+require 'spec_helper'
+describe StrongConcerns::Reflection do
+  class A
+    extend StrongConcerns::Reflection
+    def meth
+      "ups"
+    end
+  end
+
+  module B
+    def self.require_methods
+      %w[meth]
+    end
+
+    def decorated_meth
+      "#{meth}#{options[:opt1]}"
+    end
+  end
+
+  subject { A }
+
+  it "instance roles" do
+    subject.instance_roles.should be_empty
+    subject.add_instance_role(B, opt1: 'val1')
+    role = subject.find_instance_role(B)
+    role.should be_a(StrongConcerns::Role)
+  end
+
+  it "class roles" do
+    subject.class_roles.should be_empty
+    subject.add_class_role(B, opt1: 'val1')
+    role = subject.find_class_role(B)
+    role.should be_a(StrongConcerns::Role)
+  end
+end

data/spec/strong_concerns_spec.rb

@@ -1,4 +1,5 @@
 require 'spec_helper'
+require 'date'
 
 describe StrongConcerns do
   module FullNamed
@@ -11,9 +12,13 @@ describe StrongConcerns do
     end
   end
 
-  module AgeAssertions
+  module Old
     def self.require_methods
-      %w[age]
+      %w[bith_date]
+    end
+
+    def age
+      ((Date.today - bith_date)/365.0).to_i
     end
 
     def young?
@@ -44,23 +49,10 @@ describe StrongConcerns do
     end
   end
 
-  class Person
-
-    attr :first_name
-    attr :last_name
-    attr :age
-
-    def initialize(first_name, last_name, age)
-      @first_name = first_name
-      @last_name = last_name
-      @age = age
-    end
+  class Person < Struct.new(:first_name, :last_name, :bith_date)
 
     def self.all
-      [
-	new('nicola','rhyzhikov', 33),
-	new('ivan','ivanov', 33)
-      ]
+      [ new('nicola','rhyzhikov', 33), new('ivan','ivanov', 33) ]
     end
 
     extend StrongConcerns
@@ -68,8 +60,8 @@ describe StrongConcerns do
     class_concern Searchable,
       exports_methods: %w[find_by_name]
 
-    concern AgeAssertions,
-      exports_methods: %w[young? reproductive? breaking],
+    concern Old,
+      exports_methods: %w[age young? reproductive? breaking],
       young: 14, old: 70
 
     concern FullNamed,
@@ -78,18 +70,39 @@ describe StrongConcerns do
   end
 
   example do
-    Person.new('nicola', 'rhyzhikov', 33).tap do |nicola|
-      nicola.full_name.should == "nicola rhyzhikov"
-      nicola.should_not be_young
-      nicola.should be_reproductive
-
-      -> {
-	nicola.breaking
-      }.should raise_error(/not list method/)
-    end
+    nicola = Person.new('nicola', 'rhyzhikov', Date.parse('1980-03-05'))
+
+    -> {
+      nicola.full_name
+    }.should raise_error(StrongConcerns::RoleNotActive)
+
+    nicola.as(FullNamed)
+
+    nicola.full_name.should == "nicola rhyzhikov"
+
+    nicola.as(Old)
+    nicola.should_not be_young
+    nicola.should be_reproductive
+
+    -> {
+      nicola.breaking
+    }.should raise_error(/not list method/)
   end
 
-  example do
-    Person.find_by_name('nicola').should_not be_empty
+  it "class_concern" do
+    -> {
+      Person
+      .find_by_name('nicola')
+      .should_not be_empty
+    }.should raise_error(StrongConcerns::RoleNotActive)
+
+    Person
+    .as(Searchable)
+    .find_by_name('nicola')
+    .should_not be_empty
+
+    -> {
+      Person.find_by_name('nicola')
+    }.should raise_error(StrongConcerns::RoleNotActive)
   end
 end

metadata

@@ -1,43 +1,48 @@
 --- !ruby/object:Gem::Specification
 name: strong_concerns
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  prerelease: 
+  version: 0.0.3
 platform: ruby
 authors:
 - niquola
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-07-16 00:00:00.000000000 Z
+date: 2013-08-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: bundler
-  requirement: !ruby/object:Gem::Requirement
+  version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
         version: '1.3'
-  type: :development
+    none: false
   prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
+  name: bundler
+  type: :development
+  requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
         version: '1.3'
+    none: false
 - !ruby/object:Gem::Dependency
-  name: rake
-  requirement: !ruby/object:Gem::Requirement
+  version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
-  type: :development
+    none: false
   prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
+  name: rake
+  type: :development
+  requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
+    none: false
 description: Gem **strong_concerns** is technically helping you to create concerns
   in a right way, minimizing and making explicit interface between object and concern.
 email:
@@ -52,35 +57,48 @@ files:
 - README.md
 - Rakefile
 - lib/strong_concerns.rb
+- lib/strong_concerns/intermediate.rb
+- lib/strong_concerns/reflection.rb
 - lib/strong_concerns/version.rb
+- spec/intermediate_spec.rb
+- spec/reflection_spec.rb
 - spec/spec_helper.rb
 - spec/strong_concerns_spec.rb
 - strong_concerns.gemspec
 homepage: https://github.com/niquola/strong_concerns
 licenses:
 - MIT
-metadata: {}
 post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - ! '>='
     - !ruby/object:Gem::Version
+      segments:
+      - 0
+      hash: -2035030651887043314
       version: '0'
+  none: false
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - ! '>='
     - !ruby/object:Gem::Version
+      segments:
+      - 0
+      hash: -2035030651887043314
       version: '0'
+  none: false
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.0.3
+rubygems_version: 1.8.25
 signing_key: 
-specification_version: 4
+specification_version: 3
 summary: Gem **strong_concerns** is technically helping you to create concerns in
   a right way, minimizing and making explicit interface between object and concern.
 test_files:
+- spec/intermediate_spec.rb
+- spec/reflection_spec.rb
 - spec/spec_helper.rb
 - spec/strong_concerns_spec.rb

checksums.yaml

@@ -1,7 +0,0 @@
----
-SHA1:
-  metadata.gz: 26c6d7992012ae2a5204e3643a55de1bfbf98b43
-  data.tar.gz: b3344d68b073077ff1849f31cb34969bee7ca56d
-SHA512:
-  metadata.gz: 0e406c4ff2eadf7c553fed7a263a6a16e0773a34acf2d55185d8afc1458f32287fc72c7e3f53cfc0ef035b0b5cbdf7e2ecf6600f949d325f7cae5187ce264c02
-  data.tar.gz: 6f172432785133c1e6cc7b3b4029aa04c58825dc73efd1e1b60951f506c58e54a1d2a3e3c11cee54a91a8d28c059eaad768d453faac544fcb621c99532de836a