caracal_the_curve 1.4.1

data/spec/lib/caracal/core/models/bookmark_model_spec.rb

@@ -0,0 +1,135 @@
+require 'spec_helper'
+
+describe Caracal::Core::Models::BookmarkModel do
+  subject do
+    described_class.new do
+      id      '0'
+      name    'myAnchor'
+      start   false
+    end
+  end
+
+  #-------------------------------------------------------------
+  # Configuration
+  #-------------------------------------------------------------
+
+  describe 'configuration tests' do
+
+    # accessors
+    describe 'accessors' do
+      it { expect(subject.bookmark_id).to eq    '0' }
+      it { expect(subject.bookmark_name).to eq  'myAnchor' }
+      it { expect(subject.bookmark_start).to eq false }
+    end
+
+  end
+
+
+  #-------------------------------------------------------------
+  # Public Methods
+  #-------------------------------------------------------------
+
+  describe 'public method tests' do
+
+    #=============== GETTERS ==========================
+
+    # .run_attributes
+    describe '.run_attributes' do
+      let(:expected) { { id: '0', name: 'myAnchor', start: false} }
+
+      it { expect(subject.run_attributes).to eq expected }
+    end
+
+
+    #=============== SETTERS ==========================
+
+    # booleans
+    describe '.start' do
+      before { subject.start(true) }
+
+      it { expect(subject.bookmark_start).to eq true }
+    end
+
+    # strings
+    describe '.id' do
+      before { subject.id('dddddd') }
+
+      it { expect(subject.bookmark_id).to eq 'dddddd' }
+    end
+    describe '.name' do
+      before { subject.name('999999') }
+
+      it { expect(subject.bookmark_name).to eq '999999' }
+    end
+
+
+    #=============== STATE HELPERS ========================
+
+    describe '.start?' do
+      describe 'when start is true' do
+        before { subject.start(true) }
+
+        it { expect(subject.start?).to eq true }
+      end
+      describe 'when start is false' do
+        before { subject.start(false) }
+
+        it { expect(subject.start?).to eq false }
+      end
+    end
+
+
+    #=============== VALIDATION ===========================
+
+    describe '.valid?' do
+      describe 'when required attributes provided' do
+        it { expect(subject.valid?).to eq true }
+      end
+      describe 'when start is true' do
+        before { subject.start(true) }
+
+        [:id, :name].each do |prop|
+          describe "when #{ prop } is empty" do
+            before do
+              allow(subject).to receive("bookmark_#{ prop }").and_return(nil)
+            end
+
+            it { expect(subject.valid?).to eq false }
+          end
+        end
+      end
+      describe 'when start is false' do
+        before { subject.start(false) }
+
+        [:id].each do |prop|
+          describe "when #{ prop } is empty" do
+            before do
+              allow(subject).to receive("bookmark_#{ prop }").and_return(nil)
+            end
+
+            it { expect(subject.valid?).to eq false }
+          end
+        end
+      end
+    end
+
+  end
+
+
+  #-------------------------------------------------------------
+  # Private Methods
+  #-------------------------------------------------------------
+
+  describe 'private method tests' do
+
+    # .option_keys
+    describe '.option_keys' do
+      let(:actual)   { subject.send(:option_keys).sort }
+      let(:expected) { [:id, :name, :start].sort }
+
+      it { expect(actual).to eq expected }
+    end
+
+  end
+
+end

data/spec/lib/caracal/core/models/border_model_spec.rb

