worldbank_as_dataframe 0.1.0

data/lib/worldbank_as_dataframe/query.rb

@@ -0,0 +1,213 @@
+module WorldbankAsDataframe
+
+  class Query
+
+    attr_reader :pages, :total
+
+    def initialize(name, id, model)
+      @model = model
+      @name = name
+      @id = id
+      @lang = false
+      @raw = false
+      @new = true
+      @query = {:params => {:format => :json}, :dirs => []}
+      @param_dir = []
+    end
+
+    #
+    # the date param is expressed as a range 'StartDate:EndDate'
+    # Date may be year & month, year & quarter, or just year
+    # Date will convert any Date/Time object to an apporpriate year & month
+    #
+    def dates(date_range)
+      if date_range.is_a? String
+
+        # assume the user knows what she is doing if passed a string
+        @query[:params][:date] = date_range
+      elsif date_range.is_a? Range
+        start = date_range.first
+        last = date_range.last
+        @query[:params][:date] = "#{start.strftime("%YM%m")}:#{last.strftime("%YM%m")}"
+      end
+      self
+    end
+
+    def format(format)
+      @query[:params][:format] = format
+      self
+    end
+
+    def raw
+      @raw = true
+      self
+    end
+
+    def id(id)
+      @query[:params][:id] = id
+      self
+    end
+
+    #
+    # Most Recent Values param has two optional params
+    # Gap fill will specify how many items to add if there isn't enough data for you query
+    # Frequency sets how frequent the data sets are...
+    # An example is best to explain this:
+    # I want the 5 most recent yearly values between 2000 and 2010,
+    #   but I need at least three data sets to continue. My query would look like this:
+    #   .dates('2000:2010').most_recent_values(:gap_fill => 3, :frequency => 'Y')
+    #
+    def most_recent_values(num, options={})
+      @query[:params][:gapFill] = options[:gap_fill] if options[:gap_fill]
+      @query[:params][:frequency] = options[:frequency] if options[:frequency]
+      @query[:params][:MRV] = num
+      self
+    end
+
+    def per_page(num=false)
+      if num
+        @query[:params][:per_page] = num
+        self
+      else
+        @per_page || @query[:params][:per_page] || 50
+      end
+    end
+
+    def page(num=false)
+      if num
+        @query[:params][:page] = num
+        self
+      else
+        @page || @query[:params][:page] || 1
+      end
+    end
+
+    def next
+      if @query[:params][:page].nil?
+        @query[:params][:page] = 2
+      else
+        @query[:params][:page] += 1
+      end
+      self
+    end
+
+    def language(lang)
+      if lang.to_s.length == 2
+        @lang = lang.to_s.downcase
+      else
+        @lang = [ ['french', 'fr'],
+          ['spanish', 'es'],
+          ['english', 'en'],
+          ['arabic', 'ar']  ].assoc(lang.to_s.downcase)[1]
+      end
+      self
+    end
+
+    def cycle
+      @cycle_results = @pages.nil? ? fetch : []
+      (@pages - self.page).times do
+        @cycle_results += self.next.fetch
+      end
+      @cycle_results
+    end
+
+    def fetch
+      if @new
+        @query[:dirs].push @name
+        @query[:dirs].push @id
+        @query[:dirs].unshift @lang if @lang
+        @query[:params][:format] ||= :json
+        @new = false
+      end
+      @query[:dirs] = @param_dir + @query[:dirs] unless @param_dir.empty?
+      client = WorldbankAsDataframe::Client.new(@query, @raw)
+      results = client.get_query
+    
+      results = parse results unless (results.nil? || @raw)
+      
+      results.nil? ? nil : results
+    end
+
+protected
+
+    def parse(results)
+      update_fetch_info(results[0])
+      if @id =~ /all/ || @model == WorldbankAsDataframe::Data
+        results = results[1].map { |result| @model.new result }
+      else
+        results = @model.new results[1][0]
+      end
+      results
+    end
+
+    def update_fetch_info(meta_info)
+      @page = meta_info['page'].to_i
+      @per_page = meta_info['per_page'].to_i
+      @pages = meta_info['pages'].to_i
+      @total = meta_info['total'].to_i
+    end
+
+    def indifferent_number(possibly_multiple_args)
+      parsed = if possibly_multiple_args.is_a?(Array)
+        arr = possibly_multiple_args.map do |arg|
+          indifferent_type(arg)
+        end
+        arr.join(';')
+      else
+        indifferent_type(possibly_multiple_args)
+      end
+      parsed
+    end
+
+    def indifferent_type(arg)
+      parsed = ''
+      unless arg.is_a?(String) || arg.is_a?(Numeric)
+        parsed = arg.id
+      else
+        parsed = arg
+      end
+      parsed
+    end
+
+    def ensure_country_id(id)
+      @country_id = id
+      if @country_id.length > 3
+        @matching = WorldbankAsDataframe::Country.country_aliases.select do |country|
+          country[2] =~ Regexp.new(@country_id)
+        end
+        if @matching.length > 1
+          raise ArgumentError,
+            "More than one country code matched '#{@country_id}'. Perhaps you meant one of #{@matching.join(', ')}?",
+            caller
+        elsif @matching.length == 0
+          raise ArgumentError,
+            "No countries matched '#{@country_id}', please try again.",
+            caller
+        else
+          @country_id = @matching[0][0]
+        end
+      end
+      @country_id
+    end
+
+    def indifferent_nums(args)
+      parsed = ''
+      if args.is_a? Array
+        parsed = args.map! do |arg|
+          arg = normalize_country_id arg
+          arg = ensure_country_id arg
+        end.join(';')
+      else
+        args = normalize_country_id args
+        parsed = ensure_country_id args
+      end
+      parsed
+    end
+
+    def normalize_country_id(id)
+        id.gsub!(/[ -]/, '_')
+        id.downcase
+    end
+  end
+end
+

data/lib/worldbank_as_dataframe/region.rb

@@ -0,0 +1,22 @@
+module WorldbankAsDataframe
+  class Region
+
+    attr_reader :raw, :id, :name, :code, :type
+
+    def self.all
+      find('all')
+    end
+
+    def self.find(id)
+      WorldbankAsDataframe::ParamQuery.new('regions', id, self)
+    end
+
+    def initialize(values={})
+      @raw = values
+      @id = values['id']
+      @code = values['code']
+      @name = values['name']
+      @type = 'regions'
+    end
+  end
+end

data/lib/worldbank_as_dataframe/source.rb

@@ -0,0 +1,25 @@
+module WorldbankAsDataframe
+
+  class Source
+
+    attr_reader :raw, :id, :name, :description, :url, :type
+
+    def self.all
+      find('all')
+    end
+
+    def self.find(id)
+      WorldbankAsDataframe::ParamQuery.new('sources', id, self)
+    end
+
+    def initialize(values={})
+      @raw = values
+      @id = values['id']
+      @name = values['name']
+      @description = values['description']
+      @url = values['url']
+      @type = 'sources'
+    end
+  end
+
+end

data/lib/worldbank_as_dataframe/topic.rb

@@ -0,0 +1,25 @@
+module WorldbankAsDataframe
+
+  class Topic
+
+    attr_reader :raw, :id, :name, :note, :type
+
+    def self.all
+      find('all')
+    end
+
+    def self.find(id)
+      WorldbankAsDataframe::ParamQuery.new('topics', id, self)
+    end
+
+    def initialize(values={})
+      @raw = values
+      @id = values['id']
+      @name = values['value']
+      @note = values['sourceNote']
+      @type = 'topics'
+    end
+
+  end
+
+end

data/lib/worldbank_as_dataframe/version.rb

@@ -0,0 +1,3 @@
+module WorldbankAsDataframe
+  VERSION = "0.1.0"
+end

data/lib/worldbank_as_dataframe.rb

@@ -0,0 +1,21 @@
+require File.expand_path(File.join(File.dirname(__FILE__), '/worldbank_as_dataframe/client'))
+
+module WorldbankAsDataframe
+
+  def self.client(query={}, raw=false)
+      defaults = {:params => {:format => :json}, :dirs => []}
+      defaults.merge!(query)
+      WorldbankAsDataframe::Client.new(defaults, raw)
+    end
+
+    # Delegate to WorldbankAsDataframe::Client.new
+    def self.method_missing(method, *args, &block)
+      return super unless client.respond_to?(method)
+      client.send(method, *args, &block)
+    end
+
+    def self.respond_to?(method, include_private=false)
+      client.respond_to?(method, include_private) || super(method, include_private)
+    end
+
+end

