google_visualr 0.0.1 → 2.0.0

data/lib/google_visualr/formatters.rb

@@ -0,0 +1,78 @@
+module GoogleVisualr
+
+  # http://code.google.com/apis/chart/interactive/docs/reference.html#formatters
+  class Formatter
+    include GoogleVisualr::ParamHelpers
+
+    def initialize(options={})
+      @options = options
+    end
+
+
+    def columns(*columns)
+      @columns = columns.flatten
+    end
+
+    def options(*options)
+      @options = stringify_keys!(options.pop)
+    end
+
+    def to_js(&block)
+      js   = "\nvar formatter = new google.visualization.#{self.class.to_s.split('::').last}("
+      js  <<  js_parameters(@options)
+      js  << ");"
+
+      yield js if block_given?
+
+      @columns.each do |column|
+       js << "\nformatter.format(data_table, #{column});"
+      end
+
+      js
+    end
+
+  end
+
+  class ArrowFormat  < Formatter
+  end
+
+  class BarFormat    < Formatter
+  end
+
+  class ColorFormat  < Formatter
+
+    attr_accessor :ranges
+    attr_accessor :gradient_ranges
+
+    def initialize
+      @ranges           = Array.new
+      @gradient_ranges  = Array.new
+    end
+
+    def add_range(from, to, color, bgcolor)
+      @ranges << { :from => from, :to => to, :color => color, :bgcolor => bgcolor }
+    end
+
+    def add_gradient_range(from, to, color, fromBgColor, toBgColor)
+      @gradient_ranges <<  { :from => from, :to => to, :color => color, :fromBgColor => fromBgColor, :toBgColor => toBgColor }
+    end
+
+    def to_js
+      super do |js|
+        @ranges.each do |r|
+          js << "\nformatter.addRange(#{typecast(r[:from])}, #{typecast(r[:to])}, '#{r[:color]}', '#{r[:bgcolor]}');"
+        end
+        @gradient_ranges.each do |r|
+          js << "\nformatter.addGradientRange(#{typecast(r[:from])}, #{typecast(r[:to])}, '#{r[:color]}', '#{r[:fromBgColor]}', '#{r[:toBgColor]}');"
+        end
+      end
+    end
+  end
+
+  class DateFormat   < Formatter
+  end
+
+  class NumberFormat < Formatter
+  end
+
+end

data/lib/google_visualr/image/spark_line.rb

@@ -0,0 +1,13 @@
+module GoogleVisualr
+  module Image
+
+    # http://code.google.com/apis/chart/interactive/docs/gallery/imagesparkline.html
+    class SparkLine < BaseChart
+      include GoogleVisualr::Packages::ImageChart
+
+      # For Configuration Options, please refer to:
+      # http://code.google.com/apis/chart/interactive/docs/gallery/imagesparkline.html#Configuration_Options
+    end
+
+  end
+end

data/lib/google_visualr/interactive/annotated_time_line.rb

@@ -0,0 +1,11 @@
+module GoogleVisualr
+  module Interactive
+
+    # http://code.google.com/apis/chart/interactive/docs/gallery/annotatedtimeline.html
+    class AnnotatedTimeLine < BaseChart
+      # For Configuration Options, please refer to:
+      # http://code.google.com/apis/chart/interactive/docs/gallery/annotatedtimeline.html#Configuration_Options
+    end
+
+  end
+end

data/lib/google_visualr/interactive/area_chart.rb

@@ -0,0 +1,13 @@
+module GoogleVisualr
+  module Interactive
+
+    # http://code.google.com/apis/chart/interactive/docs/gallery/areachart.html
+    class AreaChart < BaseChart
+      include GoogleVisualr::Packages::CoreChart  
+
+      # For Configuration Options, please refer to:
+      # http://code.google.com/apis/chart/interactive/docs/gallery/areachart.html#Configuration_Options
+    end
+
+  end
+end

data/lib/google_visualr/interactive/bar_chart.rb

