cyberfox-gchart 0.5.2 → 0.5.4

data/spec/gchart/axis/bottom_axis_spec.rb

@@ -0,0 +1,13 @@
+require File.expand_path("#{File.dirname(__FILE__)}/../../helper")
+
+describe GChart::BottomAxis do
+  before(:each) { @axis = GChart::Axis.create(:bottom) }
+
+  it "describes its axis_type_label as 'x'" do
+    @axis.axis_type_label.should == 'x'
+  end
+
+  it "describes its range_marker_type_label as being vertical ('R')" do
+    @axis.range_marker_type_label.should == 'R'
+  end
+end

data/spec/gchart/axis/left_axis_spec.rb

@@ -0,0 +1,13 @@
+require File.expand_path("#{File.dirname(__FILE__)}/../../helper")
+
+describe GChart::LeftAxis do
+  before(:each) { @axis = GChart::Axis.create(:left) }
+
+  it "describes its axis_type_label as 'y'" do
+    @axis.axis_type_label.should == 'y'
+  end
+
+  it "describes its range_marker_type_label as being horizontal ('r')" do
+    @axis.range_marker_type_label.should == 'r'
+  end
+end

data/spec/gchart/axis/right_axis_spec.rb

@@ -0,0 +1,13 @@
+require File.expand_path("#{File.dirname(__FILE__)}/../../helper")
+
+describe GChart::RightAxis do
+  before(:each) { @axis = GChart::Axis.create(:right) }
+
+  it "describes its axis_type_label as 'r'" do
+    @axis.axis_type_label.should == 'r'
+  end
+
+  it "describes its range_marker_type_label as being horizontal ('r')" do
+    @axis.range_marker_type_label.should == 'r'
+  end
+end

data/spec/gchart/axis/top_axis_spec.rb

@@ -0,0 +1,13 @@
+require File.expand_path("#{File.dirname(__FILE__)}/../../helper")
+
+describe GChart::TopAxis do
+  before(:each) { @axis = GChart::Axis.create(:top) }
+
+  it "describes its axis_type_label as 't'" do
+    @axis.axis_type_label.should == 't'
+  end
+
+  it "describes its range_marker_type_label as being vertical ('R')" do
+    @axis.range_marker_type_label.should == 'R'
+  end
+end

data/spec/gchart/axis_spec.rb

