html-table 1.6.3 → 1.7.1

data/spec/body_spec.rb

@@ -0,0 +1,98 @@
+############################################
+# body_spec.rb
+#
+# Test suite for the HTML::Table::Body class.
+############################################
+require 'rspec'
+require 'html/table'
+
+RSpec.describe HTML::Table::Body do
+  before do
+    @table = HTML::Table.new
+    @tbody = described_class.new
+  end
+
+  example 'constructor with no arguments' do
+    expect{ described_class.new }.not_to raise_error
+  end
+
+  example 'constructor with string argument' do
+    expect{ described_class.new('foo') }.not_to raise_error
+  end
+
+  example 'constructor with numeric argument' do
+    expect{ described_class.new(1) }.not_to raise_error
+  end
+
+  example 'constructor with array argument' do
+    expect{ described_class.new(%w[foo bar baz]) }.not_to raise_error
+    expect{ described_class.new([1, 2, 3]) }.not_to raise_error
+  end
+
+  example 'constructor with multiple array arguments' do
+    expect{ described_class.new([[1, 2, 3], %w[foo bar]]) }.not_to raise_error
+  end
+
+  example 'basic' do
+    html = '<tbody></tbody>'
+    expect(@tbody.html.gsub(/\s{2,}|\n/, '')).to eq(html)
+  end
+
+  example 'with_attributes' do
+    html = "<tbody align='left' char='x'></tbody>"
+    @tbody.align = 'left'
+    @tbody.char = 'x'
+    expect(@tbody.html.gsub(/\s{2,}|\n/, '')).to eq(html)
+  end
+
+  example 'push_single_row' do
+    html = '<tbody><tr><td>test</td></tr></tbody>'
+    @tbody.push(HTML::Table::Row.new{ |r| r.content = 'test' })
+    expect(@tbody.html.gsub(/\s{2,}|\n/, '')).to eq(html)
+  end
+
+  example 'push_multiple_rows' do
+    html = '<tbody><tr><td>test</td></tr><tr><td>foo</td></tr></tbody>'
+    r1 = HTML::Table::Row.new{ |r| r.content = 'test' }
+    r2 = HTML::Table::Row.new{ |r| r.content = 'foo' }
+    @tbody.push r1, r2
+    expect(@tbody.html.gsub(/\s{2,}|\n/, '')).to eq(html)
+  end
+
+  example 'add_content_directly' do
+    html = '<tbody><tr><td>hello</td><td>world</td></tr></tbody>'
+    @tbody.content = 'hello', 'world'
+    expect(@tbody.html.gsub(/\s{2,}|\n+/, '')).to eq(html)
+  end
+
+  example 'add_content_in_constructor' do
+    html = '<tbody><tr><td>hello</td><td>world</td></tr></tbody>'
+    tb = described_class.new(%w[hello world])
+    expect(tb.html.gsub(/\s{2,}|\n+/, '')).to eq(html)
+  end
+
+  example 'configure_column' do
+    html = "<tbody><tr><td>hello</td><td abbr='test' width=3 nowrap>world</td></tr></tbody>"
+
+    @tbody.content = 'hello', 'world'
+    @tbody.configure(0, 1) do |data|
+      data.abbr   = 'test'
+      data.width  = 3
+      data.nowrap = true
+    end
+
+    expect(@tbody.html.gsub(/\s{2,}|\n+/, '')).to eq(html)
+  end
+
+  example 'end_tags?' do
+    expect(described_class).to respond_to(:end_tags?)
+    expect(described_class.end_tags?).to be(true)
+  end
+
+  example 'end_tags=' do
+    expect(described_class).to respond_to(:end_tags=)
+    expect{ described_class.end_tags = 'foo' }.to raise_error(ArgumentTypeError)
+    expect{ described_class.end_tags = 1 }.to raise_error(ArgumentTypeError)
+    expect{ described_class.end_tags = true }.not_to raise_error
+  end
+end

data/spec/caption_spec.rb

