gregoryfoster-gchartrb 0.9

data/scripts/iso3166_en_code_lists.txt

@@ -0,0 +1,250 @@
+Source: http://www.iso.org/iso/iso3166_en_code_lists.txt
+
+This list states the country names (official short names in English) in alphabetical order as given in ISO 3166-1 and the corresponding ISO 3166-1-alpha-2 code elements. The list is updated whenever a change to the official code list in ISO 3166-1 is effected by the ISO 3166/MA. It lists 240 official short names and code elements. One line of text contains one entry. A country name and its code element are separated by a semicolon (;).
+
+AFGHANISTAN;AF
+ÅLAND ISLANDS;AX
+ALBANIA;AL
+ALGERIA;DZ
+AMERICAN SAMOA;AS
+ANDORRA;AD
+ANGOLA;AO
+ANGUILLA;AI
+ANTARCTICA;AQ
+ANTIGUA AND BARBUDA;AG
+ARGENTINA;AR
+ARMENIA;AM
+ARUBA;AW
+AUSTRALIA;AU
+AUSTRIA;AT
+AZERBAIJAN;AZ
+BAHAMAS;BS
+BAHRAIN;BH
+BANGLADESH;BD
+BARBADOS;BB
+BELARUS;BY
+BELGIUM;BE
+BELIZE;BZ
+BENIN;BJ
+BERMUDA;BM
+BHUTAN;BT
+BOLIVIA;BO
+BOSNIA AND HERZEGOVINA;BA
+BOTSWANA;BW
+BOUVET ISLAND;BV
+BRAZIL;BR
+BRITISH INDIAN OCEAN TERRITORY;IO
+BRUNEI DARUSSALAM;BN
+BULGARIA;BG
+BURKINA FASO;BF
+BURUNDI;BI
+CAMBODIA;KH
+CAMEROON;CM
+CANADA;CA
+CAPE VERDE;CV
+CAYMAN ISLANDS;KY
+CENTRAL AFRICAN REPUBLIC;CF
+CHAD;TD
+CHILE;CL
+CHINA;CN
+CHRISTMAS ISLAND;CX
+COCOS (KEELING) ISLANDS;CC
+COLOMBIA;CO
+COMOROS;KM
+CONGO;CG
+CONGO, THE DEMOCRATIC REPUBLIC OF THE;CD
+COOK ISLANDS;CK
+COSTA RICA;CR
+CÔTE D'IVOIRE;CI
+CROATIA;HR
+CUBA;CU
+CYPRUS;CY
+CZECH REPUBLIC;CZ
+DENMARK;DK
+DJIBOUTI;DJ
+DOMINICA;DM
+DOMINICAN REPUBLIC;DO
+ECUADOR;EC
+EGYPT;EG
+EL SALVADOR;SV
+EQUATORIAL GUINEA;GQ
+ERITREA;ER
+ESTONIA;EE
+ETHIOPIA;ET
+FALKLAND ISLANDS (MALVINAS);FK
+FAROE ISLANDS;FO
+FIJI;FJ
+FINLAND;FI
+FRANCE;FR
+FRENCH GUIANA;GF
+FRENCH POLYNESIA;PF
+FRENCH SOUTHERN TERRITORIES;TF
+GABON;GA
+GAMBIA;GM
+GEORGIA;GE
+GERMANY;DE
+GHANA;GH
+GIBRALTAR;GI
+GREECE;GR
+GREENLAND;GL
+GRENADA;GD
+GUADELOUPE;GP
+GUAM;GU
+GUATEMALA;GT
+GUERNSEY;GG
+GUINEA;GN
+GUINEA-BISSAU;GW
+GUYANA;GY
+HAITI;HT
+HEARD ISLAND AND MCDONALD ISLANDS;HM
+HOLY SEE (VATICAN CITY STATE);VA
+HONDURAS;HN
+HONG KONG;HK
+HUNGARY;HU
+ICELAND;IS
+INDIA;IN
+INDONESIA;ID
+IRAN, ISLAMIC REPUBLIC OF;IR
+IRAQ;IQ
+IRELAND;IE
+ISLE OF MAN;IM
+ISRAEL;IL
+ITALY;IT
+JAMAICA;JM
+JAPAN;JP
+JERSEY;JE
+JORDAN;JO
+KAZAKHSTAN;KZ
+KENYA;KE
+KIRIBATI;KI
+KOREA, DEMOCRATIC PEOPLE'S REPUBLIC OF;KP
+KOREA, REPUBLIC OF;KR
+KUWAIT;KW
+KYRGYZSTAN;KG
+LAO PEOPLE'S DEMOCRATIC REPUBLIC;LA
+LATVIA;LV
+LEBANON;LB
+LESOTHO;LS
+LIBERIA;LR
+LIBYAN ARAB JAMAHIRIYA;LY
+LIECHTENSTEIN;LI
+LITHUANIA;LT
+LUXEMBOURG;LU
+MACAO;MO
+MACEDONIA, THE FORMER YUGOSLAV REPUBLIC OF;MK
+MADAGASCAR;MG
+MALAWI;MW
+MALAYSIA;MY
+MALDIVES;MV
+MALI;ML
+MALTA;MT
+MARSHALL ISLANDS;MH
+MARTINIQUE;MQ
+MAURITANIA;MR
+MAURITIUS;MU
+MAYOTTE;YT
+MEXICO;MX
+MICRONESIA, FEDERATED STATES OF;FM
+MOLDOVA, REPUBLIC OF;MD
+MONACO;MC
+MONGOLIA;MN
+MONTENEGRO;ME
+MONTSERRAT;MS
+MOROCCO;MA
+MOZAMBIQUE;MZ
+MYANMAR;MM
+NAMIBIA;NA
+NAURU;NR
+NEPAL;NP
+NETHERLANDS;NL
+NETHERLANDS ANTILLES;AN
+NEW CALEDONIA;NC
+NEW ZEALAND;NZ
+NICARAGUA;NI
+NIGER;NE
+NIGERIA;NG
+NIUE;NU
+NORFOLK ISLAND;NF
+NORTHERN MARIANA ISLANDS;MP
+NORWAY;NO
+OMAN;OM
+PAKISTAN;PK
+PALAU;PW
+PALESTINIAN TERRITORY, OCCUPIED;PS
+PANAMA;PA
+PAPUA NEW GUINEA;PG
+PARAGUAY;PY
+PERU;PE
+PHILIPPINES;PH
+PITCAIRN;PN
+POLAND;PL
+PORTUGAL;PT
+PUERTO RICO;PR
+QATAR;QA
+REUNION;RE
+ROMANIA;RO
+RUSSIAN FEDERATION;RU
+RWANDA;RW
+SAINT BARTHÉLEMY;BL
+SAINT HELENA;SH
+SAINT KITTS AND NEVIS;KN
+SAINT LUCIA;LC
+SAINT MARTIN;MF
+SAINT PIERRE AND MIQUELON;PM
+SAINT VINCENT AND THE GRENADINES;VC
+SAMOA;WS
+SAN MARINO;SM
+SAO TOME AND PRINCIPE;ST
+SAUDI ARABIA;SA
+SENEGAL;SN
+SERBIA;RS
+SEYCHELLES;SC
+SIERRA LEONE;SL
+SINGAPORE;SG
+SLOVAKIA;SK
+SLOVENIA;SI
+SOLOMON ISLANDS;SB
+SOMALIA;SO
+SOUTH AFRICA;ZA
+SOUTH GEORGIA AND THE SOUTH SANDWICH ISLANDS;GS
+SPAIN;ES
+SRI LANKA;LK
+SUDAN;SD
+SURINAME;SR
+SVALBARD AND JAN MAYEN;SJ
+SWAZILAND;SZ
+SWEDEN;SE
+SWITZERLAND;CH
+SYRIAN ARAB REPUBLIC;SY
+TAIWAN, PROVINCE OF CHINA;TW
+TAJIKISTAN;TJ
+TANZANIA, UNITED REPUBLIC OF;TZ
+THAILAND;TH
+TIMOR-LESTE;TL
+TOGO;TG
+TOKELAU;TK
+TONGA;TO
+TRINIDAD AND TOBAGO;TT
+TUNISIA;TN
+TURKEY;TR
+TURKMENISTAN;TM
+TURKS AND CAICOS ISLANDS;TC
+TUVALU;TV
+UGANDA;UG
+UKRAINE;UA
+UNITED ARAB EMIRATES;AE
+UNITED KINGDOM;GB
+UNITED STATES;US
+UNITED STATES MINOR OUTLYING ISLANDS;UM
+URUGUAY;UY
+UZBEKISTAN;UZ
+VANUATU;VU
+VENEZUELA;VE
+VIET NAM;VN
+VIRGIN ISLANDS, BRITISH;VG
+VIRGIN ISLANDS, U.S.;VI
+WALLIS AND FUTUNA;WF
+WESTERN SAHARA;EH
+YEMEN;YE
+ZAMBIA;ZM
+ZIMBABWE;ZW

