descendants_tracker 0.0.1 → 0.0.2

data/lib/descendants_tracker.rb

@@ -1,13 +1,32 @@
+# encoding: utf-8
+
 # Module that adds descendant tracking to a class
 module DescendantsTracker
 
+  # @private
+  def self.extended(descendant)
+    setup(descendant)
+  end
+  private_class_method :extended
+
+  # @return [Array]
+  #
+  # @private
+  def self.setup(descendant)
+    descendant.instance_variable_set('@descendants', [])
+  end
+  private_class_method :extended
+
   # Return the descendants of this class
   #
+  # @example
+  #   descendants = ParentClass.descendants
+  #
   # @return [Array<Class>]
   #
-  # @api private
+  # @api public
   def descendants
-    @descendants ||= []
+    @descendants
   end
 
   # Add the descendant to this class and the superclass
@@ -18,8 +37,10 @@ module DescendantsTracker
   #
   # @api private
   def add_descendant(descendant)
-    superclass = self.superclass
-    superclass.add_descendant(descendant) if superclass.respond_to?(:add_descendant)
+    ancestor = superclass
+    if ancestor.respond_to?(:add_descendant)
+      ancestor.add_descendant(descendant)
+    end
     descendants.unshift(descendant)
     self
   end
@@ -30,11 +51,12 @@ private
   #
   # @param [Class] descendant
   #
-  # @return [undefined]
+  # @return [self]
   #
   # @api private
   def inherited(descendant)
     super
+    DescendantsTracker.setup(descendant)
     add_descendant(descendant)
   end
 

data/lib/descendants_tracker/version.rb

@@ -1,3 +1,8 @@
+# encoding: utf-8
+
 module DescendantsTracker
-  VERSION = '0.0.1'.freeze
-end
+
+  # Unreleased gem version
+  VERSION = '0.0.2'.freeze
+
+end # module DescendantsTracker

data/spec/spec_helper.rb

@@ -1,11 +1,30 @@
 # encoding: utf-8
 
+require 'devtools/spec_helper'
+
+if ENV['COVERAGE'] == 'true'
+  require 'simplecov'
+  require 'coveralls'
+
+  SimpleCov.formatter = SimpleCov::Formatter::MultiFormatter[
+    SimpleCov::Formatter::HTMLFormatter,
+    Coveralls::SimpleCov::Formatter
+  ]
+
+  SimpleCov.start do
+    command_name     'spec:unit'
+    add_filter       'config'
+    add_filter       'spec'
+    minimum_coverage 100
+  end
+end
+
 require 'descendants_tracker'
-require 'spec'
-require 'spec/autorun'
 
 # require spec support files and shared behavior
-Dir[File.expand_path('../{support,shared}/**/*.rb', __FILE__)].each { |f| require f }
+Dir[File.expand_path('../{support,shared}/**/*.rb', __FILE__)].each do |file|
+  require file
+end
 
-Spec::Runner.configure do |config|
+RSpec.configure do |config|
 end

data/spec/support/config_alias.rb

@@ -1,3 +1,5 @@
+# encoding: utf-8
+
 require 'rbconfig'
 
 ::Config = RbConfig unless defined?(::Config)

data/spec/unit/descendants_tracker/add_descendant_spec.rb

@@ -1,24 +1,26 @@
+# encoding: utf-8
+
 require 'spec_helper'
 
 describe DescendantsTracker, '#add_descendant' do
   subject { object.add_descendant(descendant) }
 
   let(:described_class) { Class.new { extend DescendantsTracker } }
-  let(:object)          { Class.new(described_class)                      }
-  let(:descendant)      { Class.new                                       }
+  let(:object)          { Class.new(described_class)              }
+  let(:descendant)      { Class.new                               }
 
-  it { should equal(object) }
+  it_should_behave_like 'a command method'
 
   it 'prepends the class to the descendants' do
     object.descendants << original = Class.new
-    expect { subject }.to change { object.descendants.dup }.
-      from([ original ]).
-      to([ descendant, original ])
+    expect { subject }.to change { object.descendants.dup }
+      .from([original])
+      .to([descendant, original])
   end
 
   it 'prepends the class to the superclass descendants' do