@@ -0,0 +1,83 @@
+###################################################
+# caption_spec.rb
+#
+# Test suite for the HTML::Table::Caption class.
+###################################################
+require 'rspec'
+require 'html/table'
+
+RSpec.describe HTML::Table::Caption do
+  before do
+    @table = HTML::Table.new
+    @tcaption = described_class.new
+  end
+
+  example 'constructor' do
+    expect{ described_class.new }.not_to raise_error
+  end
+
+  example 'constructor with string' do
+    expect{ described_class.new('foo') }.not_to raise_error
+  end
+
+  example 'constructor with number' do
+    expect{ described_class.new(1) }.not_to raise_error
+  end
+
+  example 'constructor with arrays' do
+    expect{ described_class.new(%w[foo bar baz]) }.not_to raise_error
+    expect{ described_class.new([1, 2, 3]) }.not_to raise_error
+    expect{ described_class.new([[1, 2, 3], %w[foo bar]]) }.not_to raise_error
+  end
+
+  example 'basic' do
+    html = '<caption></caption>'
+    expect(@tcaption.html.gsub(/\s+/, '')).to eq(html)
+  end
+
+  example 'with_attributes' do
+    html = "<caption align='left' valign='top'></caption>"
+    @tcaption.align = 'left'
+    @tcaption.valign = 'top'
+    expect(@tcaption.html.gsub(/\s{2,}|\n+/, '')).to eq(html)
+  end
+
+  example 'configure_not_allowed' do
+    expect{ @tcaption.configure }.to raise_error(NoMethodError)
+  end
+
+  example 'add_content' do
+    html = '<caption>hello world</caption>'
+    @tcaption.content = 'hello world'
+    expect(@tcaption.html.gsub(/\s{2,}/, '')).to eq(html)
+  end
+
+  example 'add_multiple_content_items' do
+    html = '<caption>hello world</caption>'
+    @tcaption.content = 'hello', ' world'
+    expect(@tcaption.html.gsub(/\s{2,}/, '')).to eq(html)
+  end
+
+  example 'add_content_in_constructor' do
+    html = '<caption>hello world</caption>'
+    @tcaption = described_class.new('hello world')
+    expect(@tcaption.html.gsub(/\s{2,}/, '')).to eq(html)
+  end
+
+  example 'indent_level' do
+    expect(described_class).to respond_to(:indent_level)
+    expect(described_class).to respond_to(:indent_level=)
+    expect{ described_class.indent_level = 'foo' }.to raise_error(ArgumentTypeError)
+    expect{ described_class.indent_level = 3 }.not_to raise_error
+  end
+
+  example 'only_row_zero_allowed' do
+    expect{ @table[1] = @tcaption }.to raise_error(ArgumentError)
+  end
+
+  example 'automatically_set_to_row_zero' do
+    @table.content = 'hello', 'world'
+    @table.push(@tcaption)
+    expect(@table[0]).to be_a(described_class)
+  end
+end

data/spec/colgroup_col_spec.rb

@@ -0,0 +1,34 @@
+##################################################
+# colgroup_col_spec.rb
+#
+# Test suite for the Table::ColGroup::Col class
+##################################################
+require 'rspec'
+require 'html/table'
+
+RSpec.describe HTML::Table::ColGroup::Col do
+  before do
+    @col = described_class.new
+  end
+
+  example 'basic' do
+    html = '<col>'
+    expect(@col.html.gsub(/\s{2,}|\n+/, '')).to eq(html)
+  end
+
+  example 'no_configure' do
+    expect{ @col.configure }.to raise_error(NoMethodError)
+  end
+
+  example 'no_content_allowed' do
+    expect{ @col.content }.to raise_error(NoMethodError)
+    expect{ @col.content = 'foo' }.to raise_error(NoMethodError)
+  end
+
+  example 'indent_level' do
+    expect(described_class).to respond_to(:indent_level)
+    expect(described_class).to respond_to(:indent_level=)
+    expect{ described_class.indent_level = 'foo' }.to raise_error(ArgumentTypeError)
+    expect{ described_class.indent_level = 6 }.not_to raise_error
+  end
+end

data/spec/colgroup_spec.rb