data/spec/fixtures/brazil.json

@@ -0,0 +1,43 @@
+[
+
+    -
+    {
+        page: 1
+        pages: 1
+        per_page: "50"
+        total: 1
+    }
+    -
+    [
+        -
+        {
+            id: "BRA"
+            iso2Code: "BR"
+            name: "Brazil"
+            -
+            region: {
+                id: "LCN"
+                value: "Latin America & Caribbean (all income levels)"
+            }
+            -
+            adminregion: {
+                id: "LAC"
+                value: "Latin America & Caribbean (developing only)"
+            }
+            -
+            incomeLevel: {
+                id: "UMC"
+                value: "Upper middle income"
+            }
+            -
+            lendingType: {
+                id: "IBD"
+                value: "IBRD"
+            }
+            capitalCity: "Brasilia"
+            longitude: "-47.9292"
+            latitude: "-15.7801"
+        }
+    ]
+
+]

data/spec/fixtures/countries.json

@@ -0,0 +1,2 @@
+[{"page":1,"pages":5,"per_page":"50","total":240},[{"id":"ABW","iso2Code":"AW","name":"Aruba","region":{"id":"LCN","value":"Latin America & Caribbean (all income levels)"},"adminregion":{"id":"","value":""},"incomeLevel":{"id":"NOC","value":"High income: nonOECD"},"lendingType":{"id":"NC","value":"Not classified"},"capitalCity":"Oranjestad","longitude":"-70.0167","latitude":"12.5167"},{"id":"AFG","iso2Code":"AF","name":"Afghanistan","region":{"id":"SAS","value":"South Asia"},"adminregion":{"id":"SAS","value":"South Asia"},"incomeLevel":{"id":"LIC","value":"Low income"},"lendingType":{"id":"IDX","value":"IDA"},"capitalCity":"Kabul","longitude":"69.1761","latitude":"34.5228"},{"id":"AGO","iso2Code":"AO","name":"Angola","region":{"id":"SSF","value":"Sub-Saharan Africa (all income levels)"},"adminregion":{"id":"SSA","value":"Sub-Saharan Africa (developing only)"},"incomeLevel":{"id":"LMC","value":"Lower middle income"},"lendingType":{"id":"IDX","value":"IDA"},"capitalCity":"Luanda","longitude":"13.242","latitude":"-8.81155"},{"id":"ALB","iso2Code":"AL","name":"Albania","region":{"id":"ECS","value":"Europe & Central Asia (all income levels)"},"adminregion":{"id":"ECA","value":"Europe & Central Asia (developing only)"},"incomeLevel":{"id":"UMC","value":"Upper middle income"},"lendingType":{"id":"IBD","value":"IBRD"},"capitalCity":"Tirane","longitude":"19.8172","latitude":"41.3317"},{"id":"AND","iso2Code":"AD","name":"Andorra","region":{"id":"ECS","value":"Europe & Central Asia (all income levels)"},"adminregion":{"id":"","value":""},"incomeLevel":{"id":"NOC","value":"High income: nonOECD"},"lendingType":{"id":"NC","value":"Not classified"},"capitalCity":"Andorra la Vella","longitude":"1.5218","latitude":"42.5075"},{"id":"ANT","iso2Code":"AN","name":"Netherlands Antilles","region":{"id":"LCN","value":"Latin America & Caribbean (all income levels)"},"adminregion":{"id":"","value":""},"incomeLevel":{"id":"NOC","value":"High income: nonOECD"},"lendingType":{"id":"NC","value":"Not classified"},"capitalCity":"Willemstad","longitude":"-68.9335","latitude":"12.1034"},{"id":"ARB","iso2Code":"1A","name":"Arab World","region":{"id":"NA","value":"Aggregates"},"adminregion":{"id":"","value":""},"incomeLevel":{"id":"NA","value":"Aggregates"},"lendingType":{"id":"","value":"Aggregates"},"capitalCity":"","longitude":"","latitude":""},{"id":"ARE","iso2Code":"AE","name":"United Arab Emirates","region":{"id":"MEA","value":"Middle East & North Africa (all income levels)"},"adminregion":{"id":"","value":""},"incomeLevel":{"id":"NOC","value":"High income: nonOECD"},"lendingType":{"id":"NC","value":"Not classified"},"capitalCity":"Abu Dhabi","longitude":"54.3705","latitude":"24.4764"},{"id":"ARG","iso2Code":"AR","name":"Argentina","region":{"id":"LCN","value":"Latin America & Caribbean (all income levels)"},"adminregion":{"id":"LAC","value":"Latin America & Caribbean (developing only)"},"incomeLevel":{"id":"UMC","value":"Upper middle income"},"lendingType":{"id":"IBD","value":"IBRD"},"capitalCity":"Buenos Aires","longitude":"-58.4173","latitude":"-34.6118"},{"id":"ARM","iso2Code":"AM","name":"Armenia","region":{"id":"ECS","value":"Europe & Central Asia (all income levels)"},"adminregion":{"id":"ECA","value":"Europe & Central Asia (developing only)"},"incomeLevel":{"id":"LMC","value":"Lower middle income"},"lendingType":{"id":"IDB","value":"Blend"},"capitalCity":"Yerevan","longitude":"44.509","latitude":"40.1596"},{"id":"ASM","iso2Code":"AS","name":"American Samoa","region":{"id":"EAS","value":"East Asia & Pacific (all income levels)"},"adminregion":{"id":"EAP","value":"East Asia & Pacific (developing only)"},"incomeLevel":{"id":"UMC","value":"Upper middle income"},"lendingType":{"id":"NC","value":"Not classified"},"capitalCity":"Pago Pago","longitude":"-170.691","latitude":"-14.2846"},{"id":"ATG","iso2Code":"AG","name":"Antigua and Barbuda","region":{"id":"LCN","value":"Latin America & Caribbean (all income levels)"},"adminregion":{"id":"LAC","value":"Latin America & Caribbean (developing only)"},"incomeLevel":{"id":"UMC","value":"Upper middle income"},"lendingType":{"id":"IBD","value":"IBRD"},"capitalCity":"Saint John's","longitude":"-61.8456","latitude":"17.1175"},{"id":"AUS","iso2Code":"AU","name":"Australia","region":{"id":"EAS","value":"East Asia & Pacific (all income levels)"},"adminregion":{"id":"","value":""},"incomeLevel":{"id":"OEC","value":"High income: OECD"},"lendingType":{"id":"NC","value":"Not classified"},"capitalCity":"Canberra","longitude":"149.129","latitude":"-35.282"},{"id":"AUT","iso2Code":"AT","name":"Austria","region":{"id":"ECS","value":"Europe & Central Asia (all income levels)"},"adminregion":{"id":"","value":""},"incomeLevel":{"id":"OEC","value":"High income: OECD"},"lendingType":{"id":"NC","value":"Not classified"},"capitalCity":"Vienna","longitude":"16.3798","latitude":"48.2201"},{"id":"AZE","iso2Code":"AZ","name":"Azerbaijan","region":{"id":"ECS","value":"Europe & Central Asia (all income levels)"},"adminregion":{"id":"ECA","value":"Europe & Central Asia (developing only)"},"incomeLevel":{"id":"UMC","value":"Upper middle income"},"lendingType":{"id":"IDB","value":"Blend"},"capitalCity":"Baku","longitude":"49.8932","latitude":"40.3834"},{"id":"BDI","iso2Code":"BI","name":"Burundi","region":{"id":"SSF","value":"Sub-Saharan Africa (all income levels)"},"adminregion":{"id":"SSA","value":"Sub-Saharan Africa (developing only)"},"incomeLevel":{"id":"LIC","value":"Low income"},"lendingType":{"id":"IDX","value":"IDA"},"capitalCity":"Bujumbura","longitude":"29.3639","latitude":"-3.3784"},{"id":"BEL","iso2Code":"BE","name":"Belgium","region":{"id":"ECS","value":"Europe & Central Asia (all income levels)"},"adminregion":{"id":"","value":""},"incomeLevel":{"id":"OEC","value":"High income: OECD"},"lendingType":{"id":"NC","value":"Not classified"},"capitalCity":"Brussels","longitude":"4.36761","latitude":"50.8371"},{"id":"BEN","iso2Code":"BJ","name":"Benin","region":{"id":"SSF","value":"Sub-Saharan Africa (all income levels)"},"adminregion":{"id":"SSA","value":"Sub-Saharan Africa (developing only)"},"incomeLevel":{"id":"LIC","value":"Low income"},"lendingType":{"id":"IDX","value":"IDA"},"capitalCity":"Porto-Novo","longitude":"2.6323","latitude":"6.4779"},{"id":"BFA","iso2Code":"BF","name":"Burkina Faso","region":{"id":"SSF","value":"Sub-Saharan Africa (all income levels)"},"adminregion":{"id":"SSA","value":"Sub-Saharan Africa (developing only)"},"incomeLevel":{"id":"LIC","value":"Low income"},"lendingType":{"id":"IDX","value":"IDA"},"capitalCity":"Ouagadougou","longitude":"-1.53395","latitude":"12.3605"},{"id":"BGD","iso2Code":"BD","name":"Bangladesh","region":{"id":"SAS","value":"South Asia"},"adminregion":{"id":"SAS","value":"South Asia"},"incomeLevel":{"id":"LIC","value":"Low income"},"lendingType":{"id":"IDX","value":"IDA"},"capitalCity":"Dhaka","longitude":"90.4113","latitude":"23.7055"},{"id":"BGR","iso2Code":"BG","name":"Bulgaria","region":{"id":"ECS","value":"Europe & Central Asia (all income levels)"},"adminregion":{"id":"ECA","value":"Europe & Central Asia (developing only)"},"incomeLevel":{"id":"UMC","value":"Upper middle income"},"lendingType":{"id":"IBD","value":"IBRD"},"capitalCity":"Sofia","longitude":"23.3238","latitude":"42.7105"},{"id":"BHR","iso2Code":"BH","name":"Bahrain","region":{"id":"MEA","value":"Middle East & North Africa (all income levels)"},"adminregion":{"id":"","value":""},"incomeLevel":{"id":"NOC","value":"High income: nonOECD"},"lendingType":{"id":"NC","value":"Not classified"},"capitalCity":"Manama","longitude":"50.5354","latitude":"26.1921"},{"id":"BHS","iso2Code":"BS","name":"Bahamas, The","region":{"id":"LCN","value":"Latin America & Caribbean (all income levels)"},"adminregion":{"id":"","value":""},"incomeLevel":{"id":"NOC","value":"High income: nonOECD"},"lendingType":{"id":"NC","value":"Not classified"},"capitalCity":"Nassau","longitude":"-77.339","latitude":"25.0661"},{"id":"BIH","iso2Code":"BA","name":"Bosnia and Herzegovina","region":{"id":"ECS","value":"Europe & Central Asia (all income levels)"},"adminregion":{"id":"ECA","value":"Europe & Central Asia (developing only)"},"incomeLevel":{"id":"UMC","value":"Upper middle income"},"lendingType":{"id":"IDB","value":"Blend"},"capitalCity":"Sarajevo","longitude":"18.4214","latitude":"43.8607"},{"id":"BLR","iso2Code":"BY","name":"Belarus","region":{"id":"ECS","value":"Europe & Central Asia (all income levels)"},"adminregion":{"id":"ECA","value":"Europe & Central Asia (developing only)"},"incomeLevel":{"id":"UMC","value":"Upper middle income"},"lendingType":{"id":"IBD","value":"IBRD"},"capitalCity":"Minsk","longitude":"27.5766","latitude":"53.9678"},{"id":"BLZ","iso2Code":"BZ","name":"Belize","region":{"id":"LCN","value":"Latin America & Caribbean (all income levels)"},"adminregion":{"id":"LAC","value":"Latin America & Caribbean (developing only)"},"incomeLevel":{"id":"LMC","value":"Lower middle income"},"lendingType":{"id":"IBD","value":"IBRD"},"capitalCity":"Belmopan","longitude":"-88.7713","latitude":"17.2534"},{"id":"BMU","iso2Code":"BM","name":"Bermuda","region":{"id":"NAC","value":"North America"},"adminregion":{"id":"","value":""},"incomeLevel":{"id":"NOC","value":"High income: nonOECD"},"lendingType":{"id":"NC","value":"Not classified"},"capitalCity":"Hamilton","longitude":"-64.706","latitude":"32.3293"},{"id":"BOL","iso2Code":"BO","name":"Bolivia","region":{"id":"LCN","value":"Latin America & Caribbean (all income levels)"},"adminregion":{"id":"LAC","value":"Latin America & Caribbean (developing only)"},"incomeLevel":{"id":"LMC","value":"Lower middle income"},"lendingType":{"id":"IDB","value":"Blend"},"capitalCity":"La Paz","longitude":"-66.1936","latitude":"-13.9908"},{"id":"BRA","iso2Code":"BR","name":"Brazil","region":{"id":"LCN","value":"Latin America & Caribbean (all income levels)"},"adminregion":{"id":"LAC","value":"Latin America & Caribbean (developing only)"},"incomeLevel":{"id":"UMC","value":"Upper middle income"},"lendingType":{"id":"IBD","value":"IBRD"},"capitalCity":"Brasilia","longitude":"-47.9292","latitude":"-15.7801"},{"id":"BRB","iso2Code":"BB","name":"Barbados","region":{"id":"LCN","value":"Latin America & Caribbean (all income levels)"},"adminregion":{"id":"","value":""},"incomeLevel":{"id":"NOC","value":"High income: nonOECD"},"lendingType":{"id":"NC","value":"Not classified"},"capitalCity":"Bridgetown","longitude":"-59.6105","latitude":"13.0935"},{"id":"BRN","iso2Code":"BN","name":"Brunei Darussalam","region":{"id":"EAS","value":"East Asia & Pacific (all income levels)"},"adminregion":{"id":"","value":""},"incomeLevel":{"id":"NOC","value":"High income: nonOECD"},"lendingType":{"id":"NC","value":"Not classified"},"capitalCity":"Bandar Seri Begawan","longitude":"114.946","latitude":"4.94199"},{"id":"BTN","iso2Code":"BT","name":"Bhutan","region":{"id":"SAS","value":"South Asia"},"adminregion":{"id":"SAS","value":"South Asia"},"incomeLevel":{"id":"LMC","value":"Lower middle income"},"lendingType":{"id":"IDX","value":"IDA"},"capitalCity":"Thimphu","longitude":"89.6177","latitude":"27.5768"},{"id":"BWA","iso2Code":"BW","name":"Botswana","region":{"id":"SSF","value":"Sub-Saharan Africa (all income levels)"},"adminregion":{"id":"SSA","value":"Sub-Saharan Africa (developing only)"},"incomeLevel":{"id":"UMC","value":"Upper middle income"},"lendingType":{"id":"IBD","value":"IBRD"},"capitalCity":"Gaborone","longitude":"25.9201","latitude":"-24.6544"},{"id":"CAF","iso2Code":"CF","name":"Central African Republic","region":{"id":"SSF","value":"Sub-Saharan Africa (all income levels)"},"adminregion":{"id":"SSA","value":"Sub-Saharan Africa (developing only)"},"incomeLevel":{"id":"LIC","value":"Low income"},"lendingType":{"id":"IDX","value":"IDA"},"capitalCity":"Bangui","longitude":"21.6407","latitude":"5.63056"},{"id":"CAN","iso2Code":"CA","name":"Canada","region":{"id":"NAC","value":"North America"},"adminregion":{"id":"","value":""},"incomeLevel":{"id":"OEC","value":"High income: OECD"},"lendingType":{"id":"NC","value":"Not classified"},"capitalCity":"Ottawa","longitude":"-75.6919","latitude":"45.4215"},{"id":"CHE","iso2Code":"CH","name":"Switzerland","region":{"id":"ECS","value":"Europe & Central Asia (all income levels)"},"adminregion":{"id":"","value":""},"incomeLevel":{"id":"OEC","value":"High income: OECD"},"lendingType":{"id":"NC","value":"Not classified"},"capitalCity":"Bern","longitude":"7.44821","latitude":"46.948"},{"id":"CHI","iso2Code":"JG","name":"Channel Islands","region":{"id":"ECS","value":"Europe & Central Asia (all income levels)"},"adminregion":{"id":"","value":""},"incomeLevel":{"id":"NOC","value":"High income: nonOECD"},"lendingType":{"id":"NC","value":"Not classified"},"capitalCity":"","longitude":"","latitude":""},{"id":"CHL","iso2Code":"CL","name":"Chile","region":{"id":"LCN","value":"Latin America & Caribbean (all income levels)"},"adminregion":{"id":"LAC","value":"Latin America & Caribbean (developing only)"},"incomeLevel":{"id":"UMC","value":"Upper middle income"},"lendingType":{"id":"IBD","value":"IBRD"},"capitalCity":"Santiago","longitude":"-70.6475","latitude":"-33.475"},{"id":"CHN","iso2Code":"CN","name":"China","region":{"id":"EAS","value":"East Asia & Pacific (all income levels)"},"adminregion":{"id":"EAP","value":"East Asia & Pacific (developing only)"},"incomeLevel":{"id":"LMC","value":"Lower middle income"},"lendingType":{"id":"IBD","value":"IBRD"},"capitalCity":"Beijing","longitude":"116.286","latitude":"40.0495"},{"id":"CIV","iso2Code":"CI","name":"Cote d'Ivoire","region":{"id":"SSF","value":"Sub-Saharan Africa (all income levels)"},"adminregion":{"id":"SSA","value":"Sub-Saharan Africa (developing only)"},"incomeLevel":{"id":"LMC","value":"Lower middle income"},"lendingType":{"id":"IDX","value":"IDA"},"capitalCity":"Yamoussoukro","longitude":"-4.0305","latitude":"5.332"},{"id":"CMR","iso2Code":"CM","name":"Cameroon","region":{"id":"SSF","value":"Sub-Saharan Africa (all income levels)"},"adminregion":{"id":"SSA","value":"Sub-Saharan Africa (developing only)"},"incomeLevel":{"id":"LMC","value":"Lower middle income"},"lendingType":{"id":"IDX","value":"IDA"},"capitalCity":"Yaounde","longitude":"11.5174","latitude":"3.8721"},{"id":"COD","iso2Code":"CD","name":"Congo, Dem. Rep.","region":{"id":"SSF","value":"Sub-Saharan Africa (all income levels)"},"adminregion":{"id":"SSA","value":"Sub-Saharan Africa (developing only)"},"incomeLevel":{"id":"LIC","value":"Low income"},"lendingType":{"id":"IDX","value":"IDA"},"capitalCity":"Kinshasa","longitude":"15.3222","latitude":"-4.325"},{"id":"COG","iso2Code":"CG","name":"Congo, Rep.","region":{"id":"SSF","value":"Sub-Saharan Africa (all income levels)"},"adminregion":{"id":"SSA","value":"Sub-Saharan Africa (developing only)"},"incomeLevel":{"id":"LMC","value":"Lower middle income"},"lendingType":{"id":"IDX","value":"IDA"},"capitalCity":"Brazzaville","longitude":"15.2662","latitude":"-4.2767"},{"id":"COL","iso2Code":"CO","name":"Colombia","region":{"id":"LCN","value":"Latin America & Caribbean (all income levels)"},"adminregion":{"id":"LAC","value":"Latin America & Caribbean (developing only)"},"incomeLevel":{"id":"UMC","value":"Upper middle income"},"lendingType":{"id":"IBD","value":"IBRD"},"capitalCity":"Bogota","longitude":"-74.082","latitude":"4.60987"},{"id":"COM","iso2Code":"KM","name":"Comoros","region":{"id":"SSF","value":"Sub-Saharan Africa (all income levels)"},"adminregion":{"id":"SSA","value":"Sub-Saharan Africa (developing only)"},"incomeLevel":{"id":"LIC","value":"Low income"},"lendingType":{"id":"IDX","value":"IDA"},"capitalCity":"Moroni","longitude":"43.2418","latitude":"-11.6986"},{"id":"CPV","iso2Code":"CV","name":"Cape Verde","region":{"id":"SSF","value":"Sub-Saharan Africa (all income levels)"},"adminregion":{"id":"SSA","value":"Sub-Saharan Africa (developing only)"},"incomeLevel":{"id":"LMC","value":"Lower middle income"},"lendingType":{"id":"IDB","value":"Blend"},"capitalCity":"Praia","longitude":"-23.5087","latitude":"14.9218"},{"id":"CRI","iso2Code":"CR","name":"Costa Rica","region":{"id":"LCN","value":"Latin America & Caribbean (all income levels)"},"adminregion":{"id":"LAC","value":"Latin America & Caribbean (developing only)"},"incomeLevel":{"id":"UMC","value":"Upper middle income"},"lendingType":{"id":"IBD","value":"IBRD"},"capitalCity":"San Jose","longitude":"-84.0089","latitude":"9.63701"},{"id":"CUB","iso2Code":"CU","name":"Cuba","region":{"id":"LCN","value":"Latin America & Caribbean (all income levels)"},"adminregion":{"id":"LAC","value":"Latin America & Caribbean (developing only)"},"incomeLevel":{"id":"UMC","value":"Upper middle income"},"lendingType":{"id":"NC","value":"Not classified"},"capitalCity":"Havana","longitude":"-82.3667","latitude":"23.1333"},{"id":"CYM","iso2Code":"KY","name":"Cayman Islands","region":{"id":"LCN","value":"Latin America & Caribbean (all income levels)"},"adminregion":{"id":"","value":""},"incomeLevel":{"id":"NOC","value":"High income: nonOECD"},"lendingType":{"id":"NC","value":"Not classified"},"capitalCity":"George Town","longitude":"-81.3857","latitude":"19.3022"},{"id":"CYP","iso2Code":"CY","name":"Cyprus","region":{"id":"ECS","value":"Europe & Central Asia (all income levels)"},"adminregion":{"id":"","value":""},"incomeLevel":{"id":"NOC","value":"High income: nonOECD"},"lendingType":{"id":"NC","value":"Not classified"},"capitalCity":"Nicosia","longitude":"33.3736","latitude":"35.1676"}]]
+

