gregoryfoster-gchartrb 0.9

data/CREDITS

@@ -0,0 +1,6 @@
+Will Fitzgerald - http://www.entish.org/willwhim
+Bryan Donovan
+Aseem Tandon
+Diomedes <alakazoom@gmail.com>
+Aaron Blohowiak
+Jack Nutting

data/History.txt

@@ -0,0 +1,69 @@
+== 0.8 / 2008-03-20
+
+* Fixed Rakefile to process URL correctly (Thanks Aaron Blohowiak)
+* Fixed Axis error due to typo in base.rb (Thanks Jack Nutting)
+
+== 0.7 / 2008-02-04
+
+* Added fill area feature
+* Added to_escaped_url method for encoding the URLs properly
+* Fixed bug where wrong variable name was being used in method
+
+== 0.6 / 2008-01-27
+
+* Added experimental support for undocumented Financial Line Chart (lfi)
+* Added line style support (thanks diomedes)
+* Added support for customisable width and spacing in bar charts
+
+== 0.5.5 / 2008-01-23
+
+* Fixed a bug related to multiple datasets using extended encoding
+
+== 0.5.4 / 2008-01-07
+
+* Fixed a bug related to data encoding in Stacked Charts
+* Fixed a bug in which title font and title font size values were being ignored
+* Fixed a bug where shape markers and range markers were overriding each other
+
+== 0.5.3 / 2007-12-19
+
+* Added support for shape markers
+* Added support for block based idiomatic ruby syntax
+
+== 0.5.2 / 2007-12-14
+
+* Added support for title color via title_color attribute
+* Added support for vertical and horizontal range markers using the range_marker method
+* Removed show_labels from base.rb and added it only for pie charts
+
+== 0.5.1 / 2007-12-12
+
+* Added support for max_value method to specify maximum values to plot against
+
+== 0.5 / 2007-12-12
+
+* Added Scatter Chart Support
+* Documentation Updates
+
+== 0.4.1 / 2007-12-12
+
+* Removed some spurious debug statements
+
+== 0.4 / 2007-12-12
+
+* Fixed issue when all data points are 0 in Line XY Chart (Thanks Cedric)
+* Proper calculation of max values for Line XY chart (Thanks Bryan Donovan)
+
+== 0.3 / 2007-12-11
+
+* Google changed Pie chart implementation to disable legends. Fixed in API.
+
+== 0.2 / 2007-12-11
+
+* Removed hoe dependency 
+* Doc fixes
+
+== 0.1 / 2007-12-11
+
+* Initial Release
+* RDoc documentation

data/Manifest.txt

@@ -0,0 +1,47 @@
+CREDITS
+History.txt
+Manifest.txt
+README.txt
+Rakefile
+TODO
+gchartrb.gemspec
+lib/core_ext.rb
+lib/example.rb
+lib/gchartrb.rb
+lib/google_chart.rb
+lib/google_chart/bar_chart.rb
+lib/google_chart/base.rb
+lib/google_chart/line_chart.rb
+lib/google_chart/linexy_chart.rb
+lib/google_chart/map_chart.rb
+lib/google_chart/modules/axis.rb
+lib/google_chart/modules/color.rb
+lib/google_chart/modules/data_array.rb
+lib/google_chart/modules/fills.rb
+lib/google_chart/modules/grid.rb
+lib/google_chart/modules/label.rb
+lib/google_chart/modules/legend.rb
+lib/google_chart/modules/markers.rb
+lib/google_chart/pie_chart.rb
+lib/google_chart/radar_chart.rb
+lib/google_chart/scatter_plot.rb
+lib/google_chart/sparkline_chart.rb
+lib/google_chart/venn_diagram.rb
+lib/test.rb
+scripts/iso3166_en_code_lists.txt
+scripts/process_country_codes.rb
+spec/gchartrb/axis_spec.rb
+spec/gchartrb/bar_chart_spec.rb
+spec/gchartrb/fills_spec.rb
+spec/gchartrb/grid_spec.rb
+spec/gchartrb/line_chart_spec.rb
+spec/gchartrb/linexy_chart_spec.rb
+spec/gchartrb/markers_spec.rb
+spec/gchartrb/pie_chart_spec.rb
+spec/gchartrb/radar_chart_spec.rb
+spec/gchartrb/scatter_plot_spec.rb
+spec/gchartrb/sparkline_chart_spec.rb
+spec/gchartrb/venn_diagram_spec.rb
+spec/gchartrb_spec.rb
+spec/helper.rb
+spec/spec.opts