@@ -0,0 +1,97 @@
+##################################################
+# colgroup_spec.rb
+#
+# Test suite for the HTML::Table::ColGroup class.
+##################################################
+require 'rspec'
+require 'html/table'
+
+RSpec.describe HTML::Table::ColGroup do
+  before do
+    @cgroup = described_class.new
+    @col = HTML::Table::ColGroup::Col.new
+  end
+
+  example 'constructor' do
+    expect{ described_class.new }.not_to raise_error
+    expect{ described_class.new(@col) }.not_to raise_error
+    expect{ described_class.new('foo') }.to raise_error(ArgumentTypeError)
+  end
+
+  example 'basic' do
+    html = '<colgroup></colgroup>'
+    expect(@cgroup.html.gsub(/\s+/, '')).to eq(html)
+  end
+
+  example 'with attributes' do
+    html = "<colgroup align='center' width='20%'></colgroup>"
+    @cgroup.align = 'center'
+    @cgroup.width = '20%'
+    expect(@cgroup.html.gsub(/\s{2,}|\n+/, '')).to eq(html)
+  end
+
+  example 'push single col element' do
+    html = '<colgroup><col></colgroup>'
+    @cgroup.push(@col)
+    expect(@cgroup.html.gsub(/\s{2,}|\n+/, '')).to eq(html)
+  end
+
+  example 'index assignment constraints' do
+    expect{ @cgroup[0] = 'foo' }.to raise_error(ArgumentTypeError)
+    expect{ @cgroup[0] = 1 }.to raise_error(ArgumentTypeError)
+    expect{ @cgroup[1] = HTML::Table::Row.new }.to raise_error(ArgumentTypeError)
+    expect{ @cgroup[0] = HTML::Table::ColGroup::Col.new }.not_to raise_error
+  end
+
+  example 'push constraints' do
+    expect{ @cgroup.push(7) }.to raise_error(ArgumentTypeError)
+    expect{ @cgroup.push('hello') }.to raise_error(ArgumentTypeError)
+    expect{ @cgroup.push(HTML::Table::Row.new) }.to raise_error(ArgumentTypeError)
+    expect{ @cgroup.push(HTML::Table::ColGroup::Col.new) }.not_to raise_error
+  end
+
+  example 'double arrow constraints' do
+    expect{ @cgroup << 7 }.to raise_error(ArgumentTypeError)
+    expect{ @cgroup << 'hello' }.to raise_error(ArgumentTypeError)
+    expect{ @cgroup << HTML::Table::Row.new }.to raise_error(ArgumentTypeError)
+    expect{ @cgroup << HTML::Table::ColGroup::Col.new }.not_to raise_error
+  end
+
+  example 'unshift constraints' do
+    expect{ @cgroup.unshift(7) }.to raise_error(ArgumentTypeError)
+    expect{ @cgroup.unshift('hello') }.to raise_error(ArgumentTypeError)
+    expect{ @cgroup.unshift(HTML::Table::Row.new) }.to raise_error(ArgumentTypeError)
+    expect{ @cgroup.unshift(HTML::Table::ColGroup::Col.new) }.not_to raise_error
+  end
+
+  example 'configure error' do
+    expect{ @cgroup.configure(0, 0){} }.to raise_error(ArgumentError)
+  end
+
+  example 'content error' do
+    expect{ @cgroup.content }.to raise_error(NoMethodError)
+    expect{ @cgroup.content = 'blah' }.to raise_error(NoMethodError)
+  end
+
+  example 'indent_level' do
+    expect(described_class).to respond_to(:indent_level)
+    expect(described_class).to respond_to(:indent_level=)
+    expect{ described_class.indent_level = 'foo' }.to raise_error(ArgumentTypeError)
+    expect{ described_class.indent_level = 6 }.not_to raise_error
+  end
+
+  example 'end_tags? basic functionality' do
+    expect(described_class).to respond_to(:end_tags?)
+    expect(described_class.end_tags?).to be(true)
+  end
+
+  example 'end_tags= basic functionality' do
+    expect(described_class).to respond_to(:end_tags=)
+    expect{ described_class.end_tags = true }.not_to raise_error
+  end
+
+  example 'end_tags= raises an error if an invalid type is assigned' do
+    expect{ described_class.end_tags = 'foo' }.to raise_error(ArgumentTypeError)
+    expect{ described_class.end_tags = 1 }.to raise_error(ArgumentTypeError)
+  end
+end