@@ -0,0 +1,216 @@
+require File.expand_path("#{File.dirname(__FILE__)}/../helper")
+
+describe GChart::Axis do
+  before(:each) { @axis = GChart::Axis.create(:bottom) }
+
+  it "blows up when you try to create it with new" do
+    lambda { GChart::Axis.new }.should raise_error(NoMethodError)
+  end
+
+  describe ".create" do
+    {
+      :top    => GChart::TopAxis,    :right => GChart::RightAxis,
+      :bottom => GChart::BottomAxis, :left  => GChart::LeftAxis
+    }.each do |axis_type, axis_class|
+      it "can create a #{axis_class}" do
+        axis = GChart::Axis.create(axis_type)
+        axis.should be_instance_of(axis_class)
+      end
+    end
+
+    it "explodes with an invalid axis_type" do
+      lambda { GChart::Axis.create(:middle) }.should raise_error(ArgumentError)
+    end
+  end
+
+  describe ".validate!" do
+    it "will validate all axis attributes as working with each other by not blowing up" do
+      @axis.validate!
+    end
+  end
+
+  describe ".labels" do
+    it "will contain an array of labels" do
+      @axis.labels = %w(Mon Tue Wed Thu Fri)
+    end
+  end
+
+  describe ".label_positions" do
+    it "will contain an array of label_positions" do
+      @axis.label_positions = [0, 25, 50, 75, 100]
+    end
+  end
+
+  describe ".validate!" do
+    it "will blow up if there are labels and label_positions, but their sizes don't match" do
+      @axis.labels = %w(Mon Tue Wed Thu Fri)
+      @axis.label_positions = [0, 25, 50]
+      lambda { @axis.validate! }.should raise_error(ArgumentError)
+    end
+
+    it "will be happy when there is 1 label_position for every label" do
+      @axis.labels = %w(Mon Tue Wed Thu Fri)
+      @axis.label_positions = [0, 25, 50, 75, 100]
+      @axis.validate!
+    end
+
+    it "will be happy if there are labels but no label_positions" do
+      @axis.labels = %w(Mon Tue Wed Thu Fri)
+      @axis.validate!
+    end
+
+    it "will be happy if there are label_positions but no labels" do
+      @axis.label_positions = [0, 25, 50, 75, 100]
+      @axis.validate!
+    end
+
+    it "will blow up if label_positions contains non-numeric values" do
+      @axis.label_positions = %w(a e h l)
+      lambda { @axis.validate! }.should raise_error(ArgumentError)
+    end
+  end
+
+  describe ".range" do
+    it "will contain a range from which to derive labels" do
+      @axis.range = 0..1300
+    end
+  end
+
+  describe ".validate!" do
+    it "will blow up if range() does not contain a range" do
+      @axis.range = [0, 50, 100]
+      lambda { @axis.validate! }.should raise_error(ArgumentError)
+    end
+
+    it "will blow up if range() contains a range of non-numeric values" do
+      @axis.range = 'a'..'z'
+      lambda { @axis.validate! }.should raise_error(ArgumentError)
+    end
+
+    it "will be content if a range is used in combination with labels" do
+      @axis.range = 0..100
+      @axis.labels = [25, 50, 75]
+      @axis.validate!
+    end
+
+    it "will be content if a range is used in combination with labels and label_positions both" do
+      @axis.range = 0..100
+      @axis.labels = %w(25 50 75)
+      @axis.label_positions = [25, 50, 75]
+      @axis.validate!
+    end
+  end
+
+  describe ".text_color" do
+    it "will contain the color in which to draw axis labelings" do
+      @axis.text_color = :green
+    end
+  end
+
+  describe ".font_size" do
+    it "will contain the font_size for the labels on the axis" do
+      @axis.font_size = 12
+    end
+  end
+
+  describe ".text_alignment" do
+    it "will contain the information on how to align labels on the axis" do
+      @axis.text_alignment = :right
+    end
+  end
+
+  describe ".validate!" do
+    it "will be happy if the text_color is a valid color" do
+      @axis.text_color = 'ff0199aa'
+      @axis.validate!
+    end
+
+    it "will blow up if the text_color is not a valid color" do
+      @axis.text_color = :rgb_freakout
+      lambda { @axis.validate! }.should raise_error(ArgumentError)
+    end
+
+    it "will be happy if font_size is specified along with text_color" do
+      @axis.text_color = 'bbb'
+      @axis.font_size = 12
+      @axis.validate!
+    end
+
+    it "will blow up if font_size is given without a corresponding text_color" do
+      @axis.font_size = 12
+      lambda { @axis.validate! }.should raise_error(ArgumentError)
+    end
+
+    it "will blow up if the text_color is valid but the font_size is not numeric" do
+      @axis.text_color = :black
+      @axis.font_size = "13.5"
+      lambda { @axis.validate! }.should raise_error(ArgumentError)
+    end
+
+    it "will be happy if text_alignment is specified with both font_size and text_color" do
+      @axis.text_alignment = :center
+      @axis.font_size = 11.5
+      @axis.text_color = :cyan
+      @axis.validate!
+    end
+
+    it "will blow up if text_alignment is given without both font_size and text_color" do
+      @axis.text_alignment = :left
+      lambda { @axis.validate! }.should raise_error(ArgumentError)
+    end
+
+    it "will blow up if text_alignment is given with a valid font_size but no text_color" do
+      @axis.text_alignment = :left
+      @axis.font_size = 10
+      lambda { @axis.validate! }.should raise_error(ArgumentError)
+    end
+
+    it "will blow up if text_alignment is given with a valid text_color but no font_size" do
+      @axis.text_alignment = :left
+      @axis.text_color = :magenta
+      lambda { @axis.validate! }.should raise_error(ArgumentError)
+    end
+
+    it "will blow up if font_size and text_color are valid, but text_alignment isn't in TEXT_ALIGNMENT table" do
+      @axis.text_color = :magenta
+      @axis.font_size = 12
+      @axis.text_alignment = :upper
+      lambda { @axis.validate! }.should raise_error(ArgumentError)
+    end
+  end
+
+  describe ".range_markers" do
+    it "will contain an array of ranges of markers and their colors" do
+      @axis.range_markers = [[45..70, :magenta], [75..90, :pink]]
+    end
+  end
+
+  describe ".validate!" do
+    it "be happy when range_markers contains an array of 2-element subarrays of ranges and colors" do
+      @axis.range_markers = [[45..70, :magenta], [75..90, :pink]]
+      @axis.validate!
+    end
+
+    it "will bomb if any element in range_markers is not an array of 2 elements" do
+      @axis.range_markers = ["string", :thistle]
+      lambda { @axis.validate! }.should raise_error(ArgumentError)
+
+      @axis.range_markers = [[:one, :two, :three], [:un, :deux, :trois]]
+      lambda { @axis.validate! }.should raise_error(ArgumentError)
+    end
+
+    it "will bomb if the 1st element in any of the 2-element arrays in range_markers is not a numeric range" do
+      @axis.range_markers = [[75, :blue], [75..100, :green]]
+      lambda { @axis.validate! }.should raise_error(ArgumentError)
+
+      @axis.range_markers = [['a'..'z', :blue], [75..10, :green]]
+      lambda { @axis.validate! }.should raise_error(ArgumentError)
+    end
+
+    it "will bomb if the 2nd element in any of the 2-element arrays in range_markers is not a valid color" do
+      @axis.range_markers = [[75..90, :blue], [75..100, :cyantiago]]
+      lambda { @axis.validate! }.should raise_error(ArgumentError)
+    end
+  end
+
+end