data/scripts/process_country_codes.rb

@@ -0,0 +1,27 @@
+#!/usr/bin/env ruby
+
+# Constants.
+USAGE = 'ruby process_country_codes.rb [input_filename]'
+COUNTRY_CODE_REGEX = /^.+;(\w{2})$/    # Regex to pull country code.
+ROW_SEPARATOR = "\n"
+
+
+#
+# Main Program.
+#
+# Read command-line arguments.
+unless ARGV.length == 1
+  puts USAGE
+  exit
+end
+
+input_filename = File.dirname(__FILE__) + '/' + ARGV[0]
+
+# Process the file contents line by line.
+country_codes = []
+IO.foreach(input_filename, ROW_SEPARATOR) do |line|
+  match = line.match(COUNTRY_CODE_REGEX)
+  country_codes << match[1].to_sym unless match.nil?
+end
+
+puts "[ :#{country_codes.join(', :')} ]"

data/spec/gchartrb/axis_spec.rb

@@ -0,0 +1,125 @@
+require File.expand_path("#{File.dirname(__FILE__)}/../helper")
+
+describe GoogleChart::Axis do
+  before(:each) do
+    @chart = GoogleChart::LineChart.new
+    @chart.data "Series 1", [1,2,3,4,5], "ff00ff"
+    @valid_axis_params = {
+                          :color => "ff00ff" ,
+                          :font_size => 15,
+                          :alignment => :center,
+                          :range     => 0..500,
+                          :labels    => ["a","b","c"],
+                          :positions => [100,200,400]
+                          }
+  end
+
+  it "is supported by LineChart, LineXYChart, BarChart, ScatterPlot and SparklineChart" do
+    [GoogleChart::LineChart, GoogleChart::LineXYChart,
+    GoogleChart::BarChart, GoogleChart::ScatterPlot, GoogleChart::SparklineChart].each do |klass|
+      klass.new.should respond_to(:axis)
+    end
+  end
+
+  it "throws ArgumentError if the the fill method is called with an invalid position type" do
+    lambda { @chart.axis(:gibberish) }.should raise_error(ArgumentError)
+  end
+
+  it "should be able to initialise the properties from within a block" do
+    @chart.axis(:top) do |axis|
+      axis.color     = "ff00ff"
+      axis.font_size = 15
+      axis.alignment = :center
+      axis.range     = 0..500
+      axis.labels    = ["a","b","c"]
+      axis.positions = [100,200,400]
+    end
+    @chart.query_params[:chxt].should eql("t")
+    @chart.query_params[:chxs].should eql("0,ff00ff,15,0")
+    @chart.query_params[:chxl].should eql("0:|a|b|c")
+    @chart.query_params[:chxp].should eql("0,100,200,400")
+    @chart.query_params[:chxr].should eql("0,0,500")
+  end
+
+  it "should raise error if color is not a string (unless it is nil)" do
+    params = @valid_axis_params.except(:color, :font_size, :alignment)
+    lambda { @chart.axis(:top, params) }.should_not raise_error(ArgumentError)
+
+    params[:color] = 35
+    lambda { @chart.axis(:top, params) }.should raise_error(ArgumentError)
+  end
+
+  it "should raise error if font_size is not a number (unless it is nil)" do
+    params = @valid_axis_params.except(:font_size, :alignment)
+    lambda { @chart.axis(:top, params) }.should_not raise_error(ArgumentError)
+
+    params[:font_size] = "hi"
+    lambda { @chart.axis(:top, params) }.should raise_error(ArgumentError)
+  end
+
+  it "should raise error if range does not belong to class range and is not numeric (unless it is nil)" do
+    params = @valid_axis_params.except(:range)
+    lambda { @chart.axis(:top, params) }.should_not raise_error(ArgumentError)
+
+    params[:range] = "hi"
+    lambda { @chart.axis(:top, params) }.should raise_error(ArgumentError)
+  end
+
+  it "should raise error if labels is not an array (and is not nil)" do
+    params = @valid_axis_params.except(:labels, :positions)
+    lambda { @chart.axis(:top, params) }.should_not raise_error(ArgumentError)
+
+    params[:labels] = "hi"
+    lambda { @chart.axis(:top, params) }.should raise_error(ArgumentError)
+  end
+
+  it "should raise error if positions is not numeric array" do
+    params = @valid_axis_params.except(:positions)
+    lambda { @chart.axis(:top, params) }.should_not raise_error(ArgumentError)
+
+    params[:positions] =  %w(a b c)
+    lambda { @chart.axis(:top, params) }.should raise_error(ArgumentError)
+
+    params[:positions] = "hi"
+    lambda { @chart.axis(:top, params) }.should raise_error(ArgumentError)
+  end
+
+  it "should raise error if the number of elements for labels and positions are not the same (unless they are nil)" do
+    params = @valid_axis_params.except(:labels)
+    params[:labels] =  %w(a b c d)
+    lambda { @chart.axis(:top, params) }.should raise_error(ArgumentError)
+
+    params[:labels] = nil
+    lambda { @chart.axis(:top, params) }.should_not raise_error(ArgumentError)
+
+    params = @valid_axis_params.except(:labels, :positions)
+    lambda { @chart.axis(:top, params) }.should_not raise_error(ArgumentError)
+  end
+
+  it "should raise error if font_size is given without color" do
+    params = @valid_axis_params.except(:color, :alignment)
+    lambda { @chart.axis(:top, params) }.should raise_error(ArgumentError)
+  end
+
+  it "should raise error if alignment is given without a font size and color" do
+    params = @valid_axis_params.except(:color, :font_size)
+    lambda { @chart.axis(:top, params) }.should raise_error(ArgumentError)
+  end
+
+  it "should raise error if an invalid alignment is given (unless it is nil)" do
+    params = @valid_axis_params.except(:alignment)
+    lambda { @chart.axis(:top, params) }.should_not raise_error(ArgumentError)
+
+    params[:alignment] = :gibberish
+    lambda { @chart.axis(:top, params) }.should raise_error(ArgumentError)
+  end
+
+  it "should raise an error if both position and range are given and the positions are not in range" do
+    params = @valid_axis_params.except(:positions, :range)
+    params[:positions] = [0,1,2]
+    lambda { @chart.axis(:top, params) }.should_not raise_error(ArgumentError)
+    params[:range] = 100..200
+    lambda { @chart.axis(:top, params) }.should raise_error(ArgumentError)
+  end
+
+end

