command_kit 0.3.0 → 0.4.0

data/spec/printing/tables/row_builder_spec.rb

@@ -0,0 +1,165 @@
+require 'spec_helper'
+require 'command_kit/printing/tables/row_builder'
+
+describe CommandKit::Printing::Tables::RowBuilder do
+  it { expect(described_class).to include(Enumerable) }
+
+  describe "#initialize" do
+    it "must initialize #cells to an empty Array" do
+      expect(subject.cells).to eq([])
+    end
+
+    it "must default #height to 0" do
+      expect(subject.height).to eq(0)
+    end
+
+    it "must default #width to 0" do
+      expect(subject.width).to eq(0)
+    end
+
+    it "must default #columns to 0" do
+      expect(subject.columns).to eq(0)
+    end
+
+    context "when given initial cells" do
+      let(:cell1) { "foo bar\nbaz qux" }
+      let(:cell2) { 'aaaa bbbb' }
+      let(:cells) { [cell1, cell2] }
+
+      subject { described_class.new(cells) }
+
+      it "must append the cells to the row" do
+        expect(subject.cells[0]).to be_kind_of(CommandKit::Printing::Tables::CellBuilder)
+        expect(subject.cells[0].lines).to eq(cell1.lines(chomp: true))
+
+        expect(subject.cells[1]).to be_kind_of(CommandKit::Printing::Tables::CellBuilder)
+        expect(subject.cells[1].lines).to eq(cell2.lines(chomp: true))
+      end
+    end
+  end
+
+  describe "#<<" do
+    context "when given a non-nil value" do
+      let(:value) { "foo bar\nbaz qux" }
+
+      it "must append a new CommandKit::Printing::Tables::CellBuilder object to #cells" do
+        subject << value
+
+        expect(subject.cells.last).to be_kind_of(CommandKit::Printing::Tables::CellBuilder)
+        expect(subject.cells.last.lines).to eq(value.lines(chomp: true))
+      end
+
+      context "when the new cell's height is greater than the row's current #height" do
+        let(:value1) { "foo" }
+        let(:value2) { "bar\nbaz\nqux" }
+
+        it "must update the row's current #height" do
+          expect(subject.height).to eq(0)
+
+          subject << value1
+          expect(subject.height).to eq(subject.cells[0].height)
+
+          subject << value2
+          expect(subject.height).to eq(subject.cells[1].height)
+        end
+      end
+
+      context "when the new cell's height is not greater than the row's current #height" do
+        let(:value1) { "bar\nbaz\nqux" }
+        let(:value2) { "foo" }
+
+        it "must not update the row's current #height" do
+          expect(subject.height).to eq(0)
+
+          subject << value1
+          expect(subject.height).to eq(subject.cells[0].height)
+
+          subject << value2
+          expect(subject.height).to eq(subject.cells[0].height)
+        end
+      end
+
+      it "must add the cell value's line width to the row's #width" do
+        value1 = "foo"
+        value1_width = CommandKit::Printing::Tables::CellBuilder.line_width(value1)
+
+        expect(subject.width).to eq(0)
+
+        subject << value1
+        expect(subject.width).to eq(value1_width)
+
+        value2 = "\e[32mbar\e[0m"
+        value2_width = CommandKit::Printing::Tables::CellBuilder.line_width(value2)
+
+        subject << value2
+        expect(subject.width).to eq(value1_width + value2_width)
+      end
+
+      it "must incrmenet #columns by 1" do
+        expect(subject.columns).to eq(0)
+
+        subject << "foo"
+        expect(subject.columns).to eq(1)
+
+        subject << "bar"
+        expect(subject.columns).to eq(2)
+      end
+
+      it "must return self" do
+        expect(subject << value).to be(subject)
+      end
+    end
+
+    context "when given a nil value" do
+      it "must append #{described_class}::EMPTY_CELL to #cells" do
+        subject << nil
+
+        expect(subject.cells.last).to be(described_class::EMPTY_CELL)
+      end
+
+      it "must return self" do
+        expect(subject << nil).to be(subject)
+      end
+    end
+  end
+
+  describe "#[]" do
+    before do
+      subject << "foo bar"
+      subject << "baz qux"
+    end
+
+    context "when the given column index is within the bounds of #cells" do
+      it "must return the cell at the given index" do
+        expect(subject[1]).to be(subject.cells[1])
+      end
+    end
+
+    context "when the given column index is not within the bounds of #cells" do
+      it "must return #{described_class}::EMPTY_CELL" do
+        expect(subject[2]).to be(described_class::EMPTY_CELL)
+      end
+    end
+  end
+
+  describe "#each" do
+    before do
+      subject << "foo bar"
+      subject << "baz qux"
+    end
+
+    context "when given a block" do
+      it "must yield each cell in #cells" do
+        expect { |b|
+          subject.each(&b)
+        }.to yield_successive_args(*subject.cells)
+      end
+    end
+
+    context "when no block is given" do
+      it "must return an Enumerator for #cells" do
+        expect(subject.each.to_a).to eq(subject.cells)
+      end
+    end
+  end
+end