@@ -0,0 +1,159 @@
+require 'spec_helper'
+
+describe Caracal::Core::Models::BorderModel do
+  subject do 
+    described_class.new do
+      color   '666666'
+      size    8
+      spacing 2
+      line    :double
+      type    :horizontal
+    end
+  end
+  
+  #-------------------------------------------------------------
+  # Configuration
+  #-------------------------------------------------------------
+
+  describe 'configuration tests' do
+    
+    # constants
+    describe 'constants' do
+      it { expect(described_class::DEFAULT_BORDER_COLOR).to   eq 'auto' }
+      it { expect(described_class::DEFAULT_BORDER_LINE).to    eq :single }
+      it { expect(described_class::DEFAULT_BORDER_SIZE).to    eq 4 }
+      it { expect(described_class::DEFAULT_BORDER_SPACING).to eq 1 }
+      it { expect(described_class::DEFAULT_BORDER_TYPE).to    eq :top }
+    end
+    
+    # accessors
+    describe 'accessors' do
+      it { expect(subject.border_color).to   eq '666666' }
+      it { expect(subject.border_line).to    eq :double }
+      it { expect(subject.border_size).to    eq 8 }
+      it { expect(subject.border_spacing).to eq 2 }
+      it { expect(subject.border_type).to    eq :horizontal }
+    end
+    
+  end
+  
+  
+  #-------------------------------------------------------------
+  # Public Methods
+  #-------------------------------------------------------------
+  
+  describe 'public method tests' do
+  
+    #=============== GETTERS ==========================
+    
+    # .formatted_type
+    describe '.formatted_type' do
+      describe 'when horizontal' do
+        before do
+          allow(subject).to receive(:border_type).and_return(:horizontal)
+        end
+      
+        it { expect(subject.formatted_type).to eq 'insideH'}
+      end
+      describe 'when vertical' do
+        before do
+          allow(subject).to receive(:border_type).and_return(:vertical)
+        end
+      
+        it { expect(subject.formatted_type).to eq 'insideV'}
+      end
+      describe 'when other' do
+        before do
+          allow(subject).to receive(:border_type).and_return(:top)
+        end
+      
+        it { expect(subject.formatted_type).to eq 'top'}
+      end
+    end
+    
+    # .total_size
+    describe '.total_size' do
+      before do
+        allow(subject).to receive(:border_size).and_return(10)
+        allow(subject).to receive(:border_spacing).and_return(2)
+      end
+      
+      it { expect(subject.total_size).to eq 14}
+    end
+    
+    
+    #=============== SETTERS ==========================
+    
+    # .color
+    describe '.color' do
+      before { subject.color('999999') }
+      
+      it { expect(subject.border_color).to eq '999999' }
+    end
+    
+    # .line
+    describe '.line' do
+      before { subject.line(:single) }
+      
+      it { expect(subject.border_line).to eq :single }
+    end
+    
+    # .size
+    describe '.size' do
+      before { subject.size(24) }
+      
+      it { expect(subject.border_size).to eq 24 }
+    end
+    
+    # .spacing
+    describe '.spacing' do
+      before { subject.spacing(8) }
+      
+      it { expect(subject.border_spacing).to eq 8 }
+    end
+    
+    # .type
+    describe '.type' do
+      before { subject.type(:bottom) }
+      
+      it { expect(subject.border_type).to eq :bottom }
+    end
+    
+    
+    #=============== VALIDATION ===========================
+    
+    describe '.valid?' do
+      describe 'when all integers gt 0' do
+        it { expect(subject.valid?).to eq true }
+      end
+      [:size, :spacing].each do |d|
+        describe "when #{ d } lte 0" do
+          before do
+            allow(subject).to receive("border_#{ d }").and_return(0)
+          end
+        
+          it { expect(subject.valid?).to eq false }
+        end
+      end
+    end
+  
+  end
+  
+  
+  #-------------------------------------------------------------
+  # Private Methods
+  #-------------------------------------------------------------
+  
+  describe 'private method tests' do
+    
+    # .option_keys
+    describe '.option_keys' do
+      let(:actual)   { subject.send(:option_keys).sort }
+      let(:expected) { [:color, :size, :spacing, :line, :type].sort }
+      
+      it { expect(actual).to eq expected }
+    end
+    
+  end
+  
+end

data/spec/lib/caracal/core/models/font_model_spec.rb

@@ -0,0 +1,92 @@
+require 'spec_helper'
+
+describe Caracal::Core::Models::FontModel do
+  subject { described_class.new({ name: 'Arial' }) }
+  
+  
+  #-------------------------------------------------------------
+  # Configuration
+  #-------------------------------------------------------------
+
+  describe 'configuration tests' do
+    
+    # accessors
+    describe 'accessors' do
+      it { expect(subject.font_name).to eq 'Arial' }
+    end
+    
+  end
+  
+  
+  #-------------------------------------------------------------
+  # Public Methods
+  #-------------------------------------------------------------
+  
+  describe 'public method tests' do
+    
+    #=================== SETTERS =============================
+    
+    # .name
+    describe '.name' do
+      before do
+        subject.name('Helvetica')
+      end
+      
+      it { expect(subject.font_name).to eq 'Helvetica' }
+    end
+    
+    
+    #=================== STATE ===============================
+    
+    # .matches?
+    describe '.matches?' do
+      describe 'when search term matches' do
+        let(:actual) { subject.matches?('Arial') }
+        
+        it { expect(actual).to eq true }
+      end
+      describe 'when search term does not match' do
+        let(:actual) { subject.matches?('Dummy') }
+        
+        it { expect(actual).to eq false }
+      end
+    end
+    
+    
+    #=============== VALIDATION ===========================
+    
+    describe '.valid?' do
+      describe 'when name provided' do
+        it { expect(subject.valid?).to eq true }
+      end
+      [:name].each do |prop|
+        describe "when #{ prop } nil" do
+          before do
+            allow(subject).to receive("font_#{ prop }").and_return(nil)
+          end
+        
+          it { expect(subject.valid?).to eq false }
+        end
+      end
+    end
+    
+  end
+  
+  
+  #-------------------------------------------------------------
+  # Private Methods
+  #-------------------------------------------------------------
+  
+  describe 'private method tests' do
+    
+    # .option_keys
+    describe '.option_keys' do
+      let(:actual)   { subject.send(:option_keys).sort }
+      let(:expected) { [:name].sort }
+      
+      it { expect(actual).to eq expected }
+    end
+    
+  end
+  
+end

