matta-googlecharts 1.1.0

data/spec/gchart_spec.rb

@@ -0,0 +1,277 @@
+require File.dirname(__FILE__) + '/spec_helper.rb'
+require File.dirname(__FILE__) + '/../lib/gchart'
+
+# Time to add your specs!
+# http://rspec.rubyforge.org/
+describe "generating a default Gchart" do
+  
+  before(:each) do
+    @chart = Gchart.line
+  end
+  
+  it "should include the Google URL" do
+    @chart.include?("http://chart.apis.google.com/chart?").should be_true
+  end
+  
+  it "should have a default size" do
+    @chart.include?('chs=300x200').should be_true
+  end
+  
+  it "should be able to have a custom size" do
+    Gchart.line(:size => '400x600').include?('chs=400x600').should be_true
+    Gchart.line(:width => 400, :height => 600).include?('chs=400x600').should be_true
+  end
+  
+  it "should have a type" do
+    @chart.include?('cht=lc').should be_true
+  end
+  
+  it "should use the simple encoding by default with auto max value" do
+    # 9 is the max value in simple encoding, 26 being our max value the 2nd encoded value should be 9
+    Gchart.line(:data => [0, 26]).include?('chd=s:A9').should be_true
+    Gchart.line(:data => [0, 26], :max_value => 26).should == Gchart.line(:data => [0, 26])
+  end
+  
+  it "should support simple encoding with and without max_value" do
+    Gchart.line(:data => [0, 26], :max_value => 26).include?('chd=s:A9').should be_true
+    Gchart.line(:data => [0, 26], :max_value => false).include?('chd=s:Aa').should be_true
+  end
+  
+  it "should support the extended encoding and encode properly" do
+    Gchart.line(:data => [0, 10], :encoding => 'extended', :max_value => false).include?('chd=e:AA').should be_true
+    Gchart.line(:encoding => 'extended', 
+                :max_value => false,
+                :data => [[0,25,26,51,52,61,62,63], [64,89,90,115,4084]]
+                ).include?('chd=e:AAAZAaAzA0A9A-A.,BABZBaBz.0').should be_true
+  end
+  
+  it "should auto set the max value for extended encoding" do
+    Gchart.line(:data => [0, 25], :encoding => 'extended', :max_value => false).include?('chd=e:AAAZ').should be_true
+    # Extended encoding max value is '..'
+    Gchart.line(:data => [0, 25], :encoding => 'extended').include?('chd=e:AA..').should be_true
+  end
+  
+  it "should be able to have data with text encoding" do
+    Gchart.line(:data => [10, 5.2, 4, 45, 78], :encoding => 'text').include?('chd=t:10,5.2,4,45,78').should be_true
+  end
+  
+  it "should be able to have muliple set of data with text encoding" do
+    Gchart.line(:data => [[10, 5.2, 4, 45, 78], [20, 40, 70, 15, 99]], :encoding => 'text').include?(Gchart.jstize('chd=t:10,5.2,4,45,78|20,40,70,15,99')).should be_true
+  end
+
+  it "should be able to receive a custom param" do
+    Gchart.line(:custom => 'ceci_est_une_pipe').include?('ceci_est_une_pipe').should be_true
+  end
+  
+  it "should be able to set label axis" do
+    Gchart.line(:axis_with_labels => 'x,y,r').include?('chxt=x,y,r').should be_true
+    Gchart.line(:axis_with_labels => ['x','y','r']).include?('chxt=x,y,r').should be_true
+  end
+  
+  it "should be able to have axis labels" do
+   Gchart.line(:axis_labels => ['Jan|July|Jan|July|Jan', '0|100', 'A|B|C', '2005|2006|2007']).include?(Gchart.jstize('chxl=0:|Jan|July|Jan|July|Jan|1:|0|100|2:|A|B|C|3:|2005|2006|2007')).should be_true
+   Gchart.line(:axis_labels => ['Jan|July|Jan|July|Jan']).include?(Gchart.jstize('chxl=0:|Jan|July|Jan|July|Jan')).should be_true
+   Gchart.line(:axis_labels => [['Jan','July','Jan','July','Jan']]).include?(Gchart.jstize('chxl=0:|Jan|July|Jan|July|Jan')).should be_true
+   Gchart.line(:axis_labels => [['Jan','July','Jan','July','Jan'], ['0','100'], ['A','B','C'], ['2005','2006','2007']]).include?(Gchart.jstize('chxl=0:|Jan|July|Jan|July|Jan|1:|0|100|2:|A|B|C|3:|2005|2006|2007')).should be_true
+  end
+  
+end
+
+describe "generating different type of charts" do
+  
+  it "should be able to generate a line chart" do
+    Gchart.line.should be_an_instance_of(String)
+    Gchart.line.include?('cht=lc').should be_true
+  end
+  
+  it "should be able to generate a line xy chart" do
+    Gchart.line_xy.should be_an_instance_of(String)
+    Gchart.line_xy.include?('cht=lxy').should be_true
+  end
+  
+  it "should be able to generate a scatter chart" do
+    Gchart.scatter.should be_an_instance_of(String)
+    Gchart.scatter.include?('cht=s').should be_true
+  end
+  
+  it "should be able to generate a bar chart" do
+    Gchart.bar.should be_an_instance_of(String)
+    Gchart.bar.include?('cht=bvs').should be_true
+  end
+  
+  it "should be able to generate a Venn diagram" do
+    Gchart.venn.should be_an_instance_of(String)
+    Gchart.venn.include?('cht=v').should be_true
+  end
+  
+  it "should be able to generate a Pie Chart" do
+    Gchart.pie.should be_an_instance_of(String)
+    Gchart.pie.include?('cht=p').should be_true
+  end
+  
+  it "should not support other types" do
+    Gchart.sexy.should == "sexy is not a supported chart format, please use one of the following: #{Gchart.supported_types}."
+  end
+  
+end
+
+describe "a bar graph" do
+  
+  it "should have a default vertical orientation" do
+    Gchart.bar.include?('cht=bvs').should be_true
+  end
+  
+  it "should be able to have a different orientation" do
+    Gchart.bar(:orientation => 'vertical').include?('cht=bvs').should be_true
+    Gchart.bar(:orientation => 'v').include?('cht=bvs').should be_true
+    Gchart.bar(:orientation => 'h').include?('cht=bhs').should be_true
+    Gchart.bar(:orientation => 'horizontal').include?('cht=bhs').should be_true
+    Gchart.bar(:horizontal => false).include?('cht=bvs').should be_true
+  end
+  
+  it "should be set to be stacked by default" do
+    Gchart.bar.include?('cht=bvs').should be_true
+  end
+  
+  it "should be able to stacked or grouped" do
+    Gchart.bar(:stacked => true).include?('cht=bvs').should be_true
+    Gchart.bar(:stacked => false).include?('cht=bvg').should be_true
+    Gchart.bar(:grouped => true).include?('cht=bvg').should be_true
+    Gchart.bar(:grouped => false).include?('cht=bvs').should be_true
+  end
+  
+  it "should be able to have different bar colors" do
+    Gchart.bar(:bar_colors => 'efefef,00ffff').include?('chco=').should be_true
+    Gchart.bar(:bar_colors => 'efefef,00ffff').include?('chco=efefef,00ffff').should be_true
+    # alias
+    Gchart.bar(:bar_color => 'efefef').include?('chco=efefef').should be_true
+  end
+  
+  it "should be able to have different bar colors when using an array of colors" do
+    Gchart.bar(:bar_colors => ['efefef','00ffff']).include?('chco=efefef,00ffff').should be_true
+  end
+  
+end
+
+describe "a line chart" do
+  
+  before(:each) do
+    @title = 'Chart Title'
+    @legend = ['first data set label', 'n data set label']
+    @chart = Gchart.line(:title => @title, :legend => @legend)
+  end
+  
+  it 'should be able have a chart title' do
+    @chart.include?("chtt=Chart+Title").should be_true
+  end
+  
+  it "should be able to a custom color and size title" do
+     Gchart.line(:title => @title, :title_color => 'FF0000').include?('chts=FF0000').should be_true
+     Gchart.line(:title => @title, :title_size => '20').include?('chts=454545,20').should be_true
+  end
+  
+  it "should be able to have multiple legends" do
+    @chart.include?(Gchart.jstize("chdl=first+data+set+label|n+data+set+label")).should be_true
+  end
+  
+  it "should be able to have one legend" do
+    chart = Gchart.line(:legend => 'legend label')
+    chart.include?("chdl=legend+label").should be_true
+  end
+  
+  it "should be able to set the background fill" do
+    Gchart.line(:bg => 'efefef').include?("chf=bg,s,efefef").should be_true
+    Gchart.line(:bg => {:color => 'efefef', :type => 'solid'}).include?("chf=bg,s,efefef").should be_true
+    
+    Gchart.line(:bg => {:color => 'efefef', :type => 'gradient'}).include?("chf=bg,lg,0,efefef,0,ffffff,1").should be_true
+    Gchart.line(:bg => {:color => 'efefef,0,ffffff,1', :type => 'gradient'}).include?("chf=bg,lg,0,efefef,0,ffffff,1").should be_true
+    Gchart.line(:bg => {:color => 'efefef', :type => 'gradient', :angle => 90}).include?("chf=bg,lg,90,efefef,0,ffffff,1").should be_true
+    
+    Gchart.line(:bg => {:color => 'efefef', :type => 'stripes'}).include?("chf=bg,ls,90,efefef,0.2,ffffff,0.2").should be_true
+  end
+  
+  it "should be able to set a graph fill" do
+    Gchart.line(:graph_bg => 'efefef').include?("chf=c,s,efefef").should be_true
+    Gchart.line(:graph_bg => {:color => 'efefef', :type => 'solid'}).include?("chf=c,s,efefef").should be_true
+    Gchart.line(:graph_bg => {:color => 'efefef', :type => 'gradient'}).include?("chf=c,lg,0,efefef,0,ffffff,1").should be_true
+    Gchart.line(:graph_bg => {:color => 'efefef,0,ffffff,1', :type => 'gradient'}).include?("chf=c,lg,0,efefef,0,ffffff,1").should be_true
+    Gchart.line(:graph_bg => {:color => 'efefef', :type => 'gradient', :angle => 90}).include?("chf=c,lg,90,efefef,0,ffffff,1").should be_true
+  end
+  
+  it "should be able to set both a graph and a background fill" do
+    Gchart.line(:bg => 'efefef', :graph_bg => '76A4FB').include?("bg,s,efefef").should be_true
+    Gchart.line(:bg => 'efefef', :graph_bg => '76A4FB').include?("c,s,76A4FB").should be_true
+    Gchart.line(:bg => 'efefef', :graph_bg => '76A4FB').include?(Gchart.jstize("chf=c,s,76A4FB|bg,s,efefef")).should be_true
+  end
+  
+  it "should be able to have different line colors" do
+    Gchart.line(:line_colors => 'efefef|00ffff').include?(Gchart.jstize('chco=efefef|00ffff')).should be_true
+     Gchart.line(:line_color => 'efefef|00ffff').include?(Gchart.jstize('chco=efefef|00ffff')).should be_true
+  end
+  
+end
+
+describe "a pie chart" do
+  
+  before(:each) do
+    @title = 'Chart Title'
+    @legend = ['first data set label', 'n data set label']
+    @jstized_legend = Gchart.jstize(@legend.join('|'))
+    @data = [12,8,40,15,5]
+    @chart = Gchart.pie(:title => @title, :legend => @legend, :data => @data)
+  end
+  
+  it "should create a pie" do
+    @chart.include?('cht=p').should be_true
+  end
+  
+  it "should be able to be in 3d" do
+    Gchart.pie_3d(:title => @title, :legend => @legend, :data => @data).include?('cht=p3').should be_true
+  end
+  
+  it "should be able to set labels by using the legend or labesl accessor" do
+    Gchart.pie_3d(:title => @title, :legend => @legend, :data => @data).include?("chl=#{@jstized_legend}").should be_true
+    Gchart.pie_3d(:title => @title, :labels => @legend, :data => @data).include?("chl=#{@jstized_legend}").should be_true
+    Gchart.pie_3d(:title => @title, :labels => @legend, :data => @data).should == Gchart.pie_3d(:title => @title, :legend => @legend, :data => @data)
+  end
+  
+end
+
+describe 'exporting a chart' do
+  
+  it "should be available in the url format by default" do
+    Gchart.line(:data => [0, 26], :format => 'url').should == Gchart.line(:data => [0, 26])
+  end
+  
+  it "should be available as the img tag" do
+    Gchart.line(:data => [0, 26], :format => 'img_tag').should match(/<img src=(.*)\/>/)
+  end
+  
+  it "should be available as a file" do
+    File.delete('chart.png') if File.exist?('chart.png')
+    Gchart.line(:data => [0, 26], :format => 'file')
+    File.exist?('chart.png').should be_true
+    File.delete('chart.png') if File.exist?('chart.png')
+  end
+  
+  it "should be available as a file using a custom file name" do
+    File.delete('custom_file_name.png') if File.exist?('custom_file_name.png')
+    Gchart.line(:data => [0, 26], :format => 'file', :filename => 'custom_file_name.png')
+    File.exist?('custom_file_name.png').should be_true
+    File.delete('custom_file_name.png') if File.exist?('custom_file_name.png')
+  end
+  
+  it "should work even with multiple attrs" do
+    File.delete('foo.png') if File.exist?('foo.png')
+    Gchart.line(:size => '400x200',
+                :data => [1,2,3,4,5],
+                :axis_labels => [[1,2,3,4, 5], %w[foo bar]],
+                :axis_with_labels => 'x,r',
+                :format => "file",
+                :filename => "foo.png"
+                )
+    File.exist?('foo.png').should be_true
+    File.delete('foo.png') if File.exist?('foo.png')
+  end
+  
+end