data/spec/data_spec.rb

@@ -0,0 +1,88 @@
+###################################################
+# data_spec.rb
+#
+# Test suite for the HTML::Table::Row::Data class.
+###################################################
+require 'rspec'
+require 'html/table'
+
+RSpec.describe HTML::Table::Row::Data do
+  before do
+    @tdata = described_class.new
+  end
+
+  example 'constructor' do
+    expect{ described_class.new }.not_to raise_error
+  end
+
+  example 'constructor with string' do
+    expect{ described_class.new('foo') }.not_to raise_error
+  end
+
+  example 'constructor with numeric' do
+    expect{ described_class.new(1) }.not_to raise_error
+  end
+
+  example 'constructor with arrays' do
+    expect{ described_class.new(%w[foo bar baz]) }.not_to raise_error
+    expect{ described_class.new([1, 2, 3]) }.not_to raise_error
+    expect{ described_class.new([[1, 2, 3], %w[foo bar]]) }.not_to raise_error
+  end
+
+  example 'basic' do
+    html = '<td></td>'
+    expect(@tdata.html.gsub(/\s+/, '')).to eq(html)
+  end
+
+  example 'with_attributes' do
+    html = "<td align='left' width=3 nowrap></td>"
+    @tdata.align = 'left'
+    @tdata.width = 3
+    @tdata.nowrap = true
+    expect(@tdata.html.gsub(/\s{2,}|\n+/, '')).to eq(html)
+  end
+
+  example 'configure_not_allowed' do
+    expect{ @tdata.configure }.to raise_error(NoMethodError)
+  end
+
+  example 'add_content' do
+    html = '<td>hello world</td>'
+    @tdata.content = 'hello world'
+    expect(@tdata.html.gsub(/\s{2,}/, '')).to eq(html)
+  end
+
+  example 'add_content_in_constructor' do
+    html = '<td>hello world</td>'
+    td = described_class.new('hello world')
+    expect(td.html.gsub(/\s{2,}/, '')).to eq(html)
+  end
+
+  example 'add_multiple_content_items' do
+    html = '<td>hello world</td>'
+    @tdata.content = 'hello', ' world'
+    expect(@tdata.html.gsub(/\s{2,}/, '')).to eq(html)
+  end
+
+  example 'indent_level' do
+    expect(described_class).to respond_to(:indent_level)
+    expect(described_class).to respond_to(:indent_level=)
+    expect{ described_class.indent_level = 'foo' }.to raise_error(ArgumentTypeError)
+    expect{ described_class.indent_level = 6 }.not_to raise_error
+  end
+
+  example 'end_tags? basic functionality' do
+    expect(described_class).to respond_to(:end_tags?)
+    expect(described_class.end_tags?).to be(true)
+  end
+
+  example 'end_tags= basic functionality' do
+    expect(described_class).to respond_to(:end_tags=)
+    expect{ described_class.end_tags = true }.not_to raise_error
+  end
+
+  example 'end_tags= raises an error on an invalid value' do
+    expect{ described_class.end_tags = 'foo' }.to raise_error(ArgumentTypeError)
+    expect{ described_class.end_tags = 1 }.to raise_error(ArgumentTypeError)
+  end
+end

data/spec/foot_spec.rb

