eac_tools 0.119.0 → 0.121.0

data/sub/eac_ruby_utils/spec/lib/eac_ruby_utils/acts_as_immutable/hash_accessor_spec.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+RSpec.describe EacRubyUtils::ActsAsImmutable::HashAccessor do
+  let(:stub_class) do
+    Class.new do
+      include EacRubyUtils::ActsAsImmutable
+
+      immutable_accessor :the_hash, type: :hash
+    end
+  end
+
+  let(:initial_instance) { stub_class.new }
+
+  it { expect(initial_instance.the_hashes).to eq({}) }
+  it { expect(initial_instance.the_hash('key_a')).to be_nil }
+
+  context 'when a single value is set' do
+    let(:change1_instance) { initial_instance.the_hash('key_a', 'A') }
+
+    before { change1_instance }
+
+    it { expect(initial_instance.the_hashes).to eq({}) }
+    it { expect(initial_instance.the_hash('key_a')).to be_nil }
+    it { expect(change1_instance.the_hashes).to eq({ 'key_a' => 'A' }) }
+    it { expect(change1_instance.the_hash('key_a')).to eq('A') }
+
+    context 'when all valuesare set' do
+      let(:change2_instance) { initial_instance.the_hashes('key_b' => 'B') }
+
+      before { change2_instance }
+
+      it { expect(change1_instance.the_hashes).to eq({ 'key_a' => 'A' }) }
+      it { expect(change1_instance.the_hash('key_a')).to eq('A') }
+      it { expect(change1_instance.the_hash('key_b')).to be_nil }
+      it { expect(change2_instance.the_hashes).to eq({ 'key_b' => 'B' }) }
+      it { expect(change2_instance.the_hash('key_a')).to be_nil }
+      it { expect(change2_instance.the_hash('key_b')).to eq('B') }
+    end
+  end
+end

data/sub/eac_ruby_utils/spec/lib/eac_ruby_utils/acts_as_immutable/set_accessor_spec.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+RSpec.describe EacRubyUtils::ActsAsImmutable::SetAccessor do
+  let(:stub_class) do
+    Class.new do
+      include EacRubyUtils::ActsAsImmutable
+
+      immutable_accessor :array_attr, type: :set
+    end
+  end
+
+  let(:initial_instance) { stub_class.new }
+
+  it do
+    expect(initial_instance.array_attrs).to eq(Set.new)
+  end
+
+  context 'when array_attr pushs for' do
+    let(:change1_instance) { initial_instance.array_attr('A') }
+
+    it { expect(change1_instance).to be_a(initial_instance.class) }
+    it { expect(change1_instance.object_id).not_to eq(initial_instance.object_id) }
+    it { expect(change1_instance.array_attrs).to eq(Set.new(%w[A])) }
+
+    context 'when array_attrs sets for' do
+      let(:change2_instance) { initial_instance.array_attrs(%w[B]) }
+
+      it { expect(change2_instance).to be_a(initial_instance.class) }
+      it { expect(change2_instance.object_id).not_to eq(change1_instance.object_id) }
+      it { expect(change2_instance.array_attrs).to eq(Set.new(%w[B])) }
+    end
+
+    context 'when array_attrs push for a repetead value' do
+      let(:change2_instance) { initial_instance.array_attr('A') }
+
+      it { expect(change2_instance).to be_a(initial_instance.class) }
+      it { expect(change2_instance.object_id).not_to eq(change1_instance.object_id) }
+      it { expect(change2_instance.array_attrs).to eq(Set.new(%w[A])) }
+    end
+  end
+end

data/sub/eac_ruby_utils/spec/lib/eac_ruby_utils/arguments_consumer_spec.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+RSpec.describe EacRubyUtils::ArgumentsConsumer do
+  let(:instance) { described_class.new(%i[a b c d], d: 'd_value') }
+  let(:args) { ['a_value', 'b_value', { e: 'e_value' }] }
+  let(:result) { instance.parse(args) }
+
+  it { expect(result).to be_a(Hash) }
+  it { expect(result.count).to eq(5) }
+  it { expect(result.fetch(:a)).to eq('a_value') }
+  it { expect(result.fetch(:b)).to eq('b_value') }
+  it { expect(result.fetch(:c)).to be_nil }
+  it { expect(result.fetch(:d)).to eq('d_value') }
+  it { expect(result.fetch(:e)).to eq('e_value') }
+end