data/spec/printing/tables/style_spec.rb

@@ -0,0 +1,377 @@
+require 'spec_helper'
+require 'command_kit/printing/tables/style'
+
+describe CommandKit::Printing::Tables::Style do
+  describe "BORDER_STYLES" do
+    subject { described_class::BORDER_STYLES }
+
+    it "must be a Hash" do
+      expect(subject).to be_kind_of(Hash)
+    end
+
+    describe ":ascii" do
+      subject { super()[:ascii] }
+
+      it "must be a CommandKit::Printing::Tables::BorderStyle" do
+        expect(subject).to be_kind_of(CommandKit::Printing::Tables::BorderStyle)
+      end
+
+      it "must set #top_left_corner to '+'" do
+        expect(subject.top_left_corner).to eq('+')
+      end
+
+      it "must set #top_border to '-'" do
+        expect(subject.top_border).to eq('-')
+      end
+
+      it "must set #top_joined_border to '+'" do
+        expect(subject.top_joined_border).to eq('+')
+      end
+
+      it "must set #top_right_corner to '+'" do
+        expect(subject.top_right_corner).to eq('+')
+      end
+
+      it "must set #left_border to '|'" do
+        expect(subject.left_border).to eq('|')
+      end
+
+      it "must set #left_joined_border to '+'" do
+        expect(subject.left_joined_border).to eq('+')
+      end
+
+      it "must set #horizontal_separator to '-'" do
+        expect(subject.horizontal_separator).to eq('-')
+      end
+
+      it "must set #vertical_separator to '|'" do
+        expect(subject.vertical_separator).to eq('|')
+      end
+
+      it "must set #inner_joined_border to '+'" do
+        expect(subject.inner_joined_border).to eq('+')
+      end
+
+      it "must set #right_border to '|'" do
+        expect(subject.right_border).to eq('|')
+      end
+
+      it "must set #right_joined_border to '+'" do
+        expect(subject.right_joined_border).to eq('+')
+      end
+
+      it "must set #bottom_border to '-'" do
+        expect(subject.bottom_border).to eq('-')
+      end
+
+      it "must set #bottom_left_corner to '+'" do
+        expect(subject.bottom_left_corner).to eq('+')
+      end
+
+      it "must set #bottom_joined_border to '+'" do
+        expect(subject.bottom_joined_border).to eq('+')
+      end
+
+      it "must set #bottom_right_corner to '+'" do
+        expect(subject.bottom_right_corner).to eq('+')
+      end
+    end
+
+    describe ":line" do
+      subject { super()[:line] }
+
+      it "must be a CommandKit::Printing::Tables::BorderStyle" do
+        expect(subject).to be_kind_of(CommandKit::Printing::Tables::BorderStyle)
+      end
+
+      it "must set #top_left_corner to '┌'" do
+        expect(subject.top_left_corner).to eq('┌')
+      end
+
+      it "must set #top_border to '─'" do
+        expect(subject.top_border).to eq('─')
+      end
+
+      it "must set #top_joined_border to '┬'" do
+        expect(subject.top_joined_border).to eq('┬')
+      end
+
+      it "must set #top_right_corner to '┐'" do
+        expect(subject.top_right_corner).to eq('┐')
+      end
+
+      it "must set #left_border to '│'" do
+        expect(subject.left_border).to eq('│')
+      end
+
+      it "must set #left_joined_border to '├'" do
+        expect(subject.left_joined_border).to eq('├')
+      end
+
+      it "must set #horizontal_separator to '─'" do
+        expect(subject.horizontal_separator).to eq('─')
+      end
+
+      it "must set #vertical_separator to '│'" do
+        expect(subject.vertical_separator).to eq('│')
+      end
+
+      it "must set #inner_joined_border to '┼'" do
+        expect(subject.inner_joined_border).to eq('┼')
+      end
+
+      it "must set #right_border to '│'" do
+        expect(subject.right_border).to eq('│')
+      end
+
+      it "must set #right_joined_border to '┤'" do
+        expect(subject.right_joined_border).to eq('┤')
+      end
+
+      it "must set #bottom_border to '─'" do
+        expect(subject.bottom_border).to eq('─')
+      end
+
+      it "must set #bottom_left_corner to '└'" do
+        expect(subject.bottom_left_corner).to eq('└')
+      end
+
+      it "must set #bottom_joined_border to '┴'" do
+        expect(subject.bottom_joined_border).to eq('┴')
+      end
+
+      it "must set #bottom_right_corner to '┘'" do
+        expect(subject.bottom_right_corner).to eq('┘')
+      end
+    end
+
+    describe ":double_line" do
+      subject { super()[:double_line] }
+
+      it "must be a CommandKit::Printing::Tables::BorderStyle" do
+        expect(subject).to be_kind_of(CommandKit::Printing::Tables::BorderStyle)
+      end
+
+      it "must set #top_left_corner to '╔'" do
+        expect(subject.top_left_corner).to eq('╔')
+      end
+
+      it "must set #top_border to '═'" do
+        expect(subject.top_border).to eq('═')
+      end
+
+      it "must set #top_joined_border to '╦'" do
+        expect(subject.top_joined_border).to eq('╦')
+      end
+
+      it "must set #top_right_corner to '╗'" do
+        expect(subject.top_right_corner).to eq('╗')
+      end
+
+      it "must set #left_border to '║'" do
+        expect(subject.left_border).to eq('║')
+      end
+
+      it "must set #left_joined_border to '╠'" do
+        expect(subject.left_joined_border).to eq('╠')
+      end
+
+      it "must set #horizontal_separator to '═'" do
+        expect(subject.horizontal_separator).to eq('═')
+      end
+
+      it "must set #vertical_separator to '║'" do
+        expect(subject.vertical_separator).to eq('║')
+      end
+
+      it "must set #inner_joined_border to '╬'" do
+        expect(subject.inner_joined_border).to eq('╬')
+      end
+
+      it "must set #right_border to '║'" do
+        expect(subject.right_border).to eq('║')
+      end
+
+      it "must set #right_joined_border to '╣'" do
+        expect(subject.right_joined_border).to eq('╣')
+      end
+
+      it "must set #bottom_border to '═'" do
+        expect(subject.bottom_border).to eq('═')
+      end
+
+      it "must set #bottom_left_corner to '╚'" do
+        expect(subject.bottom_left_corner).to eq('╚')
+      end
+
+      it "must set #bottom_joined_border to '╩'" do
+        expect(subject.bottom_joined_border).to eq('╩')
+      end
+
+      it "must set #bottom_right_corner to '╝'" do
+        expect(subject.bottom_right_corner).to eq('╝')
+      end
+    end
+  end
+
+  describe "#initialize" do
+    it "must default #border to nil" do
+      expect(subject.border).to be(nil)
+    end
+
+    it "must default #padding to 1" do
+      expect(subject.padding).to be(1)
+    end
+
+    it "must default #justify to :left" do
+      expect(subject.justify).to be(:left)
+    end
+
+    it "must default #justify_header to :center" do
+      expect(subject.justify_header).to be(:center)
+    end
+
+    it "must default #separate_rows to false" do
+      expect(subject.separate_rows).to eq(false)
+    end
+
+    context "when given the border: keyword argument" do
+      context "and it's a Hash" do
+        let(:hash) do
+          {
+           top_left_corner:      '=',
+           top_border:           '=',
+           top_joined_border:    '=',
+           top_right_corner:     '=',
+           bottom_left_corner:   '=',
+           bottom_border:        '=',
+           bottom_joined_border: '=',
+           bottom_right_corner:  '='
+          }
+        end
+
+        subject { described_class.new(border: hash) }
+
+        it "must initialize #border to a new CommandKit::Printing::Tables::BorderStyle" do
+          expect(subject.border).to be_kind_of(CommandKit::Printing::Tables::BorderStyle)
+          expect(subject.border.top_left_corner).to eq('=')
+          expect(subject.border.top_border).to eq('=')
+          expect(subject.border.top_joined_border).to eq('=')
+          expect(subject.border.top_right_corner).to eq('=')
+          expect(subject.border.bottom_left_corner).to eq('=')
+          expect(subject.border.bottom_border).to eq('=')
+          expect(subject.border.bottom_joined_border).to eq('=')
+          expect(subject.border.bottom_right_corner).to eq('=')
+        end
+      end
+
+      context "and it's :ascii" do
+        subject { described_class.new(border: :ascii) }
+
+        it "must set #border to BORDER_STYLES[:ascii]" do
+          expect(subject.border).to be(described_class::BORDER_STYLES[:ascii])
+        end
+      end
+
+      context "and it's :line" do
+        subject { described_class.new(border: :line) }
+
+        it "must set #border to BORDER_STYLES[:line]" do
+          expect(subject.border).to be(described_class::BORDER_STYLES[:line])
+        end
+      end
+
+      context "and it's :double_line" do
+        subject { described_class.new(border: :double_line) }
+
+        it "must set #border to BORDER_STYLES[:double_line]" do
+          expect(subject.border).to be(described_class::BORDER_STYLES[:double_line])
+        end
+      end
+
+      context "but it's an unknwon Symbol" do
+        let(:border) { :foo }
+
+        it do
+          expect {
+            described_class.new(border: border)
+          }.to raise_error(ArgumentError,"unknown border style (#{border.inspect}) must be either :ascii, :line, :double_line")
+        end
+      end
+
+      context "and it's nil" do
+        subject { described_class.new(border: nil) }
+
+        it "must set #border to nil" do
+          expect(subject.border).to be(nil)
+        end
+      end
+
+      context "but it's not a Symbol, Hash, or nil" do
+        let(:border) { Object.new }
+
+        it do
+          expect {
+            described_class.new(border: border)
+          }.to raise_error(ArgumentError,"invalid border value (#{border.inspect}) must be either :ascii, :line, :double_line, Hash, or nil")
+        end
+      end
+    end
+
+    context "when given the padding: keyword argument" do
+      let(:padding) { 2 }
+
+      subject { described_class.new(padding: padding) }
+
+      it "must set #padding" do
+        expect(subject.padding).to eq(padding)
+      end
+    end
+
+    context "when given the justify: keyword argument" do
+      let(:justify) { :center }
+
+      subject { described_class.new(justify: justify) }
+
+      it "must set #justify" do
+        expect(subject.justify).to eq(justify)
+      end
+    end
+
+    context "when given the justify: keyword argument" do
+      let(:justify_header) { :left }
+
+      subject { described_class.new(justify_header: justify_header) }
+
+      it "must set #justify_header" do
+        expect(subject.justify_header).to eq(justify_header)
+      end
+    end
+
+    context "when given the separate_rows: keyword argument" do
+      let(:separate_rows) { true }
+
+      subject { described_class.new(separate_rows: separate_rows) }
+
+      it "must set #separate_rows" do
+        expect(subject.separate_rows).to eq(separate_rows)
+      end
+    end
+  end
+
+  describe "#separate_rows?" do
+    context "when initialized with separate_rows: true" do
+      subject { described_class.new(separate_rows: true) }
+
+      it "must return true" do
+        expect(subject.separate_rows?).to be(true)
+      end
+    end
+
+    context "when not initialized with separate_rows: true" do
+      it "must return false" do
+        expect(subject.separate_rows?).to be(false)
+      end
+    end
+  end
+end