@@ -0,0 +1,116 @@
+###############################################################################
+# foot_spec.rb
+#
+# Test suite for the HTML::Table::Foot class. The class is a singleton
+# class, so we have to take extra measures to ensure that a fresh instance
+# is created between tests.
+###############################################################################
+require 'rspec'
+require 'html/table'
+
+RSpec.describe HTML::Table::Foot do
+  before do
+    @tfoot = described_class.create
+  end
+
+  after do
+    described_class.instance_variable_set(:@instance, nil)
+  end
+
+  example 'constructor' do
+    expect{ described_class.create }.not_to raise_error
+  end
+
+  example 'constructor with string' do
+    expect{ described_class.create('foo') }.not_to raise_error
+  end
+
+  example 'constructor with numeric' do
+    expect{ described_class.create(1) }.not_to raise_error
+  end
+
+  example 'constructor with arrays' do
+    expect{ described_class.create(%w[foo bar baz]) }.not_to raise_error
+    expect{ described_class.create([1, 2, 3]) }.not_to raise_error
+    expect{ described_class.create([[1, 2, 3], %w[foo bar]]) }.not_to raise_error
+  end
+
+  example 'basic' do
+    html = '<tfoot></tfoot>'
+    expect(@tfoot.html.gsub(/\s{2,}|\n/, '')).to eq(html)
+  end
+
+  example 'end_tags? basic functionality' do
+    expect(described_class).to respond_to(:end_tags?)
+    expect(described_class.end_tags?).to be(true)
+    expect{ described_class.end_tags? }.not_to raise_error
+  end
+
+  example 'end_tags= basic functionality' do
+    expect(described_class).to respond_to(:end_tags=)
+    expect{ described_class.end_tags = true }.not_to raise_error
+  end
+
+  example 'end_tags raises an error on an invalid type' do
+    expect{ described_class.end_tags = 'foo' }.to raise_error(ArgumentTypeError)
+  end
+
+  example 'with attributes' do
+    html = "<tfoot align='left' char='x'></tfoot>"
+    @tfoot.align = 'left'
+    @tfoot.char = 'x'
+    expect(@tfoot.html.gsub(/\s{2,}|\n/, '')).to eq(html)
+  end
+
+  example 'push single row' do
+    html = '<tfoot><tr><td>test</td></tr></tfoot>'
+    @tfoot.push(HTML::Table::Row.new{ |r| r.content = 'test' })
+    expect(@tfoot.html.gsub(/\s{2,}|\n/, '')).to eq(html)
+  end
+
+  example 'push multiple rows' do
+    html = '<tfoot><tr><td>test</td></tr><tr><td>foo</td></tr></tfoot>'
+    r1 = HTML::Table::Row.new{ |r| r.content = 'test' }
+    r2 = HTML::Table::Row.new{ |r| r.content = 'foo' }
+    @tfoot.push r1, r2
+    expect(@tfoot.html.gsub(/\s{2,}|\n/, '')).to eq(html)
+  end
+
+  example 'add content directly' do
+    html = '<tfoot><tr><td>hello</td><td>world</td></tr></tfoot>'
+    @tfoot.content = 'hello', 'world'
+    expect(@tfoot.html.gsub(/\s{2,}|\n+/, '')).to eq(html)
+  end
+
+  example 'add content in constructor' do
+    html = '<tfoot><tr><td>hello</td><td>world</td></tr></tfoot>'
+    described_class.instance_variable_set(:@instance, nil)
+    @tfoot = described_class.create(%w[hello world])
+    expect(@tfoot.html.gsub(/\s{2,}|\n+/, '')).to eq(html)
+  end
+
+  example 'configure column' do
+    html = "<tfoot><tr><td>hello</td><td abbr='test' width=3 nowrap>world"
+    html += '</td></tr></tfoot>'
+    @tfoot.content = 'hello', 'world'
+    @tfoot.configure(0, 1) do |data|
+      data.abbr   = 'test'
+      data.width  = 3
+      data.nowrap = true
+    end
+    expect(@tfoot.html.gsub(/\s{2,}|\n+/, '')).to eq(html)
+  end
+
+  # rubocop:disable RSpec/IdenticalEqualityAssertion
+  example 'new not allowed' do
+    expect{ described_class.new }.to raise_error(NoMethodError)
+  end
+
+  example 'additional calls to constructor do nothing since class is a singleton' do
+    expect(described_class.create).to eq(described_class.create)
+    expect(described_class.instance).to eq(described_class.instance)
+    expect(described_class.instance.object_id).to eq(described_class.instance.object_id)
+    expect(described_class.create.object_id).to eq(described_class.create.object_id)
+  end
+  # rubocop:enable RSpec/IdenticalEqualityAssertion
+end

data/spec/head_spec.rb