data/spec/fixtures/countries_india.json

@@ -0,0 +1,2 @@
+[{"page":1,"pages":1,"per_page":"50","total":1},[{"id":"IND","iso2Code":"IN","name":"India","region":{"id":"SAS","value":"South Asia"},"adminregion":{"id":"SAS","value":"South Asia"},"incomeLevel":{"id":"LMC","value":"Lower middle income"},"lendingType":{"id":"IDB","value":"Blend"},"capitalCity":"New Delhi","longitude":"77.225","latitude":"28.6353"}]]
+

data/spec/fixtures/income_level_lmc.json

@@ -0,0 +1 @@
+[{"page":"1","pages":"1","per_page":"50","total":"1"},[{"id":"LMC","value":"Lower middle income"}]]

data/spec/fixtures/income_levels.json

@@ -0,0 +1,2 @@
+[{"page":"1","pages":"1","per_page":"50","total":"9"},[{"id":"HIC","value":"High income"},{"id":"HPC","value":"Heavily indebted poor countries (HIPC)"},{"id":"LIC","value":"Low income"},{"id":"LMC","value":"Lower middle income"},{"id":"LMY","value":"Low & middle income"},{"id":"MIC","value":"Middle income"},{"id":"NOC","value":"High income: nonOECD"},{"id":"OEC","value":"High income: OECD"},{"id":"UMC","value":"Upper middle income"}]]
+