@@ -0,0 +1,13 @@
+module GoogleVisualr
+  module Interactive
+
+    # http://code.google.com/apis/chart/interactive/docs/gallery/barchart.html
+    class BarChart < BaseChart
+      include GoogleVisualr::Packages::CoreChart
+
+      # For Configuration Options, please refer to:
+      # http://code.google.com/apis/chart/interactive/docs/gallery/barchart.html#Configuration_Options
+    end
+
+  end
+end

data/lib/google_visualr/interactive/candlestick_chart.rb

@@ -0,0 +1,13 @@
+module GoogleVisualr
+  module Interactive
+
+    # http://code.google.com/apis/chart/interactive/docs/gallery/candlestickchart.html
+    class CandlestickChart < BaseChart
+      include GoogleVisualr::Packages::CoreChart
+
+      # For Configuration Options, please refer to:
+      # http://code.google.com/apis/chart/interactive/docs/gallery/candlestickchart.html#Configuration_Options
+    end
+
+  end
+end

data/lib/google_visualr/interactive/column_chart.rb

@@ -0,0 +1,13 @@
+module GoogleVisualr
+  module Interactive
+
+    # http://code.google.com/apis/chart/interactive/docs/gallery/columnchart.html
+    class ColumnChart < BaseChart
+      include GoogleVisualr::Packages::CoreChart
+
+      # For Configuration Options, please refer to:
+      # http://code.google.com/apis/chart/interactive/docs/gallery/columnchart.html#Configuration_Options
+    end
+
+  end
+end

data/lib/google_visualr/interactive/combo_chart.rb

@@ -0,0 +1,13 @@
+module GoogleVisualr
+  module Interactive
+
+    # http://code.google.com/apis/chart/interactive/docs/gallery/combochart.html
+    class ComboChart < BaseChart
+      include GoogleVisualr::Packages::CoreChart
+
+      # For Configuration Options, please refer to:
+      # http://code.google.com/apis/chart/interactive/docs/gallery/combochart.html#Configuration_Options
+    end
+
+  end
+end

data/lib/google_visualr/interactive/gauge.rb

@@ -0,0 +1,11 @@
+module GoogleVisualr
+  module Interactive
+
+    # http://code.google.com/apis/chart/interactive/docs/gallery/gauge.html
+    class Gauge < BaseChart
+      # For Configuration Options, please refer to:
+      # http://code.google.com/apis/chart/interactive/docs/gallery/gauge.html#Configuration_Options
+    end
+
+  end
+end

data/lib/google_visualr/interactive/geo_chart.rb

@@ -0,0 +1,11 @@
+module GoogleVisualr
+  module Interactive
+
+    # http://code.google.com/apis/chart/interactive/docs/gallery/geochart.html
+    class GeoChart < BaseChart
+      # For Configuration Options, please refer to:
+      # http://code.google.com/apis/chart/interactive/docs/gallery/geochart.html#Configuration_Options
+    end
+
+  end
+end

data/lib/google_visualr/interactive/intensity_map.rb

@@ -0,0 +1,11 @@
+module GoogleVisualr
+  module Interactive
+
+    # http://code.google.com/apis/chart/interactive/docs/gallery/intensitymap.html
+    class IntensityMap < BaseChart
+      # For Configuration Options, please refer to:
+      # http://code.google.com/apis/chart/interactive/docs/gallery/intensitymap.html#Configuration_Options
+    end
+
+  end  
+end

data/lib/google_visualr/interactive/line_chart.rb

@@ -0,0 +1,13 @@
+module GoogleVisualr
+  module Interactive
+
+    # http://code.google.com/apis/chart/interactive/docs/gallery/linechart.html
+    class LineChart < BaseChart
+      include GoogleVisualr::Packages::CoreChart
+
+      # For Configuration Options, please refer to:
+      # http://code.google.com/apis/chart/interactive/docs/gallery/linechart.html#Configuration_Options
+    end
+
+  end
+end

data/lib/google_visualr/interactive/map.rb