data/README.txt

@@ -0,0 +1,64 @@
+= gchartrb
+http://code.google.com/p/gchartrb
+
+== DESCRIPTION:
+
+gchartrb is a Ruby wrapper around the Google Chart API, located at http://code.google.com/apis/chart/ 
+
+Visit http://code.google.com/p/gchartrb to track development regarding gchartrb.
+
+== FEATURES:
+  
+* Provides an object oriented interface in Ruby to create Google Chart URLs for charts.
+
+== INSTALL:
+
+=== Ruby Gem:
+
+    sudo gem install gchartrb
+
+=== Manual Download:
+
+Download the latest release from http://code.google.com/p/gchartrb/downloads/list
+
+=== Git:
+You can checkout the git repository at http://github.com/deepakjois/gchartrb
+
+== TODO:
+The following features are pending :
+
+* Line Styles and Fill Areas
+* Googleometer and Map Charts
+* Data Scaling for Text Encoding
+* Download Image
+* Friendly Color Values
+* Easy Calculations for Stuff
+* Cleanup and DRY Validations
+
+== SYNOPSIS:
+TODO: write new
+
+== LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2007 Deepak Jois
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/Rakefile

@@ -0,0 +1,61 @@
+# -*- ruby -*-
+
+require 'rubygems'
+require 'hoe'
+require "spec/rake/spectask"
+require './lib/gchartrb'
+
+class Hoe
+  def extra_deps; @extra_deps.reject { |x| Array(x).first == "hoe" } end
+end # copied from the Rakefile of the sup project
+
+Hoe.new('gchartrb', "0.9") do |p|
+  p.rubyforge_name  = 'gchartrb'
+  p.author          = 'Deepak Jois'
+  p.email           = 'deepak.jois@gmail.com'
+  p.summary         = 'Ruby Wrapper for the Google Chart API'
+  p.description     = p.paragraphs_of('README.txt', 2..3).join("\n\n")
+  p.url             = p.paragraphs_of('README.txt', 0).first.split(/\n/)[1..-1]
+  p.changes         = p.paragraphs_of('History.txt', 0..1).join("\n\n")
+  p.remote_rdoc_dir = ''
+end
+
+
+RDOC_OPTS         = [
+	'--quiet',
+	'--title', 'gchartrb API',
+	'--main',  'README.txt',
+	'--charset', 'utf-8',
+	'--inline-source',
+	'--tab-width', '2',
+	'--line-numbers',
+]
+
+Rake::RDocTask.new do |rdoc|
+    rdoc.rdoc_dir  = 'doc/'
+    rdoc.options   = RDOC_OPTS
+    rdoc.main      = "README.txt"
+    rdoc.rdoc_files.add [
+    	'README.txt',
+    	'History.txt',
+    	'lib/**/*.rb'
+    ]
+end
+
+desc "Run all specs"
+Spec::Rake::SpecTask.new do |t|
+  t.spec_files = FileList["spec/**/*_spec.rb"]
+  t.spec_opts = ["--options", "spec/spec.opts"]
+end
+
+desc "Run all specs and get coverage statistics"
+Spec::Rake::SpecTask.new('spec:rcov') do |t|
+  t.spec_files = FileList["spec/**/*_spec.rb"]
+  t.rcov = true
+  t.spec_opts = ["--options", "spec/spec.opts"]
+end
+
+Rake::Task[:default].prerequisites.clear
+task :default => :spec
+
+# vim: syntax=Ruby

data/TODO

