matta-googlecharts 1.1.0 → 1.3.0

data/History.txt

@@ -1,7 +1,16 @@
+== 1.3.0
+* added support for google-o-meter
+* fixed a bug when the max value of a data set was 0
+
+== 1.2.0
+* added support for sparklines
+
 == 1.1.0
 * fixed another bug fix related to the uri escaping required to download the file properly.
+
 == 1.0.0
 * fixed the (URI::InvalidURIError) issue
+
 == 0.2.0
 * added export options (file and image tag)
 * added support for all arguments to be passed as a string or an array

data/README.txt

@@ -14,6 +14,7 @@ This gem supports the following types of charts:
   
   * line, 
   * line_xy
+  * sparkline
   * scatter
   * bar
   * venn

data/lib/gchart/version.rb

@@ -1,7 +1,7 @@
 module GchartInfo #:nodoc:
   module VERSION #:nodoc:
     MAJOR = 1
-    MINOR = 1
+    MINOR = 3
     TINY  = 0
 
     STRING = [MAJOR, MINOR, TINY].join('.')

data/lib/gchart.rb

@@ -8,7 +8,7 @@ class Gchart
   include GchartInfo
   
   @@url = "http://chart.apis.google.com/chart?"  
-  @@types = ['line', 'line_xy', 'scatter', 'bar', 'venn', 'pie', 'pie_3d', 'jstize']
+  @@types = ['line', 'line_xy', 'scatter', 'bar', 'venn', 'pie', 'pie_3d', 'jstize', 'sparkline', 'meter']
   @@simple_chars = ('A'..'Z').to_a + ('a'..'z').to_a + ('0'..'9').to_a
   @@chars = @@simple_chars + ['-', '.']
   @@ext_pairs = @@chars.map { |char_1| @@chars.map { |char_2| char_1 + char_2 } }.flatten
@@ -247,6 +247,10 @@ class Gchart
         "cht=v"
       when :scatter
         "cht=s"
+      when :sparkline
+        "cht=ls"
+      when :meter
+        "cht=gom"
       end
   end
   
@@ -284,7 +288,7 @@ class Gchart
     dataset = prepare_dataset(dataset)
     @max_value = dataset.map{|ds| ds.max}.max if @max_value == 'auto'
     
-    if @max_value == false || @max_value == 'false' || @max_value == :false
+    if @max_value == false || @max_value == 'false' || @max_value == :false || @max_value == 0
       "s:" + dataset.map { |ds| ds.map { |number| convert_to_simple_value(number) }.join }.join(',')
     else
       "s:" + dataset.map { |ds| ds.map { |number| convert_to_simple_value( (@@simple_chars.size - 1) * number / @max_value) }.join }.join(',')

data/spec/gchart_spec.rb

@@ -84,6 +84,11 @@ describe "generating different type of charts" do
     Gchart.line.include?('cht=lc').should be_true
   end
   
+  it "should be able to generate a sparkline chart" do
+    Gchart.sparkline.should be_an_instance_of(String)
+    Gchart.sparkline.include?('cht=ls').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
@@ -109,6 +114,11 @@ describe "generating different type of charts" do
     Gchart.pie.include?('cht=p').should be_true
   end
   
+  it "should be able to generate a Google-O-Meter" do
+    Gchart.meter.should be_an_instance_of(String)
+    Gchart.meter.include?('cht=gom').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
@@ -206,12 +216,80 @@ describe "a line chart" do
   
   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
+    Gchart.line(:line_color => 'efefef|00ffff').include?(Gchart.jstize('chco=efefef|00ffff')).should be_true
+  end
+  
+  it "should be able to render a graph where all the data values are 0" do
+    Gchart.line(:data => [0, 0, 0]).include?("chd=s:AAA").should be true
   end
   
 end
 