data/sub/eac_ruby_utils/spec/lib/eac_ruby_utils/bit_array_spec.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+RSpec.describe EacRubyUtils::BitArray do
+  describe '#to_byte_array' do
+    let(:instance) { described_class.new([0, 0, 0, 0, 1, 1, 1, 1, 0, 0, 1, 1, 1, 0, 1, 1]) }
+
+    {
+      false => [0xF0, 0xDC],
+      true => [0x0F, 0x3B]
+    }.each do |big_endian, expected_bytes|
+      context "when big-endian is #{big_endian}" do
+        let(:expected_value) { EacRubyUtils::ByteArray.new(expected_bytes) }
+
+        it do
+          expect(instance.to_byte_array(big_endian)).to eq(expected_value)
+        end
+      end
+    end
+  end
+end

data/sub/eac_ruby_utils/spec/lib/eac_ruby_utils/blank_not_blank_spec.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+RSpec.describe EacRubyUtils::BlankNotBlank do
+  let(:instance) { described_class.instance }
+
+  it do
+    expect { described_class.new }.to raise_error(NoMethodError)
+  end
+
+  it { expect(instance).to be_present }
+  it { expect(instance).not_to be_blank }
+  it { expect(instance).to be_truthy }
+  it { expect(instance).to eq('') }
+end

data/sub/eac_ruby_utils/spec/lib/eac_ruby_utils/byte_spec.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+RSpec.describe EacRubyUtils::Byte do
+  describe '#[]' do
+    let(:instance) { described_class.new(0xDC) }
+
+    [0, 0, 1, 1, 1, 0, 1, 1].each_with_index do |bit_value, bit_index|
+      context "when bit index is #{bit_index}" do
+        it { expect(instance[bit_index].value).to eq(bit_value) }
+      end
+    end
+  end
+
+  describe '#bit_set' do
+    let(:instance) { described_class.new(0b11011100) }
+
+    {
+      0 => [0b11011100, 0b11011100, 0b11011000, 0b11010100,
+            0b11001100, 0b11011100, 0b10011100, 0b01011100],
+      1 => [0b11011101, 0b11011110, 0b11011100, 0b11011100,
+            0b11011100, 0b11111100, 0b11011100, 0b11011100]
+    }.each do |bit_value, expected_values|
+      expected_values.each_with_index do |expected_value, bit_index|
+        context "when bit index is #{bit_index} and bit value is #{bit_value}" do
+          it do
+            expect(instance.bit_set(bit_index, bit_value))
+              .to eq(described_class.new(expected_value))
+          end
+        end
+      end
+    end
+  end
+
+  describe '#from_bit_array' do
+    let(:bit_array) { [0, 0, 1, 1, 1, 0, 1, 1] }
+
+    { false => 0b11011100, true => 0b00111011 }.each do |big_endian, expected_integer|
+      context "when big-endian is #{big_endian}" do
+        let(:expected_value) { described_class.new(expected_integer) }
+
+        it do
+          expect(described_class.from_bit_array(bit_array, big_endian)).to eq(expected_value)
+        end
+      end
+    end
+
+    it do
+      expect { described_class.from_bit_array([0, 0, 1, 1, 1, 0, 1]) }
+        .to raise_error(ArgumentError)
+    end
+  end
+end

data/sub/eac_ruby_utils/spec/lib/eac_ruby_utils/common_concern_spec.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+RSpec.describe EacRubyUtils::CommonConcern do
+  let(:instance) do
+    described_class.new do
+      self.valor = 'changed'
+    end
+  end
+
+  let(:stub_module) do
+    Module.new do
+      module ClassMethods # rubocop:disable Lint/ConstantDefinitionInBlock,RSpec/LeakyConstantDeclaration
+        def my_class_method
+          'class'
+        end
+      end
+
+      module InstanceMethods # rubocop:disable Lint/ConstantDefinitionInBlock,RSpec/LeakyConstantDeclaration
+        def my_instance_method
+          'from_module'
+        end
+      end
+    end
+  end
+
+  let(:stub_class) do
+    Class.new do
+      class << self
+        attr_accessor :valor
+      end
+
+      def my_instance_method
+        'from_class'
+      end
+    end
+  end
+
+  let(:stub_class_instance) { stub_class.new }
+
+  before do
+    instance.setup(stub_module)
+  end
+
+  context 'when included' do
+    before do
+      stub_class.include stub_module
+    end
+
+    it { expect(stub_class_instance.my_instance_method).to eq('from_class') }
+    it { expect(stub_class_instance.class.my_class_method).to eq('class') }
+    it { expect(stub_class_instance.class.valor).to eq('changed') }
+  end
+
+  context 'when prepended' do
+    before do
+      stub_class.prepend stub_module
+    end
+
+    it { expect(stub_class_instance.my_instance_method).to eq('from_module') }
+    it { expect(stub_class_instance.class.my_class_method).to eq('class') }
+    it { expect(stub_class_instance.class.valor).to eq('changed') }
+  end
+end