data/spec/fixtures/indicators.json

@@ -0,0 +1,2 @@
+[{"page":1,"pages":82,"per_page":"50","total":4073},[{"id":"AG.AGR.TRAC.NO","name":"Agricultural machinery, tractors","source":{"id":"2","value":"World Development Indicators"},"sourceNote":"Agricultural machinery refers to the number of wheel and crawler tractors (excluding garden tractors) in use in agriculture at the end of the calendar year specified or during the first quarter of the following year.","sourceOrganization":"Food and Agriculture Organization, electronic files and web site.","topics":[{"id":"1","value":"Agriculture & Rural Development  "}]},{"id":"AG.AID.CREL.MT","name":"Cereal food aid shipments (FAO, tonnes)","source":{"id":"11","value":"Africa Development Indicators"},"sourceNote":"","sourceOrganization":"","topics":[]},{"id":"AG.CON.FERT.MT","name":"Fertilizer consumption (metric tons)","source":{"id":"11","value":"Africa Development Indicators"},"sourceNote":"Fertilizer consumption measures the quantity of plant nutrients used per unit of arable land. Fertilizer products cover nitrogenous, potash, and phosphate fertilizers (including ground rock phosphate). Traditional nutrients--animal and plant manures--are not included. For the purpose of data dissemination, FAO has adopted the concept of a calendar year (January to December). Some countries compile fertilizer data on a calendar year basis, while others are on a split-year basis.","sourceOrganization":"Food and Agriculture Organization, electronic files and web site.","topics":[{"id":"1","value":"Agriculture & Rural Development  "}]},{"id":"AG.CON.FERT.PT.ZS","name":"Fertilizer consumption (% of fertilizer production)","source":{"id":"2","value":"World Development Indicators"},"sourceNote":"Fertilizer consumption measures the quantity of plant nutrients used per unit of arable land. Fertilizer products cover nitrogenous, potash, and phosphate fertilizers (including ground rock phosphate). Traditional nutrients--animal and plant manures--are not included. For the purpose of data dissemination, FAO has adopted the concept of a calendar year (January to December). Some countries compile fertilizer data on a calendar year basis, while others are on a split-year basis.","sourceOrganization":"Food and Agriculture Organization, electronic files and web site.","topics":[{"id":"1","value":"Agriculture & Rural Development  "}]},{"id":"AG.CON.FERT.ZS","name":"Fertilizer consumption (kilograms per hectare of arable land)","source":{"id":"2","value":"World Development Indicators"},"sourceNote":"Fertilizer consumption (100 grams per hectare of arable land) measures the quantity of plant nutrients used per unit of arable land. Fertilizer products cover nitrogenous, potash, and phosphate fertilizers (including ground rock phosphate). Traditional nutrients--animal and plant manures--are not included. For the purpose of data dissemination, FAO has adopted the concept of a calendar year (January to December). Some countries compile fertilizer data on a calendar year basis, while others are on a split-year basis. Arable land includes land defined by the FAO as land under temporary crops (double-cropped areas are counted once), temporary meadows for mowing or for pasture, land under market or kitchen gardens, and land temporarily fallow. Land abandoned as a result of shifting cultivation is excluded.","sourceOrganization":"Food and Agriculture Organization, electronic files and web site.","topics":[{"id":"1","value":"Agriculture & Rural Development  "}]},{"id":"AG.CRP.BLY.CD","name":"Producer Price for Barley (per tonne, current US$)","source":{"id":"11","value":"Africa Development Indicators"},"sourceNote":"","sourceOrganization":"","topics":[]},{"id":"AG.CRP.BLY.CN","name":"Producer Price for Barley (per tonne, current LCU)","source":{"id":"11","value":"Africa Development Indicators"},"sourceNote":"","sourceOrganization":"","topics":[]},{"id":"AG.CRP.FNO.CD","name":"Producer Price for Fonio (per tonne, current US$)","source":{"id":"11","value":"Africa Development Indicators"},"sourceNote":"","sourceOrganization":"","topics":[]},{"id":"AG.CRP.FNO.CN","name":"Producer Price for Fonio (per tonne, current LCU)","source":{"id":"11","value":"Africa Development Indicators"},"sourceNote":"","sourceOrganization":"","topics":[]},{"id":"AG.CRP.MLT.CD","name":"Producer Price for Millet (per tonne, current US$)","source":{"id":"11","value":"Africa Development Indicators"},"sourceNote":"","sourceOrganization":"","topics":[]},{"id":"AG.CRP.MLT.CN","name":"Producer Price for Millet (per tonne, current LCU)","source":{"id":"11","value":"Africa Development Indicators"},"sourceNote":"","sourceOrganization":"","topics":[]},{"id":"AG.CRP.MZE.CD","name":"Producer Price for Maize (per tonne, current US$)","source":{"id":"11","value":"Africa Development Indicators"},"sourceNote":"","sourceOrganization":"","topics":[]},{"id":"AG.CRP.MZE.CN","name":"Producer Price for Maize (per tonne, current LCU)","source":{"id":"11","value":"Africa Development Indicators"},"sourceNote":"","sourceOrganization":"","topics":[]},{"id":"AG.CRP.RICE.CD","name":"Producer Price for Rice, paddy (per tonne, current US$)","source":{"id":"11","value":"Africa Development Indicators"},"sourceNote":"","sourceOrganization":"","topics":[]},{"id":"AG.CRP.RICE.CN","name":"Producer Price for Rice, paddy (per tonne, current LCU)","source":{"id":"11","value":"Africa Development Indicators"},"sourceNote":"","sourceOrganization":"","topics":[]},{"id":"AG.CRP.SGM.CD","name":"Producer Price for Sorghum (per tonne, current US$)","source":{"id":"11","value":"Africa Development Indicators"},"sourceNote":"","sourceOrganization":"","topics":[]},{"id":"AG.CRP.SGM.CN","name":"Producer Price for Sorghum (per tonne, current LCU)","source":{"id":"11","value":"Africa Development Indicators"},"sourceNote":"","sourceOrganization":"","topics":[]},{"id":"AG.CRP.WHT.CD","name":"Producer Price for Wheat (per tonne, current US$)","source":{"id":"11","value":"Africa Development Indicators"},"sourceNote":"","sourceOrganization":"","topics":[]},{"id":"AG.CRP.WHT.CN","name":"Producer Price for Wheat (per tonne, current LCU)","source":{"id":"11","value":"Africa Development Indicators"},"sourceNote":"","sourceOrganization":"","topics":[]},{"id":"AG.FRST.PROD.WOOD","name":"Wood fuel production quantity (CUM, solid volume units)","source":{"id":"11","value":"Africa Development Indicators"},"sourceNote":"","sourceOrganization":"","topics":[]},{"id":"AG.LND.AGRI.HA","name":"Agricultural land (hectares)","source":{"id":"11","value":"Africa Development Indicators"},"sourceNote":"","sourceOrganization":"","topics":[]},{"id":"AG.LND.AGRI.K2","name":"Agricultural land (sq. km)","source":{"id":"2","value":"World Development Indicators"},"sourceNote":"Agricultural land refers to the share of land area that is arable, under permanent crops, and under permanent pastures. Arable land includes land defined by the FAO as land under temporary crops (double-cropped areas are counted once), temporary meadows for mowing or for pasture, land under market or kitchen gardens, and land temporarily fallow. Land abandoned as a result of shifting cultivation is excluded. Land under permanent crops is land cultivated with crops that occupy the land for long periods and need not be replanted after each harvest, such as cocoa, coffee, and rubber. This category includes land under flowering shrubs, fruit trees, nut trees, and vines, but excludes land under trees grown for wood or timber. Permanent pasture is land used for five or more years for forage, including natural and cultivated crops.","sourceOrganization":"Food and Agriculture Organization, electronic files and web site.","topics":[{"id":"1","value":"Agriculture & Rural Development  "}]},{"id":"AG.LND.AGRI.ZS","name":"Agricultural land (% of land area)","source":{"id":"2","value":"World Development Indicators"},"sourceNote":"Agricultural land refers to the share of land area that is arable, under permanent crops, and under permanent pastures. Arable land includes land defined by the FAO as land under temporary crops (double-cropped areas are counted once), temporary meadows for mowing or for pasture, land under market or kitchen gardens, and land temporarily fallow. Land abandoned as a result of shifting cultivation is excluded. Land under permanent crops is land cultivated with crops that occupy the land for long periods and need not be replanted after each harvest, such as cocoa, coffee, and rubber. This category includes land under flowering shrubs, fruit trees, nut trees, and vines, but excludes land under trees grown for wood or timber. Permanent pasture is land used for five or more years for forage, including natural and cultivated crops.","sourceOrganization":"Food and Agriculture Organization, electronic files and web site.","topics":[{"id":"1","value":"Agriculture & Rural Development  "}]},{"id":"AG.LND.ARBL.HA","name":"Arable land (hectares)","source":{"id":"2","value":"World Development Indicators"},"sourceNote":"Arable land (in hectares) includes land defined by the FAO as land under temporary crops (double-cropped areas are counted once), temporary meadows for mowing or for pasture, land under market or kitchen gardens, and land temporarily fallow. Land abandoned as a result of shifting cultivation is excluded.","sourceOrganization":"Food and Agriculture Organization, electronic files and web site.","topics":[{"id":"1","value":"Agriculture & Rural Development  "}]},{"id":"AG.LND.ARBL.HA.PC","name":"Arable land (hectares per person)","source":{"id":"2","value":"World Development Indicators"},"sourceNote":"Arable land (hectares per person) includes land defined by the FAO as land under temporary crops (double-cropped areas are counted once), temporary meadows for mowing or for pasture, land under market or kitchen gardens, and land temporarily fallow. Land abandoned as a result of shifting cultivation is excluded.","sourceOrganization":"Food and Agriculture Organization, electronic files and web site.","topics":[{"id":"1","value":"Agriculture & Rural Development  "}]},{"id":"AG.LND.ARBL.ZS","name":"Arable land (% of land area)","source":{"id":"2","value":"World Development Indicators"},"sourceNote":"Arable land includes land defined by the FAO as land under temporary crops (double-cropped areas are counted once), temporary meadows for mowing or for pasture, land under market or kitchen gardens, and land temporarily fallow. Land abandoned as a result of shifting cultivation is excluded.","sourceOrganization":"Food and Agriculture Organization, electronic files and web site.","topics":[{"id":"1","value":"Agriculture & Rural Development  "}]},{"id":"AG.LND.CERE.ZS","name":"Cereal cropland (% of land area)","source":{"id":"11","value":"Africa Development Indicators"},"sourceNote":"","sourceOrganization":"","topics":[]},{"id":"AG.LND.CREL.HA","name":"Land under cereal production (hectares)","source":{"id":"2","value":"World Development Indicators"},"sourceNote":"Land under cereal production refers to harvested area, although some countries report only sown or cultivated area. Cereals include wheat, rice, maize, barley, oats, rye, millet, sorghum, buckwheat, and mixed grains. Production data on cereals relate to crops harvested for dry grain only. Cereal crops harvested for hay or harvested green for food, feed, or silage and those used for grazing are excluded.","sourceOrganization":"Food and Agriculture Organization, electronic files and web site.","topics":[{"id":"1","value":"Agriculture & Rural Development  "}]},{"id":"AG.LND.CROP.HA","name":"Permanent cropland (hectares)","source":{"id":"11","value":"Africa Development Indicators"},"sourceNote":"","sourceOrganization":"","topics":[]},{"id":"AG.LND.CROP.ZS","name":"Permanent cropland (% of land area)","source":{"id":"2","value":"World Development Indicators"},"sourceNote":"Permanent cropland is land cultivated with crops that occupy the land for long periods and need not be replanted after each harvest, such as cocoa, coffee, and rubber. This category includes land under flowering shrubs, fruit trees, nut trees, and vines, but excludes land under trees grown for wood or timber.","sourceOrganization":"Food and Agriculture Organization, electronic files and web site.","topics":[{"id":"1","value":"Agriculture & Rural Development  "}]},{"id":"AG.LND.CRPA.HA","name":"Arable and permanent cropland (hectares)","source":{"id":"11","value":"Africa Development Indicators"},"sourceNote":"","sourceOrganization":"","topics":[]},{"id":"AG.LND.FRST.K2","name":"Forest area (sq. km)","source":{"id":"2","value":"World Development Indicators"},"sourceNote":"Forest area is land under natural or planted stands of trees of at least 5 meters in situ, whether productive or not, and excludes tree stands in agricultural production systems (for example, in fruit plantations and agroforestry systems) and trees in urban parks and gardens.","sourceOrganization":"Food and Agriculture Organization, electronic files and web site.","topics":[{"id":"6","value":"Environment "},{"id":"1","value":"Agriculture & Rural Development  "}]},{"id":"AG.LND.FRST.ZS","name":"Forest area (% of land area)","source":{"id":"2","value":"World Development Indicators"},"sourceNote":"Forest area is land under natural or planted stands of trees of at least 5 meters in situ, whether productive or not, and excludes tree stands in agricultural production systems (for example, in fruit plantations and agroforestry systems) and trees in urban parks and gardens.","sourceOrganization":"Food and Agriculture Organization, electronic files and web site.","topics":[{"id":"1","value":"Agriculture & Rural Development  "},{"id":"6","value":"Environment "}]},{"id":"AG.LND.IRIG.AG.ZS","name":"Agricultural irrigated land (% of total agricultural land)","source":{"id":"2","value":"World Development Indicators"},"sourceNote":"Agricultural irrigated land refers to agricultural areas purposely provided with water, including land irrigated by controlled flooding.","sourceOrganization":"Food and Agriculture Organization, electronic files and web site.","topics":[{"id":"1","value":"Agriculture & Rural Development  "}]},{"id":"AG.LND.IRIG.PO.HA","name":"Land area equipped for irrigation (hectares)","source":{"id":"11","value":"Africa Development Indicators"},"sourceNote":"","sourceOrganization":"Food and Agriculture Organization, electronic files and web site.","topics":[]},{"id":"AG.LND.IRIG.ZS","name":"Irrigated land (% of crop land)","source":{"id":"11","value":"Africa Development Indicators"},"sourceNote":"Irrigated land refers to areas purposely provided with water, including land irrigated by controlled flooding. Cropland refers to arable land and permanent cropland.","sourceOrganization":"Food and Agriculture Organization, electronic files and web site.","topics":[]},{"id":"AG.LND.PRCP.MM","name":"Average precipitation in depth (mm per year)  ","source":{"id":"2","value":"World Development Indicators"},"sourceNote":"Average precipitation is the long-term average in depth (over space and time) of annual precipitation in the country. Precipitation is defined as any kind of water that falls from clouds as a liquid or a solid.","sourceOrganization":"Food and Agriculture Organization, electronic files and web site.","topics":[{"id":"1","value":"Agriculture & Rural Development  "}]},{"id":"AG.LND.TOTL.HA","name":"Land area (hectares)","source":{"id":"11","value":"Africa Development Indicators"},"sourceNote":"","sourceOrganization":"","topics":[]},{"id":"AG.LND.TOTL.K2","name":"Land area (sq. km)","source":{"id":"2","value":"World Development Indicators"},"sourceNote":"Land area is a country's total area, excluding area under inland water bodies, national claims to continental shelf, and exclusive economic zones. In most cases the definition of inland water bodies includes major rivers and lakes.","sourceOrganization":"Food and Agriculture Organization, electronic files and web site.","topics":[{"id":"1","value":"Agriculture & Rural Development  "}]},{"id":"AG.LND.TRAC.ZS","name":"Agricultural machinery, tractors per 100 sq. km of arable land","source":{"id":"2","value":"World Development Indicators"},"sourceNote":"Agricultural machinery refers to the number of wheel and crawler tractors (excluding garden tractors) in use in agriculture at the end of the calendar year specified or during the first quarter of the following year. Arable land includes land defined by the FAO as land under temporary crops (double-cropped areas are counted once), temporary meadows for mowing or for pasture, land under market or kitchen gardens, and land temporarily fallow. Land abandoned as a result of shifting cultivation is excluded.","sourceOrganization":"Food and Agriculture Organization, electronic files and web site.","topics":[{"id":"1","value":"Agriculture & Rural Development  "}]},{"id":"AG.LNF.FRST.HA","name":"Forest area (hectares)","source":{"id":"11","value":"Africa Development Indicators"},"sourceNote":"","sourceOrganization":"","topics":[]},{"id":"AG.PRD.AGRI.XD","name":"Gross agriculture production index (1999-2001 = 100)","source":{"id":"11","value":"Africa Development Indicators"},"sourceNote":"","sourceOrganization":"","topics":[]},{"id":"AG.PRD.CREL.MT","name":"Cereal production (metric tons)","source":{"id":"2","value":"World Development Indicators"},"sourceNote":"Production data on cereals relate to crops harvested for dry grain only. Cereal crops harvested for hay or harvested green for food, feed, or silage and those used for grazing are excluded.","sourceOrganization":"Food and Agriculture Organization, electronic files and web site.","topics":[{"id":"6","value":"Environment "}]},{"id":"AG.PRD.CREL.XD","name":"Gross cereal production index (1999-2001 = 100)","source":{"id":"11","value":"Africa Development Indicators"},"sourceNote":"","sourceOrganization":"","topics":[]},{"id":"AG.PRD.CROP.XD","name":"Crop production index (1999-2001 = 100)","source":{"id":"2","value":"World Development Indicators"},"sourceNote":"Crop production index shows agricultural production for each year relative to the base period 1999-2001. It includes all crops except fodder crops. Regional and income group aggregates for the FAO's production indexes are calculated from the underlying values in international dollars, normalized to the base period 1999-2001.","sourceOrganization":"Food and Agriculture Organization, electronic files and web site.","topics":[{"id":"1","value":"Agriculture & Rural Development  "}]},{"id":"AG.PRD.FOOD.XD","name":"Food production index (1999-2001 = 100)","source":{"id":"2","value":"World Development Indicators"},"sourceNote":"Food production index covers food crops that are considered edible and that contain nutrients. Coffee and tea are excluded because, although edible, they have no nutritive value.","sourceOrganization":"Food and Agriculture Organization, electronic files and web site.","topics":[{"id":"1","value":"Agriculture & Rural Development  "}]},{"id":"AG.PRD.LVSK.XD","name":"Livestock production index (1999-2001 = 100)","source":{"id":"2","value":"World Development Indicators"},"sourceNote":"Livestock production index includes meat and milk from all sources, dairy products such as cheese, and eggs, honey, raw silk, wool, and hides and skins.","sourceOrganization":"Food and Agriculture Organization, electronic files and web site.","topics":[{"id":"1","value":"Agriculture & Rural Development  "}]},{"id":"AG.PRD.NFOOD.XD","name":"Gross non-food production index (1999-2001 = 100)","source":{"id":"11","value":"Africa Development Indicators"},"sourceNote":"","sourceOrganization":"","topics":[]},{"id":"AG.SED.CREL.MT","name":"Cereal seed quantity (FAO, tonnes)","source":{"id":"11","value":"Africa Development Indicators"},"sourceNote":"","sourceOrganization":"","topics":[]},{"id":"AG.SRF.TOTL.K2","name":"Surface area (sq. km)","source":{"id":"2","value":"World Development Indicators"},"sourceNote":"Surface area is a country's total area, including areas under inland bodies of water and some coastal waterways.","sourceOrganization":"Food and Agriculture Organization, electronic files and web site.","topics":[{"id":"1","value":"Agriculture & Rural Development  "}]}]]
+