data/spec/lib/caracal/core/models/iframe_model_spec.rb

@@ -0,0 +1,83 @@
+require 'spec_helper'
+
+describe Caracal::Core::Models::IFrameModel do
+  subject do
+    described_class.new do
+      url    'https://www.example.com/snippet.docx'
+    end
+  end
+
+
+
+  #-------------------------------------------------------------
+  # Configuration
+  #-------------------------------------------------------------
+
+  describe 'configuration tests' do
+
+    # accessors
+    describe 'accessors' do
+      it { expect(subject.iframe_url).to    eq 'https://www.example.com/snippet.docx' }
+    end
+
+  end
+
+
+  #-------------------------------------------------------------
+  # Public Methods
+  #-------------------------------------------------------------
+
+  describe 'public method tests' do
+
+    #=============== SETTERS ==========================
+
+    # .url
+    describe '.url' do
+      before { subject.url('https://www.example.com/sample.docx') }
+
+      it { expect(subject.iframe_url).to eq 'https://www.example.com/sample.docx' }
+    end
+
+    # .data
+    describe '.data' do
+      before { subject.data('DOCX data follows here') }
+
+      it { expect(subject.iframe_data).to eq 'DOCX data follows here' }
+    end
+
+
+    #=============== VALIDATION ===========================
+
+    describe '.valid?' do
+      describe 'when either value present' do
+        it { expect(subject.valid?).to eq true }
+      end
+      describe 'when neither value present' do
+        before do
+          subject.url(nil)
+          subject.data(nil)
+        end
+        it { expect(subject.valid?).to eq false }
+      end
+    end
+
+  end
+
+
+  #-------------------------------------------------------------
+  # Private Methods
+  #-------------------------------------------------------------
+
+  describe 'private method tests' do
+
+    # .option_keys
+    describe '.option_keys' do
+      let(:actual)   { subject.send(:option_keys).sort }
+      let(:expected) { [:url, :data].sort }
+
+      it { expect(actual).to eq expected }
+    end
+
+  end
+
+end

data/spec/lib/caracal/core/models/image_model_spec.rb