@@ -0,0 +1,10 @@
+TODO List
+====================
+* Documentation!
+* Line Styles and Fill Areas
+* Googleometer and Map Charts
+* Data Scaling for text encoding
+* Download Image
+* Friendly Color Values
+* Easy calculations for Stuff that is needed
+* Cleanup and DRY validations

data/gchartrb.gemspec

@@ -0,0 +1,18 @@
+Gem::Specification.new do |s|
+  s.name = "gchartrb"
+  s.version = "0.9"
+  s.authors = ["Deepak Jois"]
+  s.email = "deepak.jois@gmail.com"
+  s.date = "2008-06-16"
+  s.homepage = "http://code.google.com/p/gchartrb"
+  s.summary = "Ruby Wrapper for the Google Chart API"
+  s.description = "gchartrb is a Ruby wrapper around the Google Chart API, located at http://code.google.com/apis/chart/. Visit http://code.google.com/p/gchartrb to track development regarding gchartrb."
+
+  s.has_rdoc = true
+  s.extra_rdoc_files = ["History.txt", "Manifest.txt", "README.txt"]
+  s.rdoc_options = ["--main", "README.txt"]
+  s.files = ["CREDITS", "History.txt", "Manifest.txt", "README.txt", "Rakefile", "TODO", "gchartrb.gemspec", "lib/core_ext.rb", "lib/example.rb", "lib/gchartrb.rb", "lib/google_chart.rb", "lib/google_chart/bar_chart.rb", "lib/google_chart/base.rb", "lib/google_chart/line_chart.rb", "lib/google_chart/linexy_chart.rb", "lib/google_chart/map_chart.rb", "lib/google_chart/modules/axis.rb", "lib/google_chart/modules/color.rb", "lib/google_chart/modules/data_array.rb", "lib/google_chart/modules/fills.rb", "lib/google_chart/modules/grid.rb", "lib/google_chart/modules/label.rb", "lib/google_chart/modules/legend.rb", "lib/google_chart/modules/markers.rb", "lib/google_chart/pie_chart.rb", "lib/google_chart/radar_chart.rb", "lib/google_chart/scatter_plot.rb", "lib/google_chart/sparkline_chart.rb", "lib/google_chart/venn_diagram.rb", "lib/test.rb", "scripts/iso3166_en_code_lists.txt", "scripts/process_country_codes.rb", "spec/gchartrb/axis_spec.rb", "spec/gchartrb/bar_chart_spec.rb", "spec/gchartrb/fills_spec.rb", "spec/gchartrb/grid_spec.rb", "spec/gchartrb/line_chart_spec.rb", "spec/gchartrb/linexy_chart_spec.rb", "spec/gchartrb/markers_spec.rb", "spec/gchartrb/pie_chart_spec.rb", "spec/gchartrb/radar_chart_spec.rb", "spec/gchartrb/scatter_plot_spec.rb", "spec/gchartrb/sparkline_chart_spec.rb", "spec/gchartrb/venn_diagram_spec.rb", "spec/gchartrb_spec.rb", "spec/helper.rb", "spec/spec.opts" ]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = "gchartrb"
+  s.rubygems_version = "1.1.1"
+end

data/lib/core_ext.rb

@@ -0,0 +1,32 @@
+class Array
+  # Returns true if all elements are numeric
+  def is_numeric_array?
+    self.all? {|data| data.is_a?(Numeric) }
+  end
+
+  # Returns true if all elements are numeric in form [X,Y]
+  def is_numeric_2d_array?
+    self.all? do |data|
+      data.is_a?(Array) &&
+      data.size == 2 &&
+      data.is_numeric_array?
+    end
+  end
+
+  # Returns all the X values of an array containing elements of the form [X,Y]
+  def x_values
+    raise ArgumentError.new("#{self.inspect} is not a 2D numeric array") unless is_numeric_2d_array?
+    self.collect { |item| item.first }
+  end
+
+  # Returns all the Y values of an array containing elements of the form [X,Y]
+  def y_values
+    raise ArgumentError.new("#{self.inspect} is not a 2D numeric array") unless is_numeric_2d_array?
+    self.collect { |item| item.last }
+  end
+
+end
+
+class Numeric
+  def is_numeric? ; true ; end
+end