data/spec/gchart/base_spec.rb

@@ -98,6 +98,27 @@ describe GChart::Base, "#query_params" do
     @chart.query_params["chtt"].should == "foo|bar"
   end
   
+  it "contains the chart's data colors" do
+    @chart.colors = ["cccccc", "eeeeee", :salmon3, "49d", :red]
+    @chart.query_params["chco"].should == "cccccc,eeeeee,cd7054,4499dd,ff0000"
+
+    @chart.colors = []
+    @chart.query_params["chco"].should be_nil
+  end
+
+  it "contains the chart's background colors" do
+    @chart.query_params["chf"].should be_nil
+
+    @chart.entire_background = :red
+    @chart.query_params["chf"].should == "bg,s,ff0000"
+
+    @chart.chart_background = "704"
+    @chart.query_params["chf"].should == "bg,s,ff0000|c,s,770044"
+
+    @chart.entire_background = nil
+    @chart.query_params["chf"].should == "c,s,770044"
+  end
+
   it "contains the chart's colors" do
     @chart.colors = ["cccccc", "eeeeee"]
     @chart.query_params["chco"].should == "cccccc,eeeeee"
@@ -154,3 +175,89 @@ describe GChart::Base, "#write" do
     result.should == "PAYLOAD"
   end
 end
+
+describe GChart::Base, "#axis" do
+  before(:each) do
+    @chart = GChart::Line.new
+    @axis = @chart.axis(:bottom)
+  end
+
+  it "instantiates a new GChart::Axis of the proper axis_type" do
+    chart = GChart::Line.new
+    axis  = chart.axis(:bottom)
+    axis.is_a?(GChart::BottomAxis).should == true
+  end
+
+  it "pushes the new axis to the chart's set of axes" do
+    chart = GChart::Line.new
+    axis  = chart.axis(:bottom)
+    chart.axes.first.should == axis
+  end
+
+  [GChart::Line, GChart::Bar, GChart::Scatter].each do |chart_type|
+    it "renders axis information when chart axes are present and chart is of proper type" do
+      chart = chart_type.new
+      axis  = chart.axis(:left)
+      chart.to_url.should =~ /chxt/
+    end
+  end
+
+  [GChart::Pie3D, GChart::Pie, GChart::Venn, GChart::XYLine].each do |chart_type|
+    it "should not render axis information when chart axes are present but chart is not of proper type" do
+      chart = chart_type.new
+      axis  = chart.axis(:left)
+      chart.to_url.should_not =~ /chxt/
+    end
+  end
+end
+
+describe GChart::Base, "#entire_background" do
+  it "sets the background color for the entire chart" do
+    chart = GChart.line
+    chart.entire_background = :blue
+  end
+end
+
+describe GChart::Base, "#chart_background" do
+  it "sets the background color for just the chart area of the chart image" do
+    chart = GChart.bar
+    chart.chart_background = "876"
+  end
+end
+
+describe GChart::Base, "#render_backgrounds" do
+  before(:each) do
+    @chart = GChart::Line.new
+  end
+
+  it "verifies that background colors are valid colors" do
+    @chart.chart_background = :cyan
+    @chart.to_url
+
+    @chart.entire_background = 'f37'
+    @chart.to_url
+  end
+
+  it "blows up if either of the background colors are invalid" do
+    @chart.chart_background = :redneck_skin
+    lambda { @chart.to_url }.should raise_error(ArgumentError)
+
+    @chart.chart_background = nil
+    @chart.entire_background = 'f375'
+    lambda { @chart.to_url }.should raise_error(ArgumentError)
+  end
+
+  it "renders chart background information correctly" do
+    @chart.to_url.should_not =~ /chf=/
+
+    @chart.chart_background = 'f3A'
+    @chart.to_url.should =~ /chf=c,s,ff33AA/
+
+    @chart.entire_background = :yellow
+    @chart.to_url.should =~ /chf=bg,s,ffff00%7Cc,s,ff33AA/
+
+    @chart.chart_background = nil
+    @chart.to_url.should_not =~ /chf=bg,s,ffff00%7Cc,s,ff33AA/
+    @chart.to_url.should =~ /chf=bg,s,ffff00/
+  end
+end