@@ -0,0 +1,225 @@
+require 'spec_helper'
+
+describe Caracal::Core::Models::ImageModel do
+  subject do
+    described_class.new do
+      url    'https://www.google.com/images/srpr/logo11w.png'
+      ppi     96
+      width   250
+      height  200
+      align   :right
+      top     12
+      bottom  13
+      left    14
+      right   15
+    end
+  end
+
+
+
+  #-------------------------------------------------------------
+  # Configuration
+  #-------------------------------------------------------------
+
+  describe 'configuration tests' do
+
+    # constants
+    describe 'constants' do
+      it { expect(described_class::DEFAULT_IMAGE_PPI).to eq 72 }
+      it { expect(described_class::DEFAULT_IMAGE_WIDTH).to eq 0 }
+      it { expect(described_class::DEFAULT_IMAGE_HEIGHT).to eq 0 }
+      it { expect(described_class::DEFAULT_IMAGE_ALIGN).to eq :left }
+      it { expect(described_class::DEFAULT_IMAGE_TOP).to eq 8 }
+      it { expect(described_class::DEFAULT_IMAGE_BOTTOM).to eq 8 }
+      it { expect(described_class::DEFAULT_IMAGE_LEFT).to eq 8 }
+      it { expect(described_class::DEFAULT_IMAGE_RIGHT).to eq 8 }
+    end
+
+    # accessors
+    describe 'accessors' do
+      it { expect(subject.image_url).to    eq 'https://www.google.com/images/srpr/logo11w.png' }
+      it { expect(subject.image_data).to   eq nil }
+      it { expect(subject.image_ppi).to    eq 96 }
+      it { expect(subject.image_width).to  eq 250 }
+      it { expect(subject.image_height).to eq 200 }
+      it { expect(subject.image_align).to  eq :right }
+      it { expect(subject.image_top).to    eq 12 }
+      it { expect(subject.image_bottom).to eq 13 }
+      it { expect(subject.image_left).to   eq 14 }
+      it { expect(subject.image_right).to  eq 15 }
+    end
+
+  end
+
+
+  #-------------------------------------------------------------
+  # Public Methods
+  #-------------------------------------------------------------
+
+  describe 'public method tests' do
+
+    #=============== GETTERS ==========================
+
+    # emu conversions (dimensions)
+    [:width, :height].each do |m|
+      describe ".formatted_#{ m }" do
+        let(:actual) { subject.send("formatted_#{ m }") }
+
+        before do
+          allow(subject).to receive("image_#{ m }").and_return(540)
+          allow(subject).to receive("image_ppi").and_return(96)
+        end
+
+        it { expect(actual).to eq 5143500 }
+      end
+    end
+
+    # emu conversions (margins)
+    [:top, :bottom, :left, :right].each do |m|
+      describe ".formatted_#{ m }" do
+        let(:actual) { subject.send("formatted_#{ m }") }
+
+        before { allow(subject).to receive("image_#{ m }").and_return(9) }
+
+        it { expect(actual).to eq 114300 }
+      end
+    end
+
+
+
+    #=============== SETTERS ==========================
+
+    # .url
+    describe '.url' do
+      before { subject.url('https://www.google.com/images/dummy.png') }
+
+      it { expect(subject.image_url).to eq 'https://www.google.com/images/dummy.png' }
+    end
+
+    # .data
+    describe '.data' do
+      before { subject.data('PNG Data follows here') }
+
+      it { expect(subject.image_data).to eq 'PNG Data follows here' }
+    end
+
+    # .ppi
+    describe '.ppi' do
+      before { subject.ppi(108) }
+
+      it { expect(subject.image_ppi).to eq 108 }
+    end
+
+    # .width
+    describe '.width' do
+      before { subject.width(300) }
+
+      it { expect(subject.image_width).to eq 300 }
+    end
+
+    # .height
+    describe '.height' do
+      before { subject.height(400) }
+
+      it { expect(subject.image_height).to eq 400 }
+    end
+
+    # .align
+    describe '.align' do
+      before { subject.align(:center) }
+
+      it { expect(subject.image_align).to eq :center }
+    end
+
+    # .top
+    describe '.top' do
+      before { subject.top(12) }
+
+      it { expect(subject.image_top).to eq 12 }
+    end
+
+    # .bottom
+    describe '.bottom' do
+      before { subject.bottom(12) }
+
+      it { expect(subject.image_bottom).to eq 12 }
+    end
+
+    # .left
+    describe '.left' do
+      before { subject.left(12) }
+
+      it { expect(subject.image_left).to eq 12 }
+    end
+
+    # .right
+    describe '.right' do
+      before { subject.right(12) }
+
+      it { expect(subject.image_right).to eq 12 }
+    end
+
+
+    #=============== VALIDATION ===========================
+
+    describe '.valid?' do
+      describe 'when all values okay' do
+        it { expect(subject.valid?).to eq true }
+      end
+      [:width, :height, :top, :bottom, :left, :right].each do |d|
+        describe "when #{ d } lte 0" do
+          before do
+            allow(subject).to receive("image_#{ d }").and_return(0)
+          end
+
+          it { expect(subject.valid?).to eq false }
+        end
+      end
+    end
+
+  end
+
+
+  #-------------------------------------------------------------
+  # Private Methods
+  #-------------------------------------------------------------
+
+  describe 'private method tests' do
+
+    # .option_keys
+    describe '.option_keys' do
+      let(:actual)   { subject.send(:option_keys).sort }
+      let(:expected) { [:url, :width, :height, :align, :top, :bottom, :left, :right].sort }
+
+      it { expect(actual).to eq expected }
+    end
+
+    # .pixels_to_emus
+    describe '.pixels_to_emus' do
+      let(:actual) { subject.send(:pixels_to_emus, value, 72) }
+
+      describe 'when argument is nil' do
+        let(:value) { nil }
+
+        it { expect(actual).to eq 0 }
+      end
+      describe 'when argument is NaN' do
+        let(:value) { 'a' }
+
+        it { expect(actual).to eq 0 }
+      end
+      describe 'when argument is rational' do
+        let(:value) { 396.1 }
+
+        it { expect(actual).to eq 5029200 }
+      end
+      describe 'when argument is integer' do
+        let(:value) { 396 }
+
+        it { expect(actual).to eq 5029200 }
+      end
+    end
+
+  end
+
+end

data/spec/lib/caracal/core/models/line_break_model_spec.rb

@@ -0,0 +1,21 @@
+require 'spec_helper'
+
+describe Caracal::Core::Models::LineBreakModel do
+  let(:name) { 'Arial' }
+  
+  subject { described_class.new }
+  
+  
+  #-------------------------------------------------------------
+  # Configuration
+  #-------------------------------------------------------------
+  
+  describe 'configuration tests' do
+    
+    describe 'inheritance' do
+      it { expect(subject).to be_a(Caracal::Core::Models::BaseModel) }
+    end
+    
+  end
+  
+end