data/sub/eac_ruby_utils/spec/lib/eac_ruby_utils/common_constructor_spec.rb

@@ -0,0 +1,149 @@
+# frozen_string_literal: true
+
+RSpec.describe EacRubyUtils::CommonConstructor do
+  ARG_LIST = %i[a b c d].freeze # rubocop:disable Lint/ConstantDefinitionInBlock, RSpec/LeakyConstantDeclaration
+
+  let(:instance) do
+    described_class.new(*ARG_LIST, default: %w[Vcc Vd]) do
+      @z = 'Vz'
+    end
+  end
+
+  let(:a_class) do
+    Class.new do
+      attr_reader :z
+    end
+  end
+
+  let(:a_class_instance) { a_class.new('Va', 'Vb', 'Vc') }
+
+  before do
+    instance.setup_class(a_class)
+  end
+
+  it { expect(a_class_instance.z).to eq('Vz') }
+
+  ARG_LIST.each do |attr|
+    expected_value = "V#{attr}" # rubocop:disable RSpec/LeakyLocalVariable
+    it "attribute \"#{attr}\" equal to \"#{expected_value}\"" do
+      expect(a_class_instance.send(attr)).to eq(expected_value)
+    end
+
+    [false, true].each do |include_all|
+      it "respond_to?('#{attr}', #{include_all}) == #{include_all}" do
+        expect(a_class_instance.respond_to?("#{attr}=", include_all)).to eq(include_all)
+      end
+    end
+  end
+
+  context 'with super class' do
+    let(:super_class) do
+      Class.new do
+        attr_reader :super_a, :super_b
+
+        def initialize(a, b) # rubocop:disable Naming/MethodParameterName
+          @super_a = a
+          @super_b = b
+        end
+      end
+    end
+
+    let(:sub_class) do
+      sub_constructor.setup_class(Class.new(super_class))
+    end
+
+    let(:sub_object) { sub_class.new(1, 2, 3, 4) }
+
+    context 'with super_args parameter' do
+      let(:sub_constructor) do
+        described_class.new(:c, :a, :b, :d, super_args: -> { [c, a] })
+      end
+
+      it { expect(sub_object.a).to eq(2) }
+      it { expect(sub_object.b).to eq(3) }
+      it { expect(sub_object.c).to eq(1) }
+      it { expect(sub_object.d).to eq(4) }
+      it { expect(sub_object.super_a).to eq(1) }
+      it { expect(sub_object.super_b).to eq(2) }
+    end
+
+    context 'without super_args parameter' do
+      let(:sub_constructor) do
+        described_class.new(:c, :a, :b, :d)
+      end
+
+      it { expect(sub_object.a).to eq(2) }
+      it { expect(sub_object.b).to eq(3) }
+      it { expect(sub_object.c).to eq(1) }
+      it { expect(sub_object.d).to eq(4) }
+      it { expect(sub_object.super_a).to eq(2) }
+      it { expect(sub_object.super_b).to eq(3) }
+    end
+
+    context 'with undefined super arguments' do
+      let(:sub_constructor) do
+        described_class.new(:x, :y, :w, :a)
+      end
+
+      it do
+        expect { sub_object }.to raise_error(ArgumentError)
+      end
+    end
+  end
+
+  context 'with block argument' do
+    let(:instance) do
+      described_class.new(:first, :second, :last, block_arg: true, default: ['second'])
+    end
+
+    let(:block) do
+      proc { first + second }
+    end
+
+    let(:a_class) do
+      Class.new do
+        def result
+          last.run
+        end
+      end
+    end
+
+    let(:a_class_instance) { a_class.new('first') { 'last' } }
+
+    it { expect(a_class_instance.last).to be_a(Proc) }
+    it { expect(a_class_instance.last.call).to eq('last') }
+
+    it { expect(a_class_instance.first).to eq('first') }
+    it { expect(a_class_instance.second).to eq('second') }
+  end
+
+  context 'with class hierarchy mixed with and without common_constructor' do
+    let(:klass_0) do # rubocop:disable Naming/VariableNumber, RSpec/IndexedLet
+      described_class.new(:a_param).setup_class(Class.new)
+    end
+
+    let(:klass_1) do # rubocop:disable Naming/VariableNumber, RSpec/IndexedLet
+      Class.new(klass_0) do
+        def initialize(a_param) # rubocop:disable Lint/UselessMethodDefinition
+          super
+        end
+      end
+    end
+
+    let(:klass_2) do # rubocop:disable Naming/VariableNumber, RSpec/IndexedLet
+      Class.new(klass_1)
+    end
+
+    let(:klass_3) do # rubocop:disable Naming/VariableNumber, RSpec/IndexedLet
+      described_class.new(:a_param).setup_class(Class.new(klass_2))
+    end
+
+    4.times.each do |i|
+      context "with #{i}-th class" do
+        let(:class_instance) { send("klass_#{i}").new(:a) }
+
+        it { expect(class_instance.a_param).to eq(:a) }
+      end
+    end
+  end
+end

