sinclair 1.16.0 → 1.16.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 54cfb901ecd8185d00862d7c0b5a99e9cb626d2bbadf45db59553ae980ef9dc1
-  data.tar.gz: 7f0f0a291a659fbc5eaa0d6b56a8bc0f2dfe08b3c0a0d290dad2a6136c7ccc53
+  metadata.gz: '0633819d57447ccb757e81a154d58e8b5c47ed5fb49a6b738b6e3b27801ceeb0'
+  data.tar.gz: 0b50ae42aa0c487d3ae12d5e2b0c0933b4cff0040d7635340d82a5122a038c47
 SHA512:
-  metadata.gz: d788efed427695e2b001e7b38cc7fa4ef41fb8f6e6b855d321e88f24cb7c97b71b7f4d2622041a5f36ed9921b88513bb26beb4d3b0f11c37a19425a2d1698d9b
-  data.tar.gz: 66f7170ee3a639fa43219f10f3c984369d72ac3e58f182ac00bf0fecf947efa0e5f25107cffa45db30048366085c7c329cd214b5ed5659d854af93f0588b264b
+  metadata.gz: a72bfc2c48a33ef60fa56a4a7dd8009a12737752ffa3075ef58a50f43968779155f95b095afc7b01d2f9172b2f6d88a2cdf1f2b1e010036686cdb4be7ae376fb
+  data.tar.gz: 3e0e0a9a8bc66d1d13c427895bd9473d1a984b30bd66a8fbc961d2f80d9f54910381a2ec6d3f1ab256590a9c6aaf559b71bba921f8c1bd2466501c02e835ced0

data/README.md

@@ -15,13 +15,13 @@ create custom comparators, configure your application, create powerfull options,
 
 Employing Sinclair in your applications helps you streamline your development workflow and enhance your development process through more efficient, cleaner code
 
