html-table 1.5.2 → 1.7.0

data/spec/head_spec.rb

@@ -0,0 +1,101 @@
+###############################################################################
+# 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'
+
+#####################################################################
+# Ensure that a fresh instance of described_class is used between tests
+# by calling 'refresh' in the 'teardown' method.
+#####################################################################
+class HTML::Table::Head
+  private
+  def refresh
+    @@head = nil
+  end
+end
+
+RSpec.describe HTML::Table::Head do
+  before do
+    @table = HTML::Table.new
+    @thead = described_class.create
+  end
+
+  example "constructor" do
+    expect{ described_class.create }.not_to raise_error
+    expect{ described_class.create("foo") }.not_to raise_error
+    expect{ described_class.create(1) }.not_to raise_error
+    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],["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" do
+    expect(described_class).to respond_to(:end_tags?)
+    expect(described_class).to respond_to(:end_tags=)
+    expect{ described_class.end_tags? }.not_to raise_error
+    expect{ described_class.end_tags = true }.not_to raise_error
+    expect{ described_class.end_tags = "foo" }.to raise_error(HTML::Mixin::StrongTyping::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>"
+    @thead.send(:refresh)
+    @thead = described_class.create(["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){ |d|
+      d.abbr = 'test'
+      d.width = 3
+      d.nowrap = true
+    }
+    expect(@thead.html.gsub(/\s{2,}|\n+/, '')).to eq(html)
+  end
+
+  after do
+    @table = nil
+    @thead.send(:refresh)
+    @thead = nil
+  end
+end

data/spec/header_spec.rb

@@ -0,0 +1,72 @@
+#####################################################
+# header_spec.rb
+#
+# Test suite for the HTML::Table::Row::Header class.
+#####################################################
+require 'rspec'
+require 'html/table'
+
+RSpec.describe HTML::Table::Row::Header do
+  before do
+    @theader = described_class.new
+  end
+
+  example "basic" do
+    html = "<th></th>"
+    expect(@theader.html.gsub(/\s+/, '')).to eq(html)
+  end
+
+  example "constructor" do
+    expect{ described_class.new }.not_to raise_error
+    expect{ described_class.new("foo") }.not_to raise_error
+    expect{ described_class.new(1) }.not_to raise_error
+    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],["foo","bar"]]) }.not_to raise_error
+  end
+
+  example "with_attributes" do
+    html = "<th align='left' colspan=3 nowrap></th>"
+    @theader.align = 'left'
+    @theader.colspan = 3
+    @theader.nowrap = true
+    expect(@theader.html.gsub(/\s{2,}|\n+/, '')).to eq(html)
+  end
+
+  example "configure_not_allowed" do
+    expect{ @theader.configure }.to raise_error(NoMethodError)
+  end
+
+  example "add_content" do
+    html = "<th>hello world</th>"
+    @theader.content = "hello world"
+    expect(@theader.html.gsub(/\s{2,}/, '')).to eq(html)
+  end
+
+  example "add_multiple_content_items" do
+    html = "<th>hello world</th>"
+    @theader.content = "hello"," world"
+    expect(@theader.html.gsub(/\s{2,}/, '')).to eq(html)
+  end
+
+  example "add_content_in_constructor" do
+    html = "<th>hello world</th>"
+    @theader = described_class.new("hello world")
+    expect(@theader.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" do
+    expect(described_class).to respond_to(:end_tags?)
+    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/html_handler_spec.rb

@@ -0,0 +1,32 @@
+############################################################################
+# html_handler_spec.rb
+#
+# Test suite for the HtmlHandler module. For these tests, we'll use an
+# instance of the Table class where the module has been mixed in.
+############################################################################
+require 'rspec'
+require 'html/table'
+
+RSpec.describe HTML::Mixin::HtmlHandler do
+  before do
+    @table = HTML::Table.new(["foo",1,"bar"])
+  end
+
+  example "html" do
+    expect(@table).to respond_to(:html)
+    expect{ @table.html }.not_to raise_error
+    expect{ @table.html = "foo" }.to raise_error(NoMethodError)
+    expect( @table.html).to be_kind_of(String)
+    expect( @table.html.length > 0).to eq(true)
+  end
+
+  example "modify_html" do
+    expect{ @table.send(:modify_html) }.to raise_error(ArgumentError)
+    expect{ @table.send(:modify_html,"nowrap") }.not_to raise_error
+    expect{ @table.send(:modify_html,"align","top") }.not_to raise_error
+    expect{
+      @table.send(:modify_html,"align","top")
+      @table.send(:modify_html,"align","top")
+    }.not_to raise_error
+  end
+end

data/spec/row_spec.rb

@@ -0,0 +1,136 @@
+############################################
+# row_spec.rb
+#
+# Specs for the Table::Row class.
+############################################
+require 'rspec'
+require 'html/table'
+include HTML
+
+RSpec.describe HTML::Table::Row do
+  before do
+    @trow = described_class.new
+  end
+
+  example "constructor" do
+    expect{ Table::Row.new }.not_to raise_error
+    expect{ Table::Row.new("foo") }.not_to raise_error
+    expect{ Table::Row.new(1) }.not_to raise_error
+    expect{ Table::Row.new([1,2,3]) }.not_to raise_error
+    expect{ Table::Row.new([[1,2,3],["foo","bar"]]) }.not_to raise_error
+  end
+
+  example "basic" do
+    html = "<tr></tr>"
+    expect(@trow.html.gsub(/\s+/, '')).to eq(html)
+  end
+
+  example "header" do
+    expect(@trow).to respond_to(:header?)
+    expect(@trow).to respond_to(:header=)
+    expect{ @trow.header? }.not_to raise_error
+    expect{ @trow.header = true }.not_to raise_error
+  end
+
+  example "with_attributes" do
+    html = "<tr align='center'></tr>"
+    @trow.align = "center"
+    expect(@trow.html.gsub(/\s{2,}|\n+/, '')).to eq(html)
+  end
+
+  example "index_assignment_constraints" do
+    expect{ @trow[0] = "foo" }.to raise_error(ArgumentTypeError)
+    expect{ @trow[0] = 1 }.to raise_error(ArgumentTypeError)
+    expect{ @trow[0] = Table::Caption.new }.to raise_error(ArgumentTypeError)
+    expect{ @trow[0] = Table::Row::Data.new }.not_to raise_error
+    expect{ @trow[0] = Table::Row::Header.new }.not_to raise_error
+  end
+
+  example "push_constraints" do
+    expect{ @trow.push(Table::Caption.new) }.to raise_error(ArgumentTypeError)
+    expect{ @trow.push(nil) }.to raise_error(ArgumentTypeError)
+    expect{ @trow.push("test") }.not_to raise_error
+    expect{ @trow.push(7) }.not_to raise_error
+    expect{ @trow.push(Table::Row::Data.new) }.not_to raise_error
+    expect{ @trow.push(Table::Row::Header.new) }.not_to raise_error
+  end
+
+  example "double_arrow_constraints" do
+    expect{ @trow << Table::Caption.new }.to raise_error(ArgumentTypeError)
+    expect{ @trow << "test" }.not_to raise_error
+    expect{ @trow << "test" << "foo" }.not_to raise_error
+    expect{ @trow << Table::Row::Data.new }.not_to raise_error
+    expect{ @trow << Table::Row::Header.new }.not_to raise_error
+  end
+
+  example "header_in_constructor" do
+    expect{ @trow = Table::Row.new('test', true) }.not_to raise_error
+    html = "<tr><th>test</th></tr>"
+    expect(@trow.html.gsub(/\s+/, '')).to eq(html)
+  end
+
+  example "push_single_data_element" do
+    html = "<tr><td>hello</td></tr>"
+    @trow.push Table::Row::Data.new{ |d| d.content = "hello" }
+    expect(@trow.html.gsub(/\s{2,}|\n+/, '')).to eq(html)
+  end
+
+  example "push_multiple_data_element" do
+    html = "<tr><td>hello</td><td>world</td></tr>"
+    d1 = Table::Row::Data.new{ |d| d.content = "hello" }
+    d2 = Table::Row::Data.new{ |d| d.content = "world" }
+    @trow.push d1, d2
+    expect(@trow.html.gsub(/\s{2,}|\n+/, '')).to eq(html)
+  end
+
+  example "add_content_directly" do
+    html = "<tr><td>hello</td><td>world</td></tr>"
+    @trow.content = "hello","world"
+    expect(@trow.html.gsub(/\s{2,}|\n+/, '')).to eq(html)
+  end
+
+  example "add_content_in_constructor" do
+    html = "<tr><td>hello</td><td>world</td></tr>"
+    @trow = Table::Row.new(%w/hello world/)
+    expect(@trow.html.gsub(/\s{2,}|\n+/, '')).to eq(html)
+  end
+
+  example "configure_column" do
+    html = "<tr><td>hello</td><td abbr='test' width=3 nowrap>world</td></tr>"
+    @trow.content = "hello","world"
+    @trow.configure(1){ |d|
+      d.abbr = 'test'
+      d.width = 3
+      d.nowrap = true
+    }
+    expect(@trow.html.gsub(/\s{2,}|\n+/, '')).to eq(html)
+  end
+
+  example "unshift_constraints" do
+    expect{ @trow.unshift(Table::Caption.new) }.to raise_error(ArgumentTypeError)
+    expect{ @trow.unshift(nil) }.to raise_error(ArgumentTypeError)
+    expect{ @trow.unshift("test") }.not_to raise_error
+    expect{ @trow.unshift(7) }.not_to raise_error
+    expect{ @trow.unshift(Table::Row::Data.new) }.not_to raise_error
+    expect{ @trow.unshift(Table::Row::Header.new) }.not_to raise_error
+  end
+
+  example "configure_error" do
+    expect{ @trow.configure(0,0){ }.to raise_error(ArgumentError) }
+  end
+
+  example "indent_level" do
+    expect(Table::Row).to respond_to(:indent_level)
+    expect(Table::Row).to respond_to(:indent_level=)
+    expect{ Table::Row.indent_level = "foo" }.to raise_error(ArgumentTypeError)
+    expect{ Table::Row.indent_level = 3 }.not_to raise_error
+  end
+
+  example "end_tags" do
+    expect(Table::Row).to respond_to(:end_tags?)
+    expect(Table::Row).to respond_to(:end_tags=)
+    expect{ Table::Row.end_tags = "foo" }.to raise_error(ArgumentTypeError)
+    expect{ Table::Row.end_tags = 1 }.to raise_error(ArgumentTypeError)
+    expect{ Table::Row.end_tags = true }.not_to raise_error
+  end
+end

data/spec/table_spec.rb

@@ -0,0 +1,152 @@
+#######################################################################
+# table_spec.rb
+#
+# Specs for the HTML::Table class. These specs should be run via the
+# 'rake spec' or 'rake spec:table' task.
+#######################################################################
+require 'rspec'
+require 'html/table'
+
+RSpec.describe HTML::Table do
+  before do
+    @table = described_class.new
+  end
+
+  example "version" do
+    expect(described_class::VERSION).to eq('1.7.0')
+    expect(described_class::VERSION).to be_frozen
+  end
+
+  example "constructor" do
+    expect{ described_class.new }.not_to raise_error
+    expect{ described_class.new('foo') }.not_to raise_error
+    expect{ described_class.new(1) }.not_to raise_error
+    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],['foo','bar']]) }.not_to raise_error
+  end
+
+  example "constructor_with_attributes" do
+    expect{ described_class.new(%w[foo bar baz], :border => 1) }.not_to raise_error
+  end
+
+  example "html_case" do
+    expect(described_class).to respond_to(:html_case)
+    expect(described_class).to respond_to(:html_case=)
+    expect{ described_class.html_case = 'upper' }.not_to raise_error
+    expect{ described_class.html_case = 'lower' }.not_to raise_error
+    expect{ described_class.html_case = 'foo' }.to raise_error(ArgumentError)
+    expect{ described_class.html_case = 7 }.to raise_error(ArgumentTypeError)
+  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 = 0 }.not_to raise_error
+    expect{ described_class.indent_level = 'foo' }.to raise_error(ArgumentTypeError)
+  end
+
+  example "index" do
+    expect{ @table[0] = 'foo' }.to raise_error(ArgumentTypeError)
+  end
+
+  example "caption_index_constraints" do
+    expect{ @table[0] = described_class::Caption.new }.not_to raise_error
+    expect{ @table[1] = described_class::Caption.new }.to raise_error(ArgumentError)
+  end
+
+  example "head_index_constraints" do
+    expect{ @table[0] = described_class::Head.create }.not_to raise_error
+    expect{ @table[1] = described_class::Head.create }.to raise_error(ArgumentError)
+    expect{ @table[2] = described_class::Head.create }.to raise_error(ArgumentError)
+  end
+
+  example "foot_index_constraints" do
+    expect {
+      @table[0] = described_class::Caption.new
+      @table[-1] = described_class::Foot.create
+    }.not_to raise_error
+    expect{ @table[0] = described_class::Foot.create }.to raise_error(ArgumentError)
+  end
+
+  example "unshift_constraints" do
+    expect{ @table.unshift described_class::Row.new }.not_to raise_error
+    expect{ @table.unshift described_class::Row::Data.new }.to raise_error(ArgumentTypeError)
+    expect{ @table.unshift 'foo' }.to raise_error(ArgumentTypeError)
+  end
+
+  example "push_constraints" do
+    expect{ @table.push described_class::Row.new }.not_to raise_error
+    expect{ @table.push('foo') }.to raise_error(ArgumentTypeError)
+    expect{ @table.push(7) }.to raise_error(ArgumentTypeError)
+    expect{ @table.push(nil) }.to raise_error(ArgumentTypeError)
+  end
+
+  example "double_arrow_constraints" do
+    expect{ @table << HTML::Table::Row.new }.not_to raise_error
+    expect{ @table << HTML::Table::Row.new << HTML::Table::Row.new }.not_to raise_error
+    expect{ @table << 'foo' }.to raise_error(ArgumentTypeError)
+    expect{ @table << 7 }.to raise_error(ArgumentTypeError)
+    expect{ @table << nil }.to raise_error(ArgumentTypeError)
+  end
+
+  example "basic" do
+    html = "<table>\n</table>"
+    expect(@table.html).to eq(html)
+  end
+
+  example "with_attributes" do
+    html = "<table border=1 align='left' nowrap>\n</table>"
+    @table.border = 1
+    @table.align = 'left'
+    @table.nowrap = true
+    expect(@table.html).to eq(html)
+  end
+
+  example "add_row_push" do
+    html = '<table><tr></tr></table>'
+    @table.push(described_class::Row.new)
+    expect(@table.html.gsub(/\s+/, '')).to eq(html)
+  end
+
+  example "add_row_by_index" do
+    html = '<table><tr></tr></table>'
+    @table[0] = described_class::Row.new
+    expect(@table.html.gsub(/\s+/, '')).to eq(html)
+  end
+
+  example "add_multiple_rows" do
+    html = '<table><tr></tr><tr></tr></table>'
+    @table.push HTML::Table::Row.new, HTML::Table::Row.new
+    expect(@table.html.gsub(/\s+/, '')).to eq(html)
+  end
+
+  example "add_single_data_element" do
+    html = '<table><tr><td>hello</td></tr></table>'
+    @table.content = 'hello'
+    expect(@table.html.gsub(/\s+/, '')).to eq(html)
+  end
+
+  example "add_multiple_data_elements" do
+    html = '<table><tr><td>hello</td></tr><tr><td>world</td></tr></table>'
+    @table.content = 'hello','world'
+    expect(@table.html.gsub(/\s+/, '')).to eq(html)
+  end
+
+  example "configure_row" do
+    html = "<table><tr align='center'><td bgcolor='red'>hello</td></tr>"
+    html << '</table>'
+    @table.push HTML::Table::Row::Data.new{ |d| d.content = 'hello' }
+    @table.configure(0){ |t| t.align = 'center' }
+    @table.configure(0,0){ |d| d.bgcolor = 'red' }
+    expect(@table.html.gsub(/\s{2,}|\n+/, '')).to eq(html)
+  end
+
+  example "global_end_tags" do
+    expect(described_class).to respond_to(:global_end_tags?)
+    expect(described_class).to respond_to(:global_end_tags=)
+    expect{ described_class.global_end_tags = false }.not_to raise_error
+    expect{ described_class.global_end_tags = true }.not_to raise_error
+    expect{ described_class.global_end_tags = 'foo' }.to raise_error(ArgumentTypeError)
+  end
+end