data/spec/gchartrb/bar_chart_spec.rb

@@ -0,0 +1,128 @@
+require File.expand_path("#{File.dirname(__FILE__)}/../helper")
+
+module BarChartHelper
+  def add_valid_data(chart)
+    chart.data "Series 1", [1,2,3,4,5]
+  end
+end
+
+describe GoogleChart::BarChart do
+  include BarChartHelper
+
+  before(:each) { @bar = GoogleChart::BarChart.new }
+  it "should have the default type as bvg" do
+    @bar.chart_type.should == "bvg"
+  end
+
+  it "should raise error when the data is not an array of numeric" do
+    lambda { @bar.data("Series 1", [[1,2],[2,3]]) } .should raise_error(ArgumentError)
+  end
+
+  it "should have legend support" do
+    @bar.respond_to?(:legend, true).should be_true
+  end
+
+  it "should support orientation" do
+    lambda { @bar.orientation = :horizontal }.should_not raise_error(NoMethodError)
+    lambda { @bar.orientation = :vertical }.should_not raise_error(NoMethodError)
+    lambda { @bar.orientation = :gibberish }.should raise_error(ArgumentError)
+  end
+
+  it "should support grouping" do
+    lambda { @bar.grouping = :grouped }.should_not raise_error(NoMethodError)
+    lambda { @bar.grouping = :stacked }.should_not raise_error(NoMethodError)
+    lambda { @bar.grouping = :gibberish }.should raise_error(ArgumentError)
+  end
+
+  it "should change chart type on changes in orientation and grouping" do
+    @bar.grouping    = :stacked
+    @bar.orientation = :vertical
+    @bar.chart_type.should be_eql("bvs")
+
+    @bar.grouping    = :stacked
+    @bar.orientation = :horizontal
+    @bar.chart_type.should be_eql("bhs")
+
+    @bar.grouping    = :grouped
+    @bar.orientation = :vertical
+    @bar.chart_type.should be_eql("bvg")
+
+    @bar.grouping    = :grouped
+    @bar.orientation = :horizontal
+    @bar.chart_type.should be_eql("bhg")
+  end
+
+  it "should support bar width in charts" do
+    add_valid_data(@bar)
+    @bar.bar_width = 5
+    @bar.query_params[:chbh].should == "5"
+  end
+
+  it "should raise error if bar width is not an integer" do
+    add_valid_data(@bar)
+    lambda { @bar.bar_width = "hi" }.should raise_error(ArgumentError)
+  end
+
+  it "support bar spacing (within a group)" do
+    add_valid_data(@bar)
+    @bar.bar_width = 5
+    @bar.bar_spacing = 5
+    @bar.query_params[:chbh].should == "5,5"
+  end
+
+  it "should raise error if bar spacing is not an integer" do
+    add_valid_data(@bar)
+    @bar.bar_width = 5
+    lambda { @bar.bar_spacing = "hi" }.should raise_error(ArgumentError)
+  end
+
+  it "should not support bar spacing without bar width" do
+    add_valid_data(@bar)
+    lambda { @bar.bar_spacing = 5 }.should raise_error(ArgumentError)
+  end
+
+  it "support group spacing" do
+    add_valid_data(@bar)
+    @bar.bar_width = 5
+    @bar.bar_spacing = 5
+    @bar.group_spacing = 5
+    @bar.query_params[:chbh].should == "5,5,5"
+  end
+
+  it "should raise error if group spacing is not an integer" do
+    add_valid_data(@bar)
+    @bar.bar_width = 5
+    @bar.bar_spacing = 5
+    lambda { @bar.group_spacing = "hi" }.should raise_error(ArgumentError)
+  end
+
+  it "should not support group spacing without bar width and bar spacing" do
+    add_valid_data(@bar)
+    lambda { @bar.group_spacing = 5 }.should raise_error(ArgumentError)
+    @bar.bar_width = 5
+    lambda { @bar.group_spacing = 5 }.should raise_error(ArgumentError)
+  end
+
+  it "should encode properly encode the max value for the stacked bar chart" do
+    @bar.orientation = :vertical
+    @bar.grouping = :stacked
+    @bar.encoding = :extended
+    @bar.data "2^i", (0..8).to_a.collect{|i| 2**i}, "ff0000"
+    @bar.data "2.1^i", (0..8).to_a.collect{|i| 2.1**i}, "00ff00"
+    @bar.data "2.2^i", (0..8).to_a.collect{|i| 2.2**i}, "0000ff"
+    @bar.query_params[:chd].starts_with?("e:ADAHAOAcA3BvDeG7N2").should be_true
+    @bar.max.should == (2**8 + 2.1**8 + 2.2**8)
+  end
+
+  it "should use the max value as an override if it is specified already" do
+    @bar.orientation = :vertical
+    @bar.grouping = :stacked
+    @bar.encoding = :extended
+    @bar.data "2^i", (0..8).to_a.collect{|i| 2**i}, "ff0000"
+    @bar.data "2.1^i", (0..8).to_a.collect{|i| 2.1**i}, "00ff00"
+    @bar.data "2.2^i", (0..8).to_a.collect{|i| 2.2**i}, "0000ff"
+    @bar.max = (2**8 + 2.1**8 + 2.2**8) * 2
+    @bar.query_params[:chd].starts_with?("e:ADAHAOAcA3BvDeG7N2").should be_false
+    @bar.max.should_not == (2**8 + 2.1**8 + 2.2**8)
+  end
+end