-Current Release: [1.16.0](https://github.com/darthjee/sinclair/tree/1.16.0)
+Current Release: [1.16.1](https://github.com/darthjee/sinclair/tree/1.16.1)
 
-[Next release](https://github.com/darthjee/sinclair/compare/1.16.0...master)
+[Next release](https://github.com/darthjee/sinclair/compare/1.16.1...master)
 
 Yard Documentation
 -------------------
-[https://www.rubydoc.info/gems/sinclair/1.16.0](https://www.rubydoc.info/gems/sinclair/1.16.0)
+[https://www.rubydoc.info/gems/sinclair/1.16.1](https://www.rubydoc.info/gems/sinclair/1.16.1)
 
 Installation
 ---------------

data/config/yardstick.yml

@@ -57,6 +57,7 @@ rules:
       - Sinclair::EnvSettable::Builder#initialize
       - Sinclair::Exception::InvalidOptions#initialize
       - Sinclair::EqualsChecker#initialize
+      - Sinclair::EqualsChecker::Reader#initialize
       - Sinclair::InputHash#initialize
       - Sinclair::Matchers::AddInstanceMethodTo#initialize
       - Sinclair::Matchers::AddClassMethodTo#initialize

data/lib/sinclair/equals_checker/reader.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+class Sinclair
+  class EqualsChecker
+    # @api private
+    # @author darthjee
+    #
+    # Class capable of reading an attribute from models
+    class Reader
+      # @private
+      # @api private
+      #
+      # Checks if two attributes from 2 object match
+      #
+      # @param attribute [Symbol] attribute name
+      # @param model [Object] object to be compared with other
+      # @param other [Object] object to be compared with model
+      #
+      # @see #match?
+      # @return [TrueClass,FalseClass]
+      def self.attributes_match?(attribute, model, other)
+        reader = new(attribute)
+
+        reader.read_from(model) == reader.read_from(other)
+      end
+
+      # @param attribute [Symbol] name of the attribute (method or variable)
+      #   to be accessed in the models
+      def initialize(attribute)
+        @attribute = attribute
+      end
+
+      # Reads the +attribute+ from the model
+      #
+      # When attribute is a method name, calls that method on the model
+      #
+      # When attribute is an instance variable name, that is read directly from the model
+      #
+      # @param model [Object] the model to be read
+      #
+      # @return [Object]
+      def read_from(model)
+        return model.send(attribute) unless attribute.to_s.match?(/^@.*/)
+
+        model.instance_variable_get(attribute)
+      end
+
+      private
+
+      # @attr_reader :attribute
+      #
+      # Reads the attribute that will be used to extract the value
+      #
+      # @return [Symbol]
+      attr_reader :attribute
+    end
+  end
+end

data/lib/sinclair/equals_checker.rb

@@ -50,6 +50,8 @@ class Sinclair
   #
   #   checker.match?(model1, model2) # returns false
   class EqualsChecker
+    autoload :Reader, 'sinclair/equals_checker/reader'
+
     # @param attributes [Array<Symbol,String>] list of relevant attributes
     def initialize(*attributes)
       @attributes = Set.new(attributes.flatten)
@@ -91,7 +93,7 @@ class Sinclair
       return false unless model.class == other.class
 
       attributes.all? do |attr|
-        model.send(attr) == other.send(attr)
+        Reader.attributes_match?(attr, model, other)
       end
     end
 

data/lib/sinclair/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 class Sinclair
-  VERSION = '1.16.0'
+  VERSION = '1.16.1'
 end

data/spec/lib/sinclair/equals_checker/reader_spec.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+describe Sinclair::EqualsChecker::Reader do
+  subject(:reader) { described_class.new(attribute) }
+
+  let(:attribute) { :information }
+  let(:model)     { SampleModel.new(name: name, age: age) }
+  let(:name)      { 'The Name' }
+  let(:age)       { 25 }
+
+  describe '.attributes_match?' do
+    let(:other)      { SampleModel.new(name: other_name) }
+    let(:attribute)  { :name }
+
+    context 'when the value match' do
+      let(:other_name) { name }
+
+      it do
+        expect(described_class)
+          .to be_attributes_match(attribute, model, other)
+      end
+    end
+
+    context 'when the value does not match' do
+      let(:other_name) { 'Other Name' }
+
+      it do
+        expect(described_class)
+          .not_to be_attributes_match(attribute, model, other)
+      end
+    end
+  end
+
+  describe '#read_from' do
+    context 'when reading from a method' do
+      it 'returns the value from the method' do
+        expect(reader.read_from(model)).to eq('The Name: 25 yo')
+      end
+    end
+
+    context 'when reading from a variable' do
+      let(:attribute) { :@inner_variable }
+
+      before do
+        model.instance_variable_set(:@inner_variable, 301)
+      end
+
+      it 'returns the value from the variable' do
+        expect(reader.read_from(model)).to eq(301)
+      end
+    end
+  end
+end

data/spec/lib/sinclair/equals_checker_spec.rb

@@ -119,6 +119,18 @@ describe Sinclair::EqualsChecker do
         end
       end
     end
+
+    context 'when one of the attributes is an instance variable' do
+      let(:attributes) { %i[name @age] }
+
+      context 'when the instance variable is different and the method the same' do
+        let(:name2) { name1 }
+
+        it do
+          expect(checker).not_to be_match(model1, model2)
+        end
+      end
+    end
   end
 
   describe '#add' do

data/spec/support/{sample_model.rb → models/sample_model.rb}

@@ -6,6 +6,10 @@ class SampleModel
     @age  = age
   end
 
+  def information
+    "#{name}: #{age} yo"
+  end
+
   protected
 
   attr_reader :name

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: sinclair
 version: !ruby/object:Gem::Version
-  version: 1.16.0
+  version: 1.16.1
 platform: ruby
 authors:
 - DarthJee
@@ -288,6 +288,7 @@ files:
 - lib/sinclair/env_settable.rb
 - lib/sinclair/env_settable/builder.rb
 - lib/sinclair/equals_checker.rb
+- lib/sinclair/equals_checker/reader.rb
 - lib/sinclair/exception.rb
 - lib/sinclair/input_hash.rb
 - lib/sinclair/matchers.rb
@@ -380,6 +381,7 @@ files:
 - spec/lib/sinclair/core_ext/object_spec.rb
 - spec/lib/sinclair/env_settable/builder_spec.rb
 - spec/lib/sinclair/env_settable_spec.rb
+- spec/lib/sinclair/equals_checker/reader_spec.rb
 - spec/lib/sinclair/equals_checker_spec.rb
 - spec/lib/sinclair/exception/invalid_options_spec.rb
 - spec/lib/sinclair/input_hash_spec.rb
@@ -455,13 +457,13 @@ files:
 - spec/support/models/purchase.rb
 - spec/support/models/random_generator.rb
 - spec/support/models/ruby_string_caster.rb
+- spec/support/models/sample_model.rb
 - spec/support/models/server.rb
 - spec/support/models/server_config.rb
 - spec/support/models/service_client.rb
 - spec/support/models/string_parser.rb
 - spec/support/models/tv.rb
 - spec/support/models/validator_builder.rb
-- spec/support/sample_model.rb
 - spec/support/shared_examples/attribute_accessor.rb
 - spec/support/shared_examples/class_method_definition.rb
 - spec/support/shared_examples/config.rb