data/spec/gchart/colors_spec.rb

@@ -0,0 +1,79 @@
+require File.expand_path("#{File.dirname(__FILE__)}/../helper")
+
+describe GChart, ".expand_color" do
+  { "693" => "669933", "fff" => "ffffff", "000" => "000000" }.each do |_3_char_color, _6_char_color|
+    it "expands #{_3_char_color} into #{_6_char_color}" do
+      GChart.expand_color(_3_char_color).should == _6_char_color
+    end
+  end
+
+  { :red => "ff0000", :alice_blue => "f0f8ff", :yellow => "ffff00" }.each do |color_symbol, expanded|
+    it "expands #{color_symbol} into #{expanded}" do
+      GChart.expand_color(color_symbol).should == expanded
+    end
+  end
+
+  [ :canary_burnt_sienna, 3, 7.4, ['fff'], {'693' => 'cool'}, nil ].each do |non_color|
+    it "does not expand #{non_color}" do
+      GChart.expand_color(non_color).should == non_color
+    end
+  end
+
+  %w(669933 ffffff 000000).each do |_6_character_color|
+    it "does not expand #{_6_character_color}" do
+      GChart.expand_color(_6_character_color).should == _6_character_color
+    end
+  end
+
+end
+
+describe GChart, ".valid_color?" do
+  it "verifies a 3-hex-character rgb color definition as being valid" do
+    GChart.valid_color?('ffF').should == true
+    GChart.valid_color?('123').should == true
+  end
+
+  it "verifies a 6-hex-character rrggbb color definition as being valid" do
+    GChart.valid_color?('123fFf').should == true
+    GChart.valid_color?('a1B2c3').should == true
+  end
+
+  it "verifies an 8-hex-character rrggbbtt (transparency) color definition as being valid" do
+    GChart.valid_color?('123fffAa').should == true
+    GChart.valid_color?('a1b2c300').should == true
+  end
+
+  it "verifies a COLORS symbol color definition as being valid" do
+    GChart.valid_color?(:red).should == true
+    GChart.valid_color?(:slate_blue4).should == true
+  end
+
+  it "states as being invalid any non-String/non-Symbol" do
+    GChart.valid_color?([:purple]).should == false
+    GChart.valid_color?({:red => true}).should == false
+    GChart.valid_color?(true).should == false
+    GChart.valid_color?(7).should == false
+    GChart.valid_color?(99.99).should == false
+    GChart.valid_color?(Object.new).should == false
+    GChart.valid_color?(GChart.class).should == false
+  end
+
+  it "states as being invalid any String of length not equal to 3, 6 or 8" do
+    GChart.valid_color?('ab').should == false
+    GChart.valid_color?('abcd').should == false
+    GChart.valid_color?('abcde').should == false
+    GChart.valid_color?('abcdef1').should == false
+    GChart.valid_color?('abcdef123').should == false
+  end
+
+  it "states as being invalid any String of length equal to 3, 6 or 8 with non-hex characters" do
+    GChart.valid_color?('efg').should == false
+    GChart.valid_color?('bcdefg').should == false
+    GChart.valid_color?('abcdefZZ').should == false
+  end
+
+  it "states as being invalid any symbol which is not in the COLORS table" do
+    GChart.valid_color?(:awesome_blue).should == false
+    GChart.valid_color?(:burnt_cyborg).should == false
+  end
+end