data/spec/fixtures/indicators_tractors.json

@@ -0,0 +1 @@
+[{"page":1,"pages":1,"per_page":"50","total":1},[{"id":"AG.AGR.TRAC.NO","name":"Agricultural machinery, tractors","source":{"id":"2","value":"World Development Indicators"},"sourceNote":"Agricultural machinery refers to the number of wheel and crawler tractors (excluding garden tractors) in use in agriculture at the end of the calendar year specified or during the first quarter of the following year.","sourceOrganization":"Food and Agriculture Organization, electronic files and web site.","topics":[{"id":"1","value":"Agriculture & Rural Development  "}]}]]

data/spec/fixtures/lending_type_idb.json

@@ -0,0 +1 @@
+[{"page":"1","pages":"1","per_page":"50","total":"1"},[{"id":"IDB","value":"Blend"}]]

data/spec/fixtures/lending_types.json

@@ -0,0 +1 @@
+[{"page":"1","pages":"1","per_page":"50","total":"4"},[{"id":"IBD","value":"IBRD"},{"id":"IDB","value":"Blend"},{"id":"IDX","value":"IDA"},{"id":"NC","value":"Not classified"}]]

data/spec/fixtures/regions.json

@@ -0,0 +1,2 @@
+[{"page":"1","pages":"1","per_page":"50","total":"18"},[{"id":"","code":"ARB","name":"Arab World"},{"id":"","code":"EAP","name":"East Asia & Pacific (developing only)"},{"id":"1","code":"EAS","name":"East Asia & Pacific (all income levels)"},{"id":"","code":"ECA","name":"Europe & Central Asia (developing only)"},{"id":"2","code":"ECS","name":"Europe & Central Asia (all income levels)"},{"id":"","code":"EMU","name":"Euro area"},{"id":"","code":"EUU","name":"European Union"},{"id":"","code":"LAC","name":"Latin America & Caribbean (developing only)"},{"id":"3","code":"LCN","name":"Latin America & Caribbean (all income levels)"},{"id":"","code":"LDC","name":"Least developed countries: UN classification"},{"id":"4","code":"MEA","name":"Middle East & North Africa (all income levels)"},{"id":"","code":"MNA","name":"Middle East & North Africa (developing only)"},{"id":"6","code":"NAC","name":"North America"},{"id":"","code":"OED","name":"OECD members"},{"id":"8","code":"SAS","name":"South Asia"},{"id":"","code":"SSA","name":"Sub-Saharan Africa (developing only)"},{"id":"9","code":"SSF","name":"Sub-Saharan Africa (all income levels)"},{"id":"","code":"WLD","name":"World"}]]
+