-describe "a pie chart" do
+describe "a sparkline chart" do
+  
+  before(:each) do
+    @title = 'Chart Title'
+    @legend = ['first data set label', 'n data set label']
+    @jstized_legend = Gchart.jstize(@legend.join('|'))
+    @data = [27,25,25,25,25,27,100,31,25,36,25,25,39,25,31,25,25,25,26,26,25,25,28,25,25,100,28,27,31,25,27,27,29,25,27,26,26,25,26,26,35,33,34,25,26,25,36,25,26,37,33,33,37,37,39,25,25,25,25]
+    @chart = Gchart.sparkline(:title => @title, :data => @data, :legend => @legend)
+  end
+  
+  it "should create a sparkline" do
+    @chart.include?('cht=ls').should be_true
+  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.sparkline(:title => @title, :title_color => 'FF0000').include?('chts=FF0000').should be_true
+     Gchart.sparkline(: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.sparkline(:legend => 'legend label')
+    chart.include?("chdl=legend+label").should be_true
+  end
+  
+  it "should be able to set the background fill" do
+    Gchart.sparkline(:bg => 'efefef').include?("chf=bg,s,efefef").should be_true
+    Gchart.sparkline(:bg => {:color => 'efefef', :type => 'solid'}).include?("chf=bg,s,efefef").should be_true
+           
+    Gchart.sparkline(:bg => {:color => 'efefef', :type => 'gradient'}).include?("chf=bg,lg,0,efefef,0,ffffff,1").should be_true
+    Gchart.sparkline(:bg => {:color => 'efefef,0,ffffff,1', :type => 'gradient'}).include?("chf=bg,lg,0,efefef,0,ffffff,1").should be_true
+    Gchart.sparkline(:bg => {:color => 'efefef', :type => 'gradient', :angle => 90}).include?("chf=bg,lg,90,efefef,0,ffffff,1").should be_true
+          
+    Gchart.sparkline(: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.sparkline(:graph_bg => 'efefef').include?("chf=c,s,efefef").should be_true
+    Gchart.sparkline(:graph_bg => {:color => 'efefef', :type => 'solid'}).include?("chf=c,s,efefef").should be_true
+    Gchart.sparkline(:graph_bg => {:color => 'efefef', :type => 'gradient'}).include?("chf=c,lg,0,efefef,0,ffffff,1").should be_true
+    Gchart.sparkline(:graph_bg => {:color => 'efefef,0,ffffff,1', :type => 'gradient'}).include?("chf=c,lg,0,efefef,0,ffffff,1").should be_true
+    Gchart.sparkline(: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.sparkline(:bg => 'efefef', :graph_bg => '76A4FB').include?("bg,s,efefef").should be_true
+    Gchart.sparkline(:bg => 'efefef', :graph_bg => '76A4FB').include?("c,s,76A4FB").should be_true
+    Gchart.sparkline(: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.sparkline(:line_colors => 'efefef|00ffff').include?(Gchart.jstize('chco=efefef|00ffff')).should be_true
+    Gchart.sparkline(:line_color => 'efefef|00ffff').include?(Gchart.jstize('chco=efefef|00ffff')).should be_true
+  end
+  
+end
+
+describe "a 3d pie chart" do
   
   before(:each) do
     @title = 'Chart Title'
@@ -237,6 +315,26 @@ describe "a pie chart" do
   
 end
 
+describe "a google-o-meter" do
+
+  before(:each) do
+    @data = [70]
+    @legend = ['arrow points here']
+    @jstized_legend = Gchart.jstize(@legend.join('|'))
+    @chart = Gchart.meter(:data => @data)
+  end
+  
+  it "should greate a meter" do
+    @chart.include?('cht=gom').should be_true
+  end
+  
+  it "should be able to set a solid background fill" do
+    Gchart.meter(:bg => 'efefef').include?("chf=bg,s,efefef").should be_true
+    Gchart.meter(:bg => {:color => 'efefef', :type => 'solid'}).include?("chf=bg,s,efefef").should be_true
+  end
+  
+end
+
 describe 'exporting a chart' do
   
   it "should be available in the url format by default" do

data/website/index.html

@@ -33,7 +33,7 @@
     <h1>Googlecharts</h1>
     <div id="version" class="clickable" onclick='document.location = "http://rubyforge.org/projects/googlecharts"; return false'>
       <p>Get Version</p>
-      <a href="http://rubyforge.org/projects/googlecharts" class="numbers">1.1.0</a>
+      <a href="http://rubyforge.org/projects/googlecharts" class="numbers">1.3.0</a>
     </div>
     <h2>&#x2192; &#8216;Sexy Charts using Google <span class="caps">API</span> &#38; Ruby&#8217;</h2>
 
@@ -47,7 +47,15 @@
 	<h2>Installing</h2>
 
 
-	<p><pre class='syntax'><span class="ident">sudo</span> <span class="ident">gem</span> <span class="ident">install</span> <span class="ident">googlecharts</span></pre></p>
+	<p>This project is now hosted at <a href="http://github.com">GitHub</a>
+If you never added <a href="http://github.com">GitHub</a> as a gem source, you will need to do the following:
+<pre class='syntax'><span class="global">$ </span><span class="ident">gem</span> <span class="ident">sources</span> <span class="punct">-</span><span class="ident">a</span> <span class="ident">http</span><span class="punct">:/</span><span class="regex"></span><span class="punct">/</span><span class="ident">gems</span><span class="punct">.</span><span class="ident">github</span><span class="punct">.</span><span class="ident">com</span><span class="punct">/</span></pre> (you only need to do this once)</p>
+
+
+	<p><pre class='syntax'><span class="global">$ </span><span class="ident">sudo</span> <span class="ident">gem</span> <span class="ident">install</span> <span class="ident">matta</span><span class="punct">-</span><span class="ident">googlecharts</span></pre></p>
+
+
+	<p>or <pre class='syntax'><span class="global">$ </span><span class="ident">sudo</span> <span class="ident">gem</span> <span class="ident">install</span> <span class="ident">googlecharts</span></pre></p>
 
 
 	<h2>The basics</h2>
@@ -77,10 +85,23 @@
 	<p><img src="http://chart.apis.google.com/chart?cht=p3&#38;chd=s:Uf9a&#38;chs=200x100&#38;chl=A|B|C|D" title="pie_3d" alt="pie_3d" /> Gchart.pie_3d()</p>
 
 
+	<p><img src="http://chart.apis.google.com/chart?chs=100x20&#38;cht=ls&#38;chco=0077CC&#38;chm=B,E6F2FA,0,0,0&#38;chls=1,0,0&#38;chd=t:27,25,25,25,25,27,100,31,25,36,25,25,39,25,31,25,25,25,26,26,25,25,28,25,25,100,28,27,31,25,27,27,29,25,27,26,26,25,26,26,35,33,34,25,26,25,36,25,26,37,33,33,37,37,39,25,25,25,25" title="sparkline" alt="sparkline" />Gchart.sparkline()</p>
+
+
+	<p><img src="http://chart.apis.google.com/chart?chs=225x125&#38;cht=gom&#38;chd=t:70&#38;chl=Flavor" title="google-o-meter" alt="google-o-meter" /> Gchart.meter()</p>
+
+
 	<h2>Demonstration of usage</h2>
 
 
-install:
+	<p>install:</p>
+
+
+<code>sudo gem install matta-googlecharts</code>
+
+	<p>or use rubyforge:</p>
+
+
 <code>sudo gem install googlecharts</code>
 
 	<p>require:
@@ -135,6 +156,21 @@ install:
 	<p><a href="http://code.google.com/apis/chart/#chart_colors">more info about color settings</a></p>
 
 
+	<p><strong>sparkline chart</strong></p>
+
+
+	<p><pre class='syntax'>
+  <span class="ident">data</span> <span class="punct">=</span> <span class="punct">[</span><span class="number">27</span><span class="punct">,</span><span class="number">25</span><span class="punct">,</span><span class="number">25</span><span class="punct">,</span><span class="number">25</span><span class="punct">,</span><span class="number">25</span><span class="punct">,</span><span class="number">27</span><span class="punct">,</span><span class="number">100</span><span class="punct">,</span><span class="number">31</span><span class="punct">,</span><span class="number">25</span><span class="punct">,</span><span class="number">36</span><span class="punct">,</span><span class="number">25</span><span class="punct">,</span><span class="number">25</span><span class="punct">,</span><span class="number">39</span><span class="punct">,</span><span class="number">25</span><span class="punct">,</span><span class="number">31</span><span class="punct">,</span><span class="number">25</span><span class="punct">,</span><span class="number">25</span><span class="punct">,</span><span class="number">25</span><span class="punct">,</span><span class="number">26</span><span class="punct">,</span><span class="number">26</span><span class="punct">,</span><span class="number">25</span><span class="punct">,</span><span class="number">25</span><span class="punct">,</span><span class="number">28</span><span class="punct">,</span><span class="number">25</span><span class="punct">,</span><span class="number">25</span><span class="punct">,</span><span class="number">100</span><span class="punct">,</span><span class="number">28</span><span class="punct">,</span><span class="number">27</span><span class="punct">,</span><span class="number">31</span><span class="punct">,</span><span class="number">25</span><span class="punct">,</span><span class="number">27</span><span class="punct">,</span><span class="number">27</span><span class="punct">,</span><span class="number">29</span><span class="punct">,</span><span class="number">25</span><span class="punct">,</span><span class="number">27</span><span class="punct">,</span><span class="number">26</span><span class="punct">,</span><span class="number">26</span><span class="punct">,</span><span class="number">25</span><span class="punct">,</span><span class="number">26</span><span class="punct">,</span><span class="number">26</span><span class="punct">,</span><span class="number">35</span><span class="punct">,</span><span class="number">33</span><span class="punct">,</span><span class="number">34</span><span class="punct">,</span><span class="number">25</span><span class="punct">,</span><span class="number">26</span><span class="punct">,</span><span class="number">25</span><span class="punct">,</span><span class="number">36</span><span class="punct">,</span><span class="number">25</span><span class="punct">,</span><span class="number">26</span><span class="punct">,</span><span class="number">37</span><span class="punct">,</span><span class="number">33</span><span class="punct">,</span><span class="number">33</span><span class="punct">,</span><span class="number">37</span><span class="punct">,</span><span class="number">37</span><span class="punct">,</span><span class="number">39</span><span class="punct">,</span><span class="number">25</span><span class="punct">,</span><span class="number">25</span><span class="punct">,</span><span class="number">25</span><span class="punct">,</span><span class="number">25</span><span class="punct">]</span>
+  <span class="constant">Gchart</span><span class="punct">.</span><span class="ident">sparkline</span><span class="punct">(</span><span class="symbol">:data</span> <span class="punct">=&gt;</span> <span class="ident">data</span><span class="punct">,</span> <span class="symbol">:size</span> <span class="punct">=&gt;</span> <span class="punct">'</span><span class="string">120x40</span><span class="punct">',</span> <span class="symbol">:line_colors</span> <span class="punct">=&gt;</span> <span class="punct">'</span><span class="string">0077CC</span><span class="punct">')</span>
+</pre></p>
+
+
+	<p><img src="http://chart.apis.google.com/chart?chd=s:QPPPPQ9SPVPPXPSPPPPPPPRPP9RQSPQQRPQPPPPPVUUPPPVPPWUUWWXPPPP&#38;chco=0077CC&#38;chs=120x40&#38;cht=ls" title="sparline" alt="sparline" /></p>
+
+
+	<p>A sparkline chart has exactly the same parameters as a line chart. The only difference is that the axes lines are not drawn for sparklines by default.</p>
+
+
 	<p><strong>bar chart</strong></p>
 
 
@@ -253,6 +289,20 @@ Data set:
 	<p><img src="http://chart.apis.google.com/chart?cht=s&#38;chs=300x200&#38;chd=s:MYkw9,MYkw9,9wkYM" title="scatter" alt="scatter" /></p>
 
 
+	<p><strong>google-o-meter</strong></p>
+
+
+	<p><a href="http://code.google.com/apis/chart/#gom">Google Documentation</a></p>
+
+
+	<p>Supply a single label that will be what the arrow points to. It only supports a solid fill for the background.</p>
+
+
+	<p><pre class='syntax'>
+ <span class="constant">Gchart</span><span class="punct">.</span><span class="ident">meter</span><span class="punct">(</span><span class="symbol">:data</span> <span class="punct">=&gt;</span> <span class="punct">[</span><span class="number">70</span><span class="punct">],</span> <span class="symbol">:label</span> <span class="punct">=&gt;</span> <span class="punct">['</span><span class="string">Flavor</span><span class="punct">'])</span>
+</pre></p>
+
+
 <hr />
 
 
@@ -571,7 +621,7 @@ Data set:
 	<h2>Repository</h2>
 
 
-	<p>The trunk repository is <code>svn://rubyforge.org/var/svn/googlecharts/trunk</code> for anonymous access.</p>
+	<p>The trunk repository is <code>http://github.com/matta/googlecharts/</code> for anonymous access.</p>
 
 
 	<h2>License</h2>
@@ -584,8 +634,14 @@ Data set:
 
 
 	<p>Comments are welcome. Send an email to <a href="mailto:mattaimonetti@gmail.com">Matt Aimonetti</a></p>
+
+
+	<h3>Contributors</h3>
+
+
+	<p><a href="http://github.com/dbgrandi">David Grandinetti</a></p>
     <p class="coda">
-      <a href="mattaimonetti@gmail.com">Matt Aimonetti</a>, 25th February 2008<br>
+      <a href="mattaimonetti@gmail.com">Matt Aimonetti</a>, 7th May 2008<br>
       Theme extended from <a href="http://rb2js.rubyforge.org/">Paul Battley</a>
     </p>
 </div>

data/website/index.txt

@@ -15,6 +15,8 @@ If you never added "GitHub":http://github.com as a gem source, you will need to
 
 <pre syntax="ruby">$ sudo gem install matta-googlecharts</pre>
 
+or <pre syntax="ruby">$ sudo gem install googlecharts</pre>
+
 h2. The basics
 
 This gem supports the following types of charts:
@@ -32,13 +34,21 @@ This gem supports the following types of charts:
 !http://chart.apis.google.com/chart?cht=p&chd=s:world5&chs=200x125&chl=A|B|C|D|E|Fe(pie)! Gchart.pie()
 
 !http://chart.apis.google.com/chart?cht=p3&chd=s:Uf9a&chs=200x100&chl=A|B|C|D(pie_3d)! Gchart.pie_3d()
+
+!http://chart.apis.google.com/chart?chs=100x20&cht=ls&chco=0077CC&chm=B,E6F2FA,0,0,0&chls=1,0,0&chd=t:27,25,25,25,25,27,100,31,25,36,25,25,39,25,31,25,25,25,26,26,25,25,28,25,25,100,28,27,31,25,27,27,29,25,27,26,26,25,26,26,35,33,34,25,26,25,36,25,26,37,33,33,37,37,39,25,25,25,25(sparkline)!Gchart.sparkline()
               
+!http://chart.apis.google.com/chart?chs=225x125&cht=gom&chd=t:70&chl=Flavor(google-o-meter)! Gchart.meter()
 
 h2. Demonstration of usage
 
 install:
+
 <code>sudo gem install matta-googlecharts</code>
 
+or use rubyforge:
+
+<code>sudo gem install googlecharts</code>
+
 require:
 <pre syntax="ruby">require 'gchart'</pre>
 
@@ -78,6 +88,17 @@ Inserted in an image tag, it will look like that:
 
 "more info about color settings":http://code.google.com/apis/chart/#chart_colors
 
+*sparkline chart*
+
+<pre syntax="ruby">
+  data = [27,25,25,25,25,27,100,31,25,36,25,25,39,25,31,25,25,25,26,26,25,25,28,25,25,100,28,27,31,25,27,27,29,25,27,26,26,25,26,26,35,33,34,25,26,25,36,25,26,37,33,33,37,37,39,25,25,25,25]
+  Gchart.sparkline(:data => data, :size => '120x40', :line_colors => '0077CC')
+</pre>
+
+!http://chart.apis.google.com/chart?chd=s:QPPPPQ9SPVPPXPSPPPPPPPRPP9RQSPQQRPQPPPPPVUUPPPVPPWUUWWXPPPP&chco=0077CC&chs=120x40&cht=ls(sparline)!
+
+A sparkline chart has exactly the same parameters as a line chart. The only difference is that the axes lines are not drawn for sparklines by default.
+
 *bar chart*
 
 <pre syntax="ruby">
@@ -167,6 +188,16 @@ Supply two data sets, the first data set specifies x coordinates, the second set
 
 !http://chart.apis.google.com/chart?cht=s&chs=300x200&chd=s:MYkw9,MYkw9,9wkYM(scatter)!
 
+*google-o-meter*
+
+"Google Documentation":http://code.google.com/apis/chart/#gom
+
+Supply a single label that will be what the arrow points to. It only supports a solid fill for the background.
+
+<pre syntax="ruby">
+ Gchart.meter(:data => [70], :label => ['Flavor'])
+</pre>
+
 ---
 
 *set a chart title*
@@ -419,3 +450,6 @@ h2. Contact
 
 Comments are welcome. Send an email to "Matt Aimonetti":mailto:mattaimonetti@gmail.com
 
+h3. Contributors
+
+"David Grandinetti":http://github.com/dbgrandi

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: matta-googlecharts
 version: !ruby/object:Gem::Version 
-  version: 1.1.0
+  version: 1.3.0
 platform: ruby
 authors: 
 - Matt Aimonetti
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2008-04-26 00:00:00 -07:00
+date: 2008-05-07 00:00:00 -07:00
 default_executable: 
 dependencies: []