data/spec/spec.opts

@@ -0,0 +1 @@
+--colour

data/spec/spec_helper.rb

@@ -0,0 +1,7 @@
+begin
+  require 'spec'
+rescue LoadError
+  require 'rubygems'
+  gem 'rspec'
+  require 'spec'
+end

data/tasks/deployment.rake

@@ -0,0 +1,34 @@
+desc 'Release the website and new gem version'
+task :deploy => [:check_version, :website, :release] do
+  puts "Remember to create SVN tag:"
+  puts "svn copy svn+ssh://#{rubyforge_username}@rubyforge.org/var/svn/#{PATH}/trunk " +
+    "svn+ssh://#{rubyforge_username}@rubyforge.org/var/svn/#{PATH}/tags/REL-#{VERS} "
+  puts "Suggested comment:"
+  puts "Tagging release #{CHANGES}"
+end
+
+desc 'Runs tasks website_generate and install_gem as a local deployment of the gem'
+task :local_deploy => [:website_generate, :install_gem]
+
+task :check_version do
+  unless ENV['VERSION']
+    puts 'Must pass a VERSION=x.y.z release version'
+    exit
+  end
+  unless ENV['VERSION'] == VERS
+    puts "Please update your version.rb to match the release version, currently #{VERS}"
+    exit
+  end
+end
+
+desc 'Install the package as a gem, without generating documentation(ri/rdoc)'
+task :install_gem_no_doc => [:clean, :package] do
+  sh "#{'sudo ' unless Hoe::WINDOZE }gem install pkg/*.gem --no-rdoc --no-ri"
+end
+
+namespace :manifest do
+  desc 'Recreate Manifest.txt to include ALL files'
+  task :refresh do
+    `rake check_manifest | patch -p0 > Manifest.txt`
+  end
+end