data/sub/eac_ruby_utils/spec/lib/eac_ruby_utils/compact_spec.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+RSpec.describe EacRubyUtils::Compact do
+  let(:sub_object) { Struct.new(:c_attr).new('c_value') }
+  let(:object) { Struct.new(:a_attr, :b_attr, :sub).new('a_value', 'b_value', sub_object) }
+  let(:instance) { described_class.new(object, %w[a_attr b_attr sub.c_attr]) }
+
+  describe '#to_a' do
+    it do
+      expect(instance.to_a).to eq(%w[a_value b_value c_value])
+    end
+  end
+
+  describe '#to_h' do
+    it do
+      expect(instance.to_h).to eq(a_attr: 'a_value', b_attr: 'b_value', 'sub.c_attr': 'c_value')
+    end
+  end
+end

data/sub/eac_ruby_utils/spec/lib/eac_ruby_utils/compare_by_spec.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+RSpec.describe EacRubyUtils::CompareBy do
+  let(:instance) { described_class.new(%i[field1 field2]) }
+  let(:klass) do
+    Class.new do
+      attr_reader :field1, :field2
+
+      def initialize(field1, field2)
+        @field1 = field1
+        @field2 = field2
+      end
+    end
+  end
+  let(:o1) { klass.new(1, 2) } # rubocop:disable RSpec/IndexedLet
+  let(:o2) { klass.new(2, 1) } # rubocop:disable RSpec/IndexedLet
+  let(:o3) { klass.new(1, 1) } # rubocop:disable RSpec/IndexedLet
+
+  before { instance.apply(klass) }
+
+  describe '#comparable' do
+    it { expect(o1).to be < o2 }
+    it { expect(o1).to be > o3 }
+    it { expect(o2).to be > o3 }
+    it { expect([o1, o2, o3].sort).to eq([o3, o1, o2]) }
+  end
+
+  describe '#equality' do
+    it { expect(o1).not_to eq(o2) }
+    it { expect(o1).not_to eq(o3) }
+    it { expect(o2).not_to eq(o3) }
+
+    it { expect(o1).to eq(klass.new(1, 2)) }
+    it { expect(o2).to eq(klass.new(2, 1)) }
+    it { expect(o3).to eq(klass.new(1, 1)) }
+  end
+end