data/spec/fixtures/regions_world.json

@@ -0,0 +1 @@
+[{"page":"1","pages":"1","per_page":"50","total":"1"},[{"id":"","code":"WLD","name":"World"}]]

data/spec/fixtures/source_21.json

@@ -0,0 +1,2 @@
+[{"page":"1","pages":"1","per_page":"50","total":"1"},[{"id":"21","name":"Global Economic Monitor (GEM) Commodities","description":"","url":""}]]
+

data/spec/fixtures/sources.json

@@ -0,0 +1 @@
+[{"page":"1","pages":"1","per_page":"50","total":"14"},[{"id":"11","name":"Africa Development Indicators","description":"","url":""},{"id":"1","name":"Doing Business","description":"","url":""},{"id":"12","name":"Education Statistics","description":"","url":""},{"id":"13","name":"Enterprise Surveys","description":"","url":""},{"id":"6","name":"Global Development Finance","description":"","url":""},{"id":"14","name":"Gender Statistics","description":"","url":""},{"id":"15","name":"Global Economic Monitor","description":"","url":""},{"id":"21","name":"Global Economic Monitor (GEM) Commodities","description":"","url":""},{"id":"16","name":"Health Nutrition and Population Statistics","description":"","url":""},{"id":"18","name":"International Development Association - Results Measurement System","description":"","url":""},{"id":"19","name":"Millennium Development Goals","description":"","url":""},{"id":"20","name":"Public Sector Debt","description":"","url":""},{"id":"2","name":"World Development Indicators","description":"","url":""},{"id":"3","name":"Worldwide Governance Indicators","description":"","url":""}]]