data/lib/example.rb

@@ -0,0 +1,75 @@
+require 'gchartrb'
+
+# Some examples from http://24ways.org/2007/tracking-christmas-cheer-with-google-charts
+
+# Pie Chart
+pc = GoogleChart::PieChart.new
+pc.width = 600
+pc.height = 300
+pc.title = "Food and Drinks Consumed Christmas 2007"
+
+pc.data "Egg nog", 10, '00AF33'
+pc.data "Christmas Ham", 20, '4BB74C'
+pc.data "Milk (not including egg nog)",	8, 'EE2C2C'
+pc.data "Cookies", 25, 'CC3232'
+pc.data "Roasted Chestnuts", 5, '33FF33'
+pc.data "Chocolate", 3, '66FF66'
+pc.data "Various Other Beverages", 15, '9AFF9A'
+pc.data "Various Other Foods", 9, 'C1FFC1'
+pc.data "Snacks",	5, 'CCFFCC'
+puts pc.to_url
+
+#  Line Chart
+x_axis_labels = (1..31).to_a.collect do |v|
+  if [1,6,25,26,31].member?(v)
+    if v == 1
+      "Dec 1st"
+    elsif v == 31
+      "Dec 31st"
+    elsif v
+      "#{v}th"
+    end
+  else
+    nil
+  end
+end
+
+y_axis_labels = (0..10).to_a.collect do |v|
+  val = 10 * v
+  if val ==50 or val == 100
+    val.to_s
+  else
+    nil
+  end
+end
+
+series_1_y = [30,45,20,50,15,80,60,70,40,55,80]
+series_2_y = [50,10,30,55,60]
+
+series_1_x = [1,6,8,10,18,23,25,26,28,29,31]
+series_2_x = [1,4,6,9,11]
+
+series_1_xy = series_1_x.zip(series_1_y)
+series_2_xy = series_2_x.zip(series_2_y)
+
+lcxy = GoogleChart::LineXYChart.new
+lcxy.width = 800
+lcxy.height = 300
+lcxy.title = "Projected Christmas Cheer for 2007"
+lcxy.data "2006", series_1_xy, '458B00'
+lcxy.data "2007", series_2_xy, 'CD2626'
+lcxy.max_x =  30
+lcxy.max_y = 100
+lcxy.encoding = :text
+lcxy.axis :bottom, :labels => x_axis_labels
+lcxy.axis :left, :labels => y_axis_labels
+lcxy.grid :x_step => 3.333, :y_step => 10, :line_segment => 1, :blank_segment => 3
+puts lcxy.to_url
+
+
+# Plotting a sparklines chart
+sparklines = GoogleChart::SparklineChart.new :width => 100, :height => 40
+sparklines.data "Test", [4,3,2,4,6,8,10]
+puts sparklines.to_url
+
+

data/lib/gchartrb.rb

@@ -0,0 +1 @@
+require 'google_chart'

data/lib/google_chart.rb

@@ -0,0 +1,39 @@
+require File.dirname(__FILE__) + "/core_ext"
+%w(legend color data_array fills axis grid markers label).each do |mod|
+    require File.dirname(__FILE__) + "/google_chart/modules/#{mod}"
+end
+
+%w(base line_chart linexy_chart sparkline_chart scatter_plot bar_chart radar_chart venn_diagram pie_chart map_chart).each do |type|
+    require File.dirname(__FILE__) + "/google_chart/#{type}"
+end
+
+module GoogleChart
+  # Blatantly copied from GChart (http://gchart.rubyforge.org)
+  URL   = "http://chart.apis.google.com/chart"
+
+  SIMPLE_CHARS = ('A'..'Z').to_a + ('a'..'z').to_a + ('0'..'9').to_a
+  EXTENDED_CHARS = ('A'..'Z').to_a + ('a'..'z').to_a + ('0'..'9').to_a + %w[- .]
+  EXTENDED_PAIRS = EXTENDED_CHARS.collect { |first| EXTENDED_CHARS.collect { |second| first + second } }.flatten
+  ENCODINGS = [:simple, :text, :extended]
+
+  class <<self
+
+    # Encode +n+ as a string. +n+ is normalized based on +max+.
+    # Blatantly copied from GChart (http://gchart.rubyforge.org)
+    def encode(encoding, n, max)
+      case encoding
+      when :simple
+        return "_" if n.nil?
+        SIMPLE_CHARS[((n/max.to_f) * (SIMPLE_CHARS.size - 1)).round]
+      when :text
+        return "-1" if n.nil?
+        ((((n/max.to_f) * 1000.0).round)/10.0).to_s
+      when :extended
+        return "__" if n.nil?
+        EXTENDED_PAIRS[max.zero? ? 0 : ((n/max.to_f) * (EXTENDED_PAIRS.size - 1)).round]
+      else
+        raise ArgumentError, "unsupported encoding: #{encoding.inspect}"
+      end
+    end
+  end
+end