data/sub/eac_ruby_utils/spec/lib/eac_ruby_utils/custom_format_spec.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+class StubObjectData
+  def x_value
+    'X1'
+  end
+
+  def y_value
+    'Y1'
+  end
+end
+
+RSpec.describe EacRubyUtils::CustomFormat do
+  let(:instance) { described_class.new(x: :x_value, y: :y_value, z: :unexistent) }
+  let(:ok_format) { instance.format('|%%|%y|%x|%y|') }
+  let(:ok_string_expected) { '|%|Y1|X1|Y1|' }
+  let(:fail_format) { instance.format('|%z|') }
+
+  it do
+    expect(ok_format.sequences).to include(:x, :y)
+  end
+
+  it do
+    expect(fail_format.sequences).to include(:z)
+  end
+
+  context 'when object source is a hash' do
+    let(:object_source) { { x_value: 'X1', y_value: 'Y1' } }
+
+    context 'when hash has all keys' do
+      it do
+        expect(ok_format.with(object_source)).to eq(ok_string_expected)
+      end
+    end
+
+    context 'when hash has not all keys' do
+      it do
+        expect(fail_format.with(object_source)).to eq('||')
+      end
+    end
+  end
+
+  context 'when object source is not a hash' do
+    let(:object_source) { StubObjectData.new }
+
+    context 'when object has all methods' do
+      it do
+        expect(ok_format.with(object_source)).to eq(ok_string_expected)
+      end
+    end
+
+    context 'when object has not all methods' do
+      it do
+        expect { fail_format.with(object_source) }.to raise_error(ArgumentError)
+      end
+    end
+  end
+end

data/sub/eac_ruby_utils/spec/lib/eac_ruby_utils/enum_spec.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+RSpec.describe EacRubyUtils::Enum do
+  let(:klass) do
+    Class.new(described_class) do
+      attr_reader :color
+
+      def initialize(key, color = :none)
+        super(key)
+        @color = color
+      end
+
+      enum :horse
+      enum :pig, [:pink]
+      enum(:dog, :white)
+      enum(:cat) { :black }
+    end
+  end
+
+  it { expect(klass.horse).to be_a(klass) }
+  it { expect(klass.pig).to be_a(klass) }
+  it { expect(klass.dog).to be_a(klass) }
+  it { expect(klass.cat).to be_a(klass) }
+
+  it { expect(klass.horse.color).to eq(:none) }
+  it { expect(klass.pig.color).to eq(:pink) }
+  it { expect(klass.dog.color).to eq(:white) }
+  it { expect(klass.cat.color).to eq(:black) }
+
+  it { expect(klass.const_get(:HORSE)).to eq(klass.horse) }
+  it { expect(klass.const_get(:PIG)).to eq(klass.pig) }
+  it { expect(klass.const_get(:DOG)).to eq(klass.dog) }
+  it { expect(klass.const_get(:CAT)).to eq(klass.cat) }
+
+  it { expect(klass.values).to eq([klass.horse, klass::PIG, klass.dog, klass::CAT]) }
+
+  describe '#enum' do
+    it do
+      expect { klass.enum(:PiG) }.to raise_error(ArgumentError)
+    end
+  end
+end

data/sub/eac_ruby_utils/spec/lib/eac_ruby_utils/enumerables_methods_spec.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+RSpec.describe EacRubyUtils::EnumerablesMethods do
+  describe '#write_method?' do
+    it do
+      expect(described_class).to be_write_method(:'[]=')
+    end
+
+    it do
+      expect(described_class).not_to be_write_method(:'!=')
+    end
+  end
+
+  [
+    [:enumerable, %i[drop lazy sort], []],
+    [:hash, %i[\[\] <= compact slice to_h values],
+     %i[\[\]= compact! delete default= keep_if shift]],
+    [:set, %i[<= include?], %i[<< add clear collect! divide delete keep_if merge reset subtract]]
+  ].each do |test_values|
+    klass_underscore, read_methods, write_methods = test_values # rubocop:disable RSpec/LeakyLocalVariable
+
+    context "when class/module is #{klass_underscore}" do
+      let(:const_prefix) { klass_underscore.to_s.upcase }
+      let(:const_all) { "#{const_prefix}_METHODS" }
+      let(:const_read) { "#{const_prefix}_READ_METHODS" }
+      let(:const_write) { "#{const_prefix}_WRITE_METHODS" }
+      let(:actual_all) { described_class.const_get(const_all) }
+      let(:actual_read) { described_class.const_get(const_read) }
+      let(:actual_write) { described_class.const_get(const_write) }
+
+      read_methods.each do |method_name|
+        context "when method is \"#{method_name}\"" do
+          it { expect(actual_all).to include(method_name) }
+          it { expect(actual_read).to include(method_name) }
+          it { expect(actual_write).not_to include(method_name) }
+        end
+      end
+
+      write_methods.each do |method_name|
+        context "when method is \"#{method_name}\"" do
+          it { expect(actual_all).to include(method_name) }
+          it { expect(actual_read).not_to include(method_name) }
+          it { expect(actual_write).to include(method_name) }
+        end
+      end
+    end
+  end
+end