data/spec/fixtures/topic_6.json

@@ -0,0 +1,2 @@
+[{"page":1,"pages":1,"per_page":"50","total":1},[{"id":"6","value":"Environment ","sourceNote":"Natural and man-made environmental resources – fresh water, clean air, forests, grasslands, marine resources, and agro-ecosystems – provide sustenance and a foundation for social and economic development.  The need to safeguard these resources crosses all borders.  Today, the World Bank is one of the key promoters and financiers of environmental upgrading in the developing world. Data here cover forests, biodiversity, emissions, and pollution. Other indicators relevant to the environment are found under data pages for Agriculture & Rural Development, Energy & Mining, Infrastructure, and Urban Development."}]]
+

data/spec/fixtures/topics.json

@@ -0,0 +1,2 @@
+[{"page":1,"pages":1,"per_page":"50","total":18},[{"id":"1","value":"Agriculture & Rural Development  ","sourceNote":"For the 70 percent of the world's poor who live in rural areas, agriculture is the main source of income and employment. But depletion and degradation of land and water pose serious challenges to producing enough food and other agricultural products to sustain livelihoods here and meet the needs of urban populations. Data presented here include measures of agricultural inputs, outputs, and productivity compiled by the UN's Food and Agriculture Organization."},{"id":"2","value":"Aid Effectiveness ","sourceNote":"Aid effectiveness is the impact that aid has in reducing poverty and inequality, increasing growth, building capacity, and accelerating achievement of the Millennium Development Goals set by the international community. Indicators here cover aid received as well as progress in reducing poverty and improving education, health, and other measures of human welfare."},{"id":"3","value":"Economic Policy and External Debt ","sourceNote":"Economic indicators measure outcomes in the structure and rates of change of output, trade, and aggregate demand, and in macroeconomic performance. The data here consist of national accounts, government finances, money supply, prices, balance of payments, and external debt. Data are gathered from national statistical organizations and central banks by World Bank missions and from the International Monetary Fund's data files."},{"id":"4","value":"Education ","sourceNote":"Education is one of the most powerful instruments for reducing poverty and inequality and lays a foundation for sustained economic growth. The World Bank compiles data on education inputs, participation, efficiency, and outcomes. Data on education are compiled by the United Nations Educational, Scientific, and Cultural Organization (UNESCO) Institute for Statistics from official responses to surveys and from reports provided by education authorities in each country."},{"id":"5","value":"Energy & Mining ","sourceNote":"The world economy needs ever-increasing amounts of energy to sustain economic growth, raise living standards, and reduce poverty. But today's trends in energy use are not sustainable. As the world's population grows and economies become more industrialized, nonrenewable energy sources will become scarcer and more costly. Data here on energy production, use, dependency, and efficiency are compiled by the World Bank from the International Energy Agency and the Carbon Dioxide Information Analysis Center."},{"id":"6","value":"Environment ","sourceNote":"Natural and man-made environmental resources – fresh water, clean air, forests, grasslands, marine resources, and agro-ecosystems – provide sustenance and a foundation for social and economic development.  The need to safeguard these resources crosses all borders.  Today, the World Bank is one of the key promoters and financiers of environmental upgrading in the developing world. Data here cover forests, biodiversity, emissions, and pollution. Other indicators relevant to the environment are found under data pages for Agriculture & Rural Development, Energy & Mining, Infrastructure, and Urban Development."},{"id":"7","value":"Financial Sector ","sourceNote":"An economy's financial markets are critical to its overall development. Banking systems and stock markets enhance growth, the main factor in poverty reduction. Strong financial systems provide reliable and accessible information that lowers transaction costs, which in turn bolsters resource allocation and economic growth. Indicators here include the size and liquidity of stock markets; the accessibility, stability, and efficiency of financial systems; and international migration and workers\\ remittances, which affect growth and social welfare in both sending and receiving countries."},{"id":"8","value":"Health ","sourceNote":"Improving health is central to the Millennium Development Goals, and the public sector is the main provider of health care in developing countries. To reduce inequities, many countries have emphasized primary health care, including immunization, sanitation, access to safe drinking water, and safe motherhood initiatives.  Data here cover health systems, disease prevention, reproductive health, nutrition, and population dynamics. Data are from the United Nations Population Division, World Health Organization, United Nations Children's Fund, the Joint United Nations Programme on HIV\/AIDS, and various other sources."},{"id":"9","value":"Infrastructure ","sourceNote":"Infrastructure helps determine the success of manufacturing and agricultural activities. Investments in water, sanitation, energy, housing, and transport also improve lives and help reduce poverty. And new information and communication technologies promote growth, improve delivery of health and other services, expand the reach of education, and support social and cultural advances. Data here are compiled from such sources as the International Road Federation, Containerisation International, the International Civil Aviation Organization, the International Energy Association, and the International Telecommunications Union."},{"id":"10","value":"Labor & Social Protection ","sourceNote":"The supply of labor available in an economy includes people who are employed, those who are unemployed but seeking work, and first-time job-seekers. Not everyone who works is included: unpaid workers, family workers, and students are often omitted, while some countries do not count members of the armed forces. Data on labor and employment are compiled by the International Labour Organization (ILO) from labor force surveys, censuses, establishment censuses and surveys, and administrative records such as employment exchange registers and unemployment insurance schemes."},{"id":"11","value":"Poverty ","sourceNote":"The World Bank periodically prepares poverty assessments of countries in which it has an active program, in close collaboration with national institutions, other development agencies, and civil society, including poor people's organizations. Assessments report the extent and causes of poverty and propose strategies to reduce it. Countries have varying definitions of poverty, and comparisons can be difficult. National poverty lines tend to have higher purchasing power in rich countries, where standards used are more generous than in poor countries. Poverty measures based on an international poverty line attempt to hold the real value of the poverty line constant across countries, including when making comparisons over time.  Data here includes measures of population living below the national poverty line as well as the international poverty line. Also included are income distributions and urban and rural poverty rates."},{"id":"12","value":"Private Sector","sourceNote":"Private markets drive economic growth, tapping initiative and investment to create productive jobs and raise incomes. Trade is also a driver of economic growth as it integrates developing countries into the world economy and generates benefits for their people.  Data on the private sector and trade are from the World Bank Group's Private Participation in Infrastructure Project Database, Enterprise Surveys, and Doing Business Indicators, as well as from the International Monetary Fund's Balance of Payments database and International Financial Statistics, the UN Commission on Trade and Development, the World Trade Organization, and various other sources."},{"id":"13","value":"Public Sector ","sourceNote":"Effective governments improve people's standard of living by ensuring access to essential services –  health, education, water and sanitation, electricity, transport – and the opportunity to live and work in peace and security. Data here includes World Bank staff assessments of country performance in economic management, structural policies, policies for social inclusion and equity, and public sector management and institutions for the poorest countries. Also included are indicators on revenues and expenses from the International Monetary Fund's Government Finance Statistics, and on tax policies from various sources."},{"id":"14","value":"Science & Technology ","sourceNote":"Technological innovation, often fueled by governments, drives industrial growth and helps raise living standards. Data here aims to shed light on countries technology base: research and development, scientific and technical journal articles, high-technology exports, royalty and license fees, and patents and trademarks. Sources include the UNESCO Institute for Statistics, the U.S. National Science Board, the UN Statistics Division, the International Monetary Fund, and the World Intellectual Property Organization."},{"id":"15","value":"Social Development ","sourceNote":"Data here cover child labor, gender issues, refugees, and asylum seekers. Children in many countries work long hours, often combining studying with work for pay. The data on their paid work are from household surveys conducted by the International Labour Organization (ILO), the United Nations Children's Fund (UNICEF), the World Bank, and national statistical offices. Gender disparities are measured using a compilation of data on key topics such as education, health, labor force participation, and political participation.  Data on refugees are from the United Nations High Commissioner for Refugees complemented by statistics on Palestinian refugees under the mandate of the United Nations Relief and Works Agency."},{"id":"16","value":"Urban Development ","sourceNote":"Cities can be tremendously efficient. It is easier to provide water and sanitation to people living closer together, while access to health, education, and other social and cultural services is also much more readily available. However, as cities grow, the cost of meeting basic needs increases, as does the strain on the environment and natural resources. Data on urbanization, traffic and congestion, and air pollution are from the United Nations Population Division, World Health Organization, International Road Federation, World Resources Institute, and other sources."},{"id":"17","value":"Gender Statistics","sourceNote":""},{"id":"18","value":"Millenium development goals","sourceNote":""}]]
+