@@ -0,0 +1,11 @@
+module GoogleVisualr
+  module Interactive
+
+    # http://code.google.com/apis/chart/interactive/docs/gallery/map.html
+    class Map < BaseChart
+      # For Configuration Options, please refer to:
+      # http://code.google.com/apis/chart/interactive/docs/gallery/map.html#Configuration_Options
+    end
+    
+  end
+end

data/lib/google_visualr/interactive/motion_chart.rb

@@ -0,0 +1,11 @@
+module GoogleVisualr
+  module Interactive
+
+    # http://code.google.com/apis/chart/interactive/docs/gallery/motionchart.html
+    class MotionChart < BaseChart
+      # For Configuration Options, please refer to:
+      # http://code.google.com/apis/chart/interactive/docs/gallery/motionchart.html#Configuration_Options
+    end
+
+  end  
+end

data/lib/google_visualr/interactive/org_chart.rb

@@ -0,0 +1,11 @@
+module GoogleVisualr
+  module Interactive
+
+    # http://code.google.com/apis/chart/interactive/docs/gallery/orgchart.html
+    class OrgChart < BaseChart
+      # For Configuration Options, please refer to:
+      # http://code.google.com/apis/chart/interactive/docs/gallery/orgchart.html#Configuration_Options
+    end
+
+  end
+end

data/lib/google_visualr/interactive/pie_chart.rb

@@ -0,0 +1,13 @@
+module GoogleVisualr
+  module Interactive
+
+    # http://code.google.com/apis/chart/interactive/docs/gallery/piechart.html
+    class PieChart < BaseChart
+      include GoogleVisualr::Packages::CoreChart
+
+      # For Configuration Options, please refer to:
+      # http://code.google.com/apis/chart/interactive/docs/gallery/piechart.html#Configuration_Options
+    end
+
+  end
+end

data/lib/google_visualr/interactive/scatter_chart.rb

@@ -0,0 +1,13 @@
+module GoogleVisualr
+  module Interactive
+
+    # http://code.google.com/apis/chart/interactive/docs/gallery/scatterchart.html
+    class ScatterChart < BaseChart
+      include GoogleVisualr::Packages::CoreChart
+
+      # For Configuration Options, please refer to:
+      # http://code.google.com/apis/chart/interactive/docs/gallery/scatterchart.html#Configuration_Options
+    end
+
+  end
+end

data/lib/google_visualr/interactive/table.rb

@@ -0,0 +1,11 @@
+module GoogleVisualr
+  module Interactive
+
+    # http://code.google.com/apis/chart/interactive/docs/gallery/table.html
+    class Table < BaseChart
+      # For Configuration Options, please refer to:
+      # http://code.google.com/apis/chart/interactive/docs/gallery/table.html#Configuration_Options
+    end
+
+  end
+end

data/lib/google_visualr/interactive/treemap.rb

@@ -0,0 +1,11 @@
+module GoogleVisualr
+  module Interactive
+
+    # http://code.google.com/apis/chart/interactive/docs/gallery/treemap.html
+    class Treemap < BaseChart
+      # For Configuration Options, please refer to:
+      # http://code.google.com/apis/chart/interactive/docs/gallery/treemap.html#Configuration_Options
+    end
+
+  end
+end

data/lib/google_visualr/packages.rb

@@ -0,0 +1,30 @@
+module GoogleVisualr
+
+  module Packages
+
+    def package_name
+      self.class.to_s.split("::").last.downcase
+    end
+
+    def class_name
+      self.class.to_s.split('::').last
+    end
+
+    module CoreChart
+      def package_name
+        "corechart"
+      end
+    end
+
+    module ImageChart
+      def package_name
+        "image#{self.class.to_s.split("::").last.downcase}"
+      end
+      def class_name
+        "Image#{self.class.to_s.split('::').last}"
+      end
+    end
+
+  end
+
+end

data/lib/google_visualr/param_helpers.rb