data/tasks/environment.rake

@@ -0,0 +1,7 @@
+task :ruby_env do
+  RUBY_APP = if RUBY_PLATFORM =~ /java/
+    "jruby"
+  else
+    "ruby"
+  end unless defined? RUBY_APP
+end

data/tasks/rspec.rake

@@ -0,0 +1,21 @@
+begin
+  require 'spec'
+rescue LoadError
+  require 'rubygems'
+  require 'spec'
+end
+begin
+  require 'spec/rake/spectask'
+rescue LoadError
+  puts <<-EOS
+To use rspec for testing you must install rspec gem:
+    gem install rspec
+EOS
+  exit(0)
+end
+
+desc "Run the specs under spec/models"
+Spec::Rake::SpecTask.new do |t|
+  t.spec_opts = ['--options', "spec/spec.opts"]
+  t.spec_files = FileList['spec/*_spec.rb']
+end

data/tasks/website.rake

@@ -0,0 +1,17 @@
+desc 'Generate website files'
+task :website_generate => :ruby_env do
+  (Dir['website/**/*.txt'] - Dir['website/version*.txt']).each do |txt|
+    sh %{ #{RUBY_APP} script/txt2html #{txt} > #{txt.gsub(/txt$/,'html')} }
+  end
+end
+
+desc 'Upload website files to rubyforge'
+task :website_upload do
+  host = "#{rubyforge_username}@rubyforge.org"
+  remote_dir = "/var/www/gforge-projects/#{PATH}/"
+  local_dir = 'website'
+  sh %{rsync -aCv #{local_dir}/ #{host}:#{remote_dir}}
+end
+
+desc 'Generate and upload website files'
+task :website => [:website_generate, :website_upload, :publish_docs]