data/spec/helper.rb

@@ -0,0 +1,48 @@
+$:.unshift File.expand_path('..', __FILE__)
+$:.unshift File.expand_path('../../lib', __FILE__)
+require 'simplecov'
+SimpleCov.start
+require 'worldbank_as_dataframe'
+require 'rspec'
+require 'webmock/rspec'
+
+
+def a_delete(path)
+  a_request(:delete, 'http://api.worldbank.org/v2/' + path)
+end
+
+def a_get(path)
+  a_request(:get, 'http://api.worldbank.org/v2/' + path)
+end
+
+def a_post(path)
+  a_request(:post, 'http://api.worldbank.org/v2/' + path)
+end
+
+def a_put(path)
+  a_request(:put, 'http://api.worldbank.org/v2/' + path)
+end
+
+def stub_delete(path)
+  stub_request(:delete, 'http://api.worldbank.org/v2/' + path)
+end
+
+def stub_get(path)
+  stub_request(:get, 'http://api.worldbank.org/v2/' + path)
+end
+
+def stub_post(path)
+  stub_request(:post, 'http://api.worldbank.org/v2/' + path)
+end
+
+def stub_put(path)
+  stub_request(:put, 'http://api.worldbank.org/v2/' + path)
+end
+
+def fixture_path
+  File.expand_path('../fixtures', __FILE__)
+end
+
+def fixture(file)
+  File.new(fixture_path + '/' + file)
+end