@@ -0,0 +1,116 @@
+###############################################################################
+# head_spec.rb
+#
+# Test suite for the described_class class. The Table::Head class is a singleton
+# class, so we have to take extra measures to ensure that a fresh instance
+# is created between tests.
+###############################################################################
+require 'rspec'
+require 'html/table'
+
+RSpec.describe HTML::Table::Head do
+  before do
+    @thead = described_class.create
+  end
+
+  after do
+    described_class.instance_variable_set(:@instance, nil)
+  end
+
+  example 'constructor' do
+    expect{ described_class.create }.not_to raise_error
+  end
+
+  example 'constructor with string' do
+    expect{ described_class.create('foo') }.not_to raise_error
+  end
+
+  example 'constructor with numeric' do
+    expect{ described_class.create(1) }.not_to raise_error
+  end
+
+  example 'constructor with arrays' do
+    expect{ described_class.create(%w[foo bar baz]) }.not_to raise_error
+    expect{ described_class.create([1, 2, 3]) }.not_to raise_error
+    expect{ described_class.create([[1, 2, 3], %w[foo bar]]) }.not_to raise_error
+  end
+
+  example 'basic' do
+    html = '<thead></thead>'
+    expect(@thead.html.gsub(/\s{2,}|\n/, '')).to eq(html)
+  end
+
+  example 'end_tags? basic functionality' do
+    expect(described_class).to respond_to(:end_tags?)
+    expect(described_class.end_tags?).to be(true)
+    expect{ described_class.end_tags? }.not_to raise_error
+  end
+
+  example 'end_tags= basic functionality' do
+    expect(described_class).to respond_to(:end_tags=)
+    expect{ described_class.end_tags = true }.not_to raise_error
+  end
+
+  example 'end_tags= does not allow invalid types' do
+    expect{ described_class.end_tags = 'foo' }.to raise_error(ArgumentTypeError)
+  end
+
+  example 'with attributes' do
+    html = "<thead align='left' char='x'></thead>"
+    @thead.align = 'left'
+    @thead.char = 'x'
+    expect(@thead.html.gsub(/\s{2,}|\n/, '')).to eq(html)
+  end
+
+  example 'push single row' do
+    html = '<thead><tr><td>test</td></tr></thead>'
+    @thead.push(HTML::Table::Row.new{ |r| r.content = 'test' })
+    expect(@thead.html.gsub(/\s{2,}|\n/, '')).to eq(html)
+  end
+
+  example 'push multiple rows' do
+    html = '<thead><tr><td>test</td></tr><tr><td>foo</td></tr></thead>'
+    r1 = HTML::Table::Row.new('test')
+    r2 = HTML::Table::Row.new('foo')
+    @thead.push(r1, r2)
+    expect(@thead.html.gsub(/\s{2,}|\n/, '')).to eq(html)
+  end
+
+  example 'add content directly' do
+    html = '<thead><tr><td>hello</td><td>world</td></tr></thead>'
+    @thead.content = 'hello', 'world'
+    expect(@thead.html.gsub(/\s{2,}|\n+/, '')).to eq(html)
+  end
+
+  example 'add content in constructor' do
+    html = '<thead><tr><td>hello</td><td>world</td></tr></thead>'
+    described_class.instance_variable_set(:@instance, nil)
+    @thead = described_class.create(%w[hello world])
+    expect(@thead.html.gsub(/\s{2,}|\n+/, '')).to eq(html)
+  end
+
+  example 'configure column' do
+    html = "<thead><tr><td>hello</td><td abbr='test' width=3 nowrap>world"
+    html += '</td></tr></thead>'
+    @thead.content = 'hello', 'world'
+    @thead.configure(0, 1) do |d|
+      d.abbr = 'test'
+      d.width = 3
+      d.nowrap = true
+    end
+    expect(@thead.html.gsub(/\s{2,}|\n+/, '')).to eq(html)
+  end
+
+  # rubocop:disable RSpec/IdenticalEqualityAssertion
+  example 'new not allowed' do
+    expect{ described_class.new }.to raise_error(NoMethodError)
+  end
+
+  example 'additional calls to constructor do nothing since class is a singleton' do
+    expect(described_class.create).to eq(described_class.create)
+    expect(described_class.instance).to eq(described_class.instance)
+    expect(described_class.instance.object_id).to eq(described_class.instance.object_id)
+    expect(described_class.create.object_id).to eq(described_class.create.object_id)
+  end
+  # rubocop:enable RSpec/IdenticalEqualityAssertion
+end