@@ -0,0 +1,50 @@
+module GoogleVisualr
+
+  module ParamHelpers
+
+    def stringify_keys!(options)
+      options.keys.each do |key|
+        options[key.to_s] = options.delete(key)
+      end
+      options
+    end
+
+    def js_parameters(options)
+      return "" if options.nil?
+
+      attributes = options.collect { |(key, value)| "#{key}: #{typecast(value)}" }
+      "{" + attributes.join(", ") + "}"
+    end
+
+    # If the column type is 'string'    , the value should be a string.
+    # If the column type is 'number'    , the value should be a number.
+    # If the column type is 'boolean'   , the value should be a boolean.
+    # If the column type is 'date'      , the value should be a Date object.
+    # If the column type is 'datetime'  , the value should be a DateTime or Time object.
+    # If the column type is 'timeofday' , the value should be an array of three or four numbers: [hour, minute, second, optional milliseconds].
+    # Returns 'null' when value is nil.
+    # Recursive typecasting when value is a hash.
+    def typecast(value)
+      case
+        when value.is_a?(String)
+          return "'#{value.gsub(/[']/, '\\\\\'')}'"
+        when value.is_a?(Integer)   || value.is_a?(Float)
+          return value
+        when value.is_a?(TrueClass) || value.is_a?(FalseClass)
+          return "#{value}"
+        when value.is_a?(Date)
+          return "new Date(#{value.year}, #{value.month-1}, #{value.day})"
+        when value.is_a?(DateTime)  ||  value.is_a?(Time)
+          return "new Date(#{value.year}, #{value.month-1}, #{value.day}, #{value.hour}, #{value.min}, #{value.sec})"
+        when value.nil?
+          return "null"
+        when value.is_a?(Hash)
+          return js_parameters(value)
+        else
+          return value
+      end
+    end
+
+  end
+
+end

data/lib/google_visualr/version.rb

@@ -0,0 +1,3 @@
+module GoogleVisualr
+  VERSION = "2.0.0"
+end

data/spec/google_visualr/base_chart_spec.rb

@@ -0,0 +1,55 @@
+require 'spec_helper'
+
+describe GoogleVisualr::BaseChart do
+
+  def data_table
+
+    @cols = [
+              { :type => "string", :label => "Year"     },
+              { :type => "number", :label => "Sales"    },
+              { :type => "number", :label => "Expenses" }
+            ]
+    @rows = [
+              { :c => [ {:v => "2004"}, {:v => 1000}, {:v => 400} ] },
+              { :c => [ {:v => "2005"}, {:v => 1200}, {:v => 450} ] },
+              { :c => [ {:v => "2006"}, {:v => 1500}, {:v => 600} ] },
+              { :c => [ {:v => "2007"}, {:v => 800 }, {:v => 500} ] }
+            ]
+    GoogleVisualr::DataTable.new(:cols => @cols, :rows => @rows)
+
+  end
+
+  before do
+    @dt    = data_table
+    @chart = GoogleVisualr::BaseChart.new( @dt, { :legend => "Test Chart", :width =>  800, :is3D => true } )
+  end
+
+  describe "#initialize" do
+    it "works" do
+      @chart.data_table.should == @dt
+      @chart.options.should    == { "legend" => "Test Chart", "width" => 800, "is3D" => true }
+    end
+  end
+
+  describe "#options=" do
+    it "works" do
+      @chart.options = { :legend => "Awesome Chart", :width =>  1000, :is3D => false }
+      @chart.options.should    == { "legend" => "Awesome Chart", "width" => 1000, "is3D" => false }
+    end
+  end
+
+  describe "#to_js" do
+    it "generates JS" do
+      js = @chart.to_js("#body")
+      js.should_not be_nil
+      js.should match /DataTable/i
+      js.should match /addColumn/i
+      js.should match /addRow/i
+      js.should match /legend/i
+      js.should match /Test Chart/i
+      js.should match /width/i
+      js.should match /800/i
+    end
+  end
+
+end