-    expect { subject }.to change { object.superclass.descendants.dup }.
-      from([ object ]).
-      to([ descendant, object ])
+    expect { subject }.to change { object.superclass.descendants.dup }
+      .from([object])
+      .to([descendant, object])
   end
 end

data/spec/unit/descendants_tracker/descendants_spec.rb

@@ -1,10 +1,12 @@
+# encoding: utf-8
+
 require 'spec_helper'
 
 describe DescendantsTracker, '#descendants' do
   subject { object.descendants }
 
   let(:described_class) { Class.new { extend DescendantsTracker } }
-  let(:object)          { described_class                                 }
+  let(:object)          { described_class                         }
 
   context 'when there are no descendants' do
     it_should_behave_like 'an idempotent method'
@@ -17,6 +19,6 @@ describe DescendantsTracker, '#descendants' do
 
     it_should_behave_like 'an idempotent method'
 
-    it { should eql([ descendant ]) }
+    it { should eql([descendant]) }
   end
 end

data/spec/unit/descendants_tracker/inherited_spec.rb

@@ -0,0 +1,26 @@
+# encoding: utf-8
+
+require 'spec_helper'
+
+describe DescendantsTracker, '#inherited' do
+  subject { Class.new(object) }
+
+  let!(:object)    { Class.new(superklass).extend(self.class.described_class) }
+  let(:superklass) { Class.new                                                }
+
+  it 'delegates to the superclass #inherited method' do
+    superklass.should_receive(:inherited) do |descendant|
+      descendant.should be_instance_of(Class)
+      descendant.ancestors.should include(object)
+    end
+    subject
+  end
+
+  it 'adds the descendant' do
+    expect(object.descendants).to include(subject)
+  end
+
+  it 'sets up descendants in the child class' do
+    expect(subject.descendants).to eql([])
+  end
+end

metadata

@@ -1,141 +1,123 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: descendants_tracker
-version: !ruby/object:Gem::Version 
-  hash: 29
-  prerelease: 
-  segments: 
-  - 0
-  - 0
-  - 1
-  version: 0.0.1
+version: !ruby/object:Gem::Version
+  version: 0.0.2
 platform: ruby
-authors: 
+authors:
 - Dan Kubb
 - Piotr Solnica
 - Markus Schirp
 autorequire: 
 bindir: bin
 cert_chain: []
-
-date: 2012-11-24 00:00:00 Z
-dependencies: 
-- !ruby/object:Gem::Dependency 
+date: 2013-10-05 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
   name: rake
-  prerelease: false
-  requirement: &id001 !ruby/object:Gem::Requirement 
-    none: false
-    requirements: 
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
     - - ~>
-      - !ruby/object:Gem::Version 
-        hash: 75
-        segments: 
-        - 10
-        - 0
-        - 2
-        version: 10.0.2
+      - !ruby/object:Gem::Version
+        version: 10.1.0
   type: :development
-  version_requirements: *id001
-- !ruby/object:Gem::Dependency 
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 10.1.0
+- !ruby/object:Gem::Dependency
   name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.13.0
+  type: :development
   prerelease: false
-  requirement: &id002 !ruby/object:Gem::Requirement 
-    none: false
-    requirements: 
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
     - - ~>
-      - !ruby/object:Gem::Version 
-        hash: 31
-        segments: 
-        - 1
-        - 3
-        - 2
-        version: 1.3.2
+      - !ruby/object:Gem::Version
+        version: 2.13.0
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.8.6.1
   type: :development
-  version_requirements: *id002
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.8.6.1
 description: Module that adds descendant tracking to a class
-email: 
+email:
 - dan.kubb@gmail.com
 - piotr.solnica@gmail.com
-- mbj@seonic.net
+- mbj@schirp-dso.com
 executables: []
-
 extensions: []
-
-extra_rdoc_files: 
+extra_rdoc_files:
 - LICENSE
 - README.md
 - TODO
-files: 
+files:
 - .gitignore
 - .rvmrc
 - .travis.yml
 - Gemfile
+- Gemfile.devtools
 - Guardfile
 - LICENSE
 - README.md
 - Rakefile
 - TODO
+- config/devtools.yml
 - config/flay.yml
 - config/flog.yml