data/lib/google_chart/bar_chart.rb

@@ -0,0 +1,83 @@
+module GoogleChart
+  class BarChart < Base
+    include Legend
+    include Color
+    include DataArray
+    include Fills
+    include Axis
+    include Grid
+    include Markers
+
+    data_type :numeric_array
+
+    attr_accessor :orientation, :grouping, :bar_width, :bar_spacing, :group_spacing
+
+    ORIENTATIONS = [:horizontal, :vertical]
+    GROUPINGS    = [:grouped, :stacked]
+
+    def initialize(options={}) #:nodoc:
+      @orientation = :vertical
+      @grouping    = :grouped
+      set_chart_type
+      @show_legend = true
+      super(options)
+    end
+
+
+    def orientation=(o)
+      raise ArgumentError.new("Orientation can only be :vertical or :horizontal") unless ORIENTATIONS.include?(o)
+      @orientation = o
+      set_chart_type
+    end
+
+    def grouping=(g)
+      raise ArgumentError.new("Grouping can only be :grouped or :stacked") unless GROUPINGS.include?(g)
+      @grouping = g
+      set_chart_type
+    end
+
+    def set_chart_type
+      @chart_type = (
+                     if    @orientation == :horizontal and @grouping == :grouped then "bhg"
+                     elsif @orientation == :horizontal and @grouping == :stacked then "bhs"
+                     elsif @orientation == :vertical   and @grouping == :grouped then "bvg"
+                     elsif @orientation == :vertical   and @grouping == :stacked then "bvs"
+                     end
+                    )
+    end
+
+    def bar_width=(width)
+      raise ArgumentError.new("bar width should be in integer") unless width.is_a?(Integer)
+      @bar_width = width
+    end
+
+    def bar_spacing=(spacing)
+      raise ArgumentError.new("bar spacing should be in integer") unless spacing.is_a?(Integer)
+      raise ArgumentError.new("cannot specify bar spacing without specifying bar width first") unless @bar_width
+      @bar_spacing = spacing
+    end
+
+    def group_spacing=(spacing)
+      raise ArgumentError.new("bar spacing should be in integer") unless spacing.is_a?(Integer)
+      raise ArgumentError.new("cannot specify group spacing without specifying bar width first") unless @bar_width
+      raise ArgumentError.new("cannot specify group spacing without specifying bar spacing first") unless @bar_spacing
+      @group_spacing = spacing
+    end
+
+    def add_bar_width_and_spacing
+      str = "#{@bar_width}" if @bar_width
+      str+= ",#{@bar_spacing}" if @bar_spacing
+      str+= ",#{@group_spacing}" if @group_spacing
+      @params[:chbh] = str if str
+    end
+
+    def encode_data
+      # override encode_data to set custom max value for stacked charts (unless max is already set)
+      if grouping == :stacked and not self.max
+        # set max value to the max value of sums
+        self.max = @data.inject(Array.new(@data.first.size,0)) { |sum_series, series|  sum_series.zip(series).collect { |d| d.first + d.last } }.max
+      end
+      super
+    end
+  end
+end