-- config/roodi.yml
-- config/site.reek
+- config/mutant.yml
+- config/reek.yml
+- config/rubocop.yml
 - config/yardstick.yml
 - descendants_tracker.gemspec
 - lib/descendants_tracker.rb
 - lib/descendants_tracker/version.rb
 - spec/rcov.opts
-- spec/shared/command_method_behavior.rb
-- spec/shared/each_method_behaviour.rb
-- spec/shared/hash_method_behavior.rb
-- spec/shared/idempotent_method_behavior.rb
-- spec/shared/invertible_method_behaviour.rb
 - spec/spec.opts
 - spec/spec_helper.rb
 - spec/support/config_alias.rb
 - spec/unit/descendants_tracker/add_descendant_spec.rb
 - spec/unit/descendants_tracker/descendants_spec.rb
-- tasks/metrics/ci.rake
-- tasks/metrics/flay.rake
-- tasks/metrics/flog.rake
-- tasks/metrics/heckle.rake
-- tasks/metrics/metric_fu.rake
-- tasks/metrics/reek.rake
-- tasks/metrics/roodi.rake
-- tasks/metrics/yardstick.rake
-- tasks/spec.rake
-- tasks/yard.rake
+- spec/unit/descendants_tracker/inherited_spec.rb
 homepage: https://github.com/dkubb/descendants_tracker
 licenses: []
-
+metadata: {}
 post_install_message: 
 rdoc_options: []
-
-require_paths: 
+require_paths:
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement 
-  none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      hash: 3
-      segments: 
-      - 0
-      version: "0"
-required_rubygems_version: !ruby/object:Gem::Requirement 
-  none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      hash: 3
-      segments: 
-      - 0
-      version: "0"
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
 requirements: []
-
 rubyforge_project: 
-rubygems_version: 1.8.24
+rubygems_version: 2.0.2
 signing_key: 
-specification_version: 3
+specification_version: 4
 summary: Module that adds descendant tracking to a class
-test_files: []
-
+test_files:
+- spec/unit/descendants_tracker/add_descendant_spec.rb
+- spec/unit/descendants_tracker/descendants_spec.rb
+- spec/unit/descendants_tracker/inherited_spec.rb
 has_rdoc: 

data/config/roodi.yml

@@ -1,18 +0,0 @@
----
-AbcMetricMethodCheck:            { score: 10.3 }
-AssignmentInConditionalCheck:    { }
-CaseMissingElseCheck:            { }
-ClassLineCountCheck:             { line_count: 293 }
-ClassNameCheck:                  { pattern: !ruby/regexp '/\A(?:[A-Z]+|[A-Z][a-z](?:[A-Z]?[a-z])+)\z/' }
-ClassVariableCheck:              { }
-CyclomaticComplexityBlockCheck:  { complexity: 2 }
-CyclomaticComplexityMethodCheck: { complexity: 4 }
-EmptyRescueBodyCheck:            { }
-ForLoopCheck:                    { }
-# TODO: decrease line_count to 5 to 10
-MethodLineCountCheck:            { line_count: 14 }
-MethodNameCheck:                 { pattern: !ruby/regexp '/\A(?:[a-z\d](?:_?[a-z\d])+[?!=]?|\[\]=?|==|<=>|[+*&|-])\z/' }
-ModuleLineCountCheck:            { line_count: 295 }
-ModuleNameCheck:                 { pattern: !ruby/regexp '/\A(?:[A-Z]+|[A-Z][a-z](?:[A-Z]?[a-z])+)\z/' }
-# TODO: decrease parameter_count to 2 or less
-ParameterNumberCheck:            { parameter_count: 3 }

data/spec/shared/command_method_behavior.rb

@@ -1,7 +0,0 @@
-# encoding: utf-8
-
-shared_examples_for 'a command method' do
-  it 'returns self' do
-    should equal(object)
-  end
-end

data/spec/shared/each_method_behaviour.rb

@@ -1,15 +0,0 @@
-# encoding: utf-8
-
-shared_examples_for 'an #each method' do
-  it_should_behave_like 'a command method'
-
-  context 'with no block' do
-    subject { object.each }
-
-    it { should be_instance_of(to_enum.class) }
-
-    it 'yields the expected values' do
-      subject.to_a.should eql(object.to_a)
-    end
-  end
-end