factbook-fields 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 1cf701b0c031d69ad0ebd0c7828368301135a1346cb5fe2552b4f88682c1c8c5
+  data.tar.gz: a7e0085fb8a08fb2b2de12dd2b86455fcc30b2dabf0021a4615ff347b3391eea
+SHA512:
+  metadata.gz: 82769d5b529d51aebc6c61894ec1ada6ac408dabc5af37d9ea091a4b952349ee63a848f2dd252c28ab34f44a549c303da854efc1092c3bb1e20e776870b8c2ac
+  data.tar.gz: 7aece81108b6f4f36eecc4cba8c953063829e172a80e5a1303d61b5585f7ec7bf4d53a92c3d459197428c1c16f25ee2f7fb1bd7e4a4a79ad17b5a16053138b1f

data/CHANGELOG.md

@@ -0,0 +1,3 @@
+### 0.1.0 / 2021-03-05
+
+* Everything is new. First release.

data/Manifest.txt

@@ -0,0 +1,20 @@
+CHANGELOG.md
+Manifest.txt
+README.md
+Rakefile
+data/categories.csv
+data/comparisons.csv
+lib/factbook-fields.rb
+lib/factbook-fields/builder.rb
+lib/factbook-fields/category.rb
+lib/factbook-fields/comparisons.rb
+lib/factbook-fields/field.rb
+lib/factbook-fields/normalize.rb
+lib/factbook-fields/profile.rb
+lib/factbook-fields/version.rb
+lib/factbook/fields.rb
+test/helper.rb
+test/test_builder.rb
+test/test_comparisons.rb
+test/test_fields.rb
+test/test_normalize.rb

data/README.md

@@ -0,0 +1,21 @@
+# factbook-fields -  world factbook country profile meta data - categories, fields, subfields, and more
+
+
+* home  :: [github.com/factbook/factbook](https://github.com/factbook/factbook)
+* bugs  :: [github.com/factbook/factbook/issues](https://github.com/factbook/factbook/issues)
+* gem   :: [rubygems.org/gems/factbook-fields](https://rubygems.org/gems/factbook-fields)
+* rdoc  :: [rubydoc.info/gems/factbook-fields](http://rubydoc.info/gems/factbook-fields)
+* forum :: [groups.google.com/group/openmundi](https://groups.google.com/group/openmundi)
+
+
+## What's the World Factbook?
+
+See [factbook/factbook.json »](https://github.com/factbook/factbook.json)
+
+
+
+## Usage
+
+to be done
+
+

data/Rakefile

@@ -0,0 +1,31 @@
+require 'hoe'
+require './lib/factbook-fields/version.rb'
+
+
+Hoe.spec 'factbook-fields' do
+
+  self.version = Factbook::Module::Fields::VERSION
+
+  self.summary = 'factbook-fields - world factbook country profile meta data - categories, fields, subfields, and more'
+  self.description = summary
+
+  self.urls = { home: 'https://github.com/factbook/factbook' }
+
+  self.author = 'Gerald Bauer'
+  self.email  = 'openmundi@googlegroups.com'
+
+  # switch extension to .markdown for gihub formatting
+  self.readme_file  = 'README.md'
+  self.history_file = 'CHANGELOG.md'
+
+  self.extra_deps = [
+    ['factbook-codes' ],
+  ]
+
+  self.licenses = ['Public Domain']
+
+  self.spec_extras = {
+   required_ruby_version: '>= 2.2.2'
+  }
+
+end

data/data/categories.csv

@@ -0,0 +1,164 @@
+Num,Category,Name,Notes
+,Introduction,Background,
+,Geography,Location,
+,Geography,Geographic coordinates,
+,Geography,Map references,
+,Geography,Area,
+,Geography,Area - comparative,
+,Geography,Land boundaries,
+,Geography,Coastline,
+,Geography,Maritime claims,
+,Geography,Climate,
+,Geography,Terrain,
+,Geography,Elevation extremes,
+,Geography,Natural resources,
+,Geography,Land use,
+,Geography,Irrigated land,
+,Geography,Total renewable water resources,
+,Geography,Freshwater withdrawal (domestic/industrial/agricultural),
+,Geography,Natural hazards,
+,Geography,Environment - current issues,
+,Geography,Environment - international agreements,
+,Geography,Geography - note,
+,People and Society,Nationality,
+,People and Society,Ethnic groups,
+,People and Society,Languages,
+,People and Society,Religions,
+,People and Society,Population,
+,People and Society,Age structure,
+,People and Society,Dependency ratios,
+,People and Society,Median age,
+,People and Society,Population growth rate,
+,People and Society,Birth rate,
+,People and Society,Death rate,
+,People and Society,Net migration rate,
+,People and Society,Urbanization,
+,People and Society,Major urban areas - population,
+,People and Society,Sex ratio,
+,People and Society,Infant mortality rate,
+,People and Society,Life expectancy at birth,
+,People and Society,Total fertility rate,
+,People and Society,Contraceptive prevalence rate,
+,People and Society,Health expenditures,
+,People and Society,Physicians density,
+,People and Society,Hospital bed density,
+,People and Society,Drinking water source,
+,People and Society,Sanitation facility access,
+,People and Society,HIV/AIDS - adult prevalence rate,
+,People and Society,HIV/AIDS - people living with HIV/AIDS,
+,People and Society,HIV/AIDS - deaths,
+,People and Society,Obesity - adult prevalence rate,
+,People and Society,Education expenditures,
+,People and Society,School life expectancy (primary to tertiary education),
+,People and Society,"Unemployment, youth ages 15-24",
+,Government,Country name,
+,Government,Government type,
+,Government,Capital,
+,Government,Administrative divisions,
+,Government,Independence,
+,Government,National holiday,
+,Government,Constitution,
+,Government,Legal system,
+,Government,International law organization participation,
+,Government,Suffrage,
+,Government,Executive branch,
+,Government,Legislative branch,
+,Government,Judicial branch,
+,Government,Political parties and leaders,
+,Government,Political pressure groups and leaders,
+,Government,International organization participation,
+,Government,Diplomatic representation in the US,
+,Government,Diplomatic representation from the US,
+,Government,Flag description,
+,Government,National symbol(s),
+,Government,National anthem,
+,Economy,Economy - overview,
+,Economy,GDP (purchasing power parity),
+,Economy,GDP (official exchange rate),
+,Economy,GDP - real growth rate,
+,Economy,GDP - per capita (PPP),
+,Economy,Gross national saving,
+,Economy,"GDP - composition, by end use",
+,Economy,"GDP - composition, by sector of origin",
+,Economy,Agriculture - products,
+,Economy,Industries,
+,Economy,Industrial production growth rate,
+,Economy,Labor force,
+,Economy,Labor force - by occupation,
+,Economy,Unemployment rate,
+,Economy,Population below poverty line,
+,Economy,Household income or consumption by percentage share,
+,Economy,Distribution of family income - Gini index,
+,Economy,Budget,
+,Economy,Taxes and other revenues,
+,Economy,Budget surplus (+) or deficit (-),
+,Economy,Public debt,
+,Economy,Fiscal year,
+,Economy,Inflation rate (consumer prices),
+,Economy,Commercial bank prime lending rate,
+,Economy,Stock of narrow money,
+,Economy,Stock of broad money,
+,Economy,Stock of domestic credit,
+,Economy,Market value of publicly traded shares,
+,Economy,Current account balance,
+,Economy,Exports,
+,Economy,Exports - commodities,
+,Economy,Exports - partners,
+,Economy,Imports,
+,Economy,Imports - commodities,
+,Economy,Imports - partners,
+,Economy,Reserves of foreign exchange and gold,
+,Economy,Debt - external,
+,Economy,Stock of direct foreign investment - at home,
+,Economy,Stock of direct foreign investment - abroad,
+,Economy,Exchange rates,
+,Energy,Electricity - production,
+,Energy,Electricity - consumption,
+,Energy,Electricity - exports,
+,Energy,Electricity - imports,
+,Energy,Electricity - installed generating capacity,
+,Energy,Electricity - from fossil fuels,
+,Energy,Electricity - from nuclear fuels,
+,Energy,Electricity - from hydroelectric plants,
+,Energy,Electricity - from other renewable sources,
+,Energy,Crude oil - production,
+,Energy,Crude oil - exports,
+,Energy,Crude oil - imports,
+,Energy,Crude oil - proved reserves,
+,Energy,Refined petroleum products - production,
+,Energy,Refined petroleum products - consumption,
+,Energy,Refined petroleum products - exports,
+,Energy,Refined petroleum products - imports,
+,Energy,Natural gas - production,
+,Energy,Natural gas - consumption,
+,Energy,Natural gas - exports,
+,Energy,Natural gas - imports,
+,Energy,Natural gas - proved reserves,
+,Energy,Carbon dioxide emissions from consumption of energy,
+,Communications,Telephones - fixed lines,
+,Communications,Telephones - mobile cellular,
+,Communications,Telephone system,
+,Communications,Broadcast media,
+,Communications,Radio broadcast stations,
+,Communications,Television broadcast stations,
+,Communications,Internet country code,
+,Communications,Internet users,
+,Transportation,Airports,
+,Transportation,Airports - with paved runways,
+,Transportation,Airports - with unpaved runways,
+,Transportation,Heliports,
+,Transportation,Pipelines,
+,Transportation,Railways,
+,Transportation,Roadways,
+,Transportation,Waterways,
+,Transportation,Merchant marine,
+,Transportation,Ports and terminals,
+,Military,Military branches,
+,Military,Military service age and obligation,
+,Military,Manpower available for military service,
+,Military,Manpower fit for military service,
+,Military,Manpower reaching militarily significant age annually,
+,Military,Military expenditures,
+,Transnational Issues,Disputes - international,
+,Transnational Issues,Refugees and internally displaced persons,
+,Transnational Issues,Illicit drugs,

data/data/comparisons.csv

@@ -0,0 +1,75 @@
+Num,Category,Name
+2147,Geography,Area
+2119,People and Society,Population
+2002,People and Society,Population growth rate
+2054,People and Society,Birth rate
+2066,People and Society,Death rate
+2112,People and Society,Net migration rate
+2223,People and Society,Maternal mortality rate
+2091,People and Society,Infant mortality rate
+2102,People and Society,Life expectancy at birth
+2127,People and Society,Total fertility rate
+2225,People and Society,Health expenditures
+2155,People and Society,HIV/AIDS - adult prevalence rate
+2156,People and Society,HIV/AIDS - people living with HIV/AIDS
+2157,People and Society,HIV/AIDS - deaths
+2228,People and Society,Obesity - adult prevalence rate
+2224,People and Society,Children under the age of 5 years underweight
+2206,People and Society,Education expenditures
+2229,People and Society,"Unemployment, youth ages 15-24"
+2001,Economy,GDP (purchasing power parity)
+2003,Economy,GDP - real growth rate
+2004,Economy,GDP - per capita (PPP)
+2260,Economy,Gross national saving
+2089,Economy,Industrial production growth rate
+2095,Economy,Labor force
+2129,Economy,Unemployment rate
+2172,Economy,Distribution of family income - Gini index
+2221,Economy,Taxes and other revenues
+2222,Economy,Budget surplus (+) or deficit (-)
+2186,Economy,Public debt
+2092,Economy,Inflation rate (consumer prices)
+2207,Economy,Central bank discount rate
+2208,Economy,Commercial bank prime lending rate
+2214,Economy,Stock of narrow money
+2215,Economy,Stock of broad money
+2211,Economy,Stock of domestic credit
+2200,Economy,Market value of publicly traded shares
+2187,Economy,Current account balance
+2078,Economy,Exports
+2087,Economy,Imports
+2188,Economy,Reserves of foreign exchange and gold
+2079,Economy,Debt - external
+2198,Economy,Stock of direct foreign investment - at home
+2199,Economy,Stock of direct foreign investment - abroad
+2232,Energy,Electricity - production
+2233,Energy,Electricity - consumption
+2234,Energy,Electricity - exports
+2235,Energy,Electricity - imports
+2236,Energy,Electricity - installed generating capacity
+2237,Energy,Electricity - from fossil fuels
+2239,Energy,Electricity - from nuclear fuels
+2238,Energy,Electricity - from hydroelectric plants
+2240,Energy,Electricity - from other renewable sources
+2241,Energy,Crude oil - production
+2242,Energy,Crude oil - exports
+2243,Energy,Crude oil - imports
+2244,Energy,Crude oil - proved reserves
+2245,Energy,Refined petroleum products - production
+2246,Energy,Refined petroleum products - consumption
+2247,Energy,Refined petroleum products - exports
+2248,Energy,Refined petroleum products - imports
+2249,Energy,Natural gas - production
+2250,Energy,Natural gas - consumption
+2251,Energy,Natural gas - exports
+2252,Energy,Natural gas - imports
+2253,Energy,Natural gas - proved reserves
+2150,Communications,Telephones - fixed lines
+2151,Communications,Telephones - mobile cellular
+2153,Communications,Internet users
+2053,Transportation,Airports
+2121,Transportation,Railways
+2085,Transportation,Roadways
+2093,Transportation,Waterways
+2108,Transportation,Merchant marine
+2034,Military,Military expenditures

data/lib/factbook-fields.rb

@@ -0,0 +1,30 @@
+
+
+require 'factbook/codes'
+
+
+# our own code
+require 'factbook-fields/version' # let it always go first
+
+require 'factbook-fields/category'
+require 'factbook-fields/field'
+require 'factbook-fields/profile'
+
+require 'factbook-fields/normalize'
+require 'factbook-fields/builder'
+
+require 'factbook-fields/comparisons'
+
+## note: make codes, comparisons available
+module Factbook
+  ##  note: load on demand only builtin codes, comparisons, etc.
+  ##          for now
+  def self.comparisons
+    @@comparisons ||= Comparisons.read_csv( "#{Factbook::Module::Fields.root}/data/comparisons.csv" )
+  end
+end # module Factbook
+
+
+
+
+puts Factbook::Module::Fields.banner

data/lib/factbook-fields/builder.rb

@@ -0,0 +1,67 @@
+
+module Factbook
+
+
+######
+# builder -- lets us rebuild a profile from "dumped" hash
+
+class ProfileBuilder      ## change to DataBuilder or such - why? why not?
+  include LogUtils::Logging
+  include NormalizeHelper    ##  e.g. normalize_category
+
+
+attr_reader :profile,
+            :errors           ## not used yet -- encoding erros etc.
+
+
+
+
+
+def initialize( text_or_data )
+
+  data = if text_or_data.is_a?( String )
+           text = text_or_data
+           JSON.parse( text )
+         else  ## assume it's already a hash
+            text_or_data
+         end
+
+
+  @profile = Profile.new
+  @errors  = []       ## fix/todo: sorry - for now no errors possible/tracked
+
+  data.each do |k1,v1|
+    category_title    = k1
+    category_data     = v1
+
+    category = Category.new( category_title )
+
+    ## get fields
+    category_data.each do |k2,v2|
+      field_title = k2
+      field_data  = v2
+
+      field = Field.new( field_title )
+
+      #####
+      ## note: run data hash through normalize_title (again)
+      if field_data.is_a?( Hash )
+        new_field_data = {}
+        field_data.each do |k3,v3|
+          new_field_data[ normalize_title(k3) ] = v3
+        end
+        field_data = new_field_data
+      end
+
+      field.data  = field_data
+
+      category << field
+    end
+    @profile << category
+  end
+end
+
+end # class ProfileBuilder
+
+
+end # module Factbook

data/lib/factbook-fields/category.rb

@@ -0,0 +1,41 @@
+
+module Factbook
+
+
+class Category
+  include LogUtils::Logging
+
+  attr_reader :title        ## use name instead of title - why? why not?
+
+  def initialize( title )
+    @title  = title
+    @fields = {}
+  end
+
+  def add( field )
+    @fields[ field.title ] = field
+  end
+  alias_method :<<, :add
+
+
+  def [](key)  ### convenience shortcut
+    @fields[ key ]
+  end
+
+  def size()   @fields.size; end
+
+
+
+  def data   ## convert to hash
+    ## todo/fix: how to know when to rebuild?
+    ##   for now @data MUST be reset to nil manually
+    data = {}
+    @fields.each do |_,field|
+      data[ field.title ] = field.data
+    end
+    data
+  end
+
+end # class Category
+
+end # module Factbook

data/lib/factbook-fields/comparisons.rb

@@ -0,0 +1,49 @@
+
+module Factbook
+
+class Comparisons
+
+  Comparison = Struct.new( :num,        ### todo: use no or id or something - why? why not?
+                           :category,  ## e.g. Geography, People, Economy, etc.
+                           :name,
+                          )
+
+  def self.read_csv( path )
+
+    rows = CsvHash.read( path )
+
+    pp rows
+
+    recs = []
+    rows.each do |row|
+      pp row
+      rec = Comparison.new
+      rec.num      = row['Num'].strip.to_i    ## remove leading n trailing whitespaces
+      rec.category = row['Category'].strip
+      rec.name     = row['Name'].strip
+
+      pp rec
+      recs << rec
+    end
+
+    new( recs )
+  end
+
+  def initialize( comps )
+    @comps = comps
+  end
+
+  def size() @comps.size; end
+
+  def each
+    @comps.each {|comp| yield( comp ) }
+  end
+
+  def to_a
+    @comps.collect {|comp| comp.num }   ## return array of nums   -- return something else - why? why not?
+  end
+
+end  # class Comparison
+
+end # module Factbook
+

data/lib/factbook-fields/field.rb

@@ -0,0 +1,23 @@
+
+module Factbook
+
+
+class Field
+  include LogUtils::Logging
+
+  attr_reader   :title        ## use name instead of title - why? why not?
+
+  attr_accessor :data         ## hash holding data e.g. { 'text' => '...' etc. }
+
+  def initialize( title )
+    @title = title
+    @data  = {}
+  end
+
+  def [](key)  ### convenience shortcut
+    @data[ key ]
+  end
+
+end # class Field
+
+end # module Factbook

data/lib/factbook-fields/normalize.rb

@@ -0,0 +1,42 @@
+
+module Factbook
+  module NormalizeHelper
+
+
+def normalize_title( text )
+
+  ## note: fix typos/errors with double colons e.g. note::  (instead of note:)
+
+  text = text.strip
+  text = text.sub( /:+\z/, '' )      # remove trailing : if present -- note: allow (fix) note:: too, thus, use :+
+  text = text.strip
+
+  #######################################
+  ### special cases
+
+  ##   typos e.g ntoe => use note
+  text = 'note'                         if text == 'ntoe'
+  text = 'investment in fixed capital'  if text == 'investment if fixed capital'
+
+  ##  downcase
+  text = 'lowest point'    if text == 'Lowest point'
+  text = 'chief of state'  if text == 'Chief of state'
+
+  ##  spelling variant (use more popular one)
+  text = 'signed, but not ratified'     if text == 'signed but not ratified'
+  text = 'vectorborne diseases'         if text == 'vectorborne disease'
+  text = 'water contact disease'        if text == 'water contact diseases'
+  text = 'food or waterborne diseases'  if text == 'food or waterborne disease'
+  text = 'geographic coordinates'       if text == 'geographical coordinates'
+  text = 'note'                         if text == 'notes'
+  text = 'refugees (country of origin)' if text == 'refugees (countries of origin)'
+
+  ##    border countries (8):   -- remove (x) counter
+  text = 'border countries'   if text.start_with?( 'border countries')
+
+  text
+end
+
+
+  end # module NormalizeHelper
+end  # module Factbook

data/lib/factbook-fields/profile.rb

@@ -0,0 +1,57 @@
+
+module Factbook
+
+
+class Profile
+  include LogUtils::Logging
+
+  ## attr_reader :categories   ## "structured" access e.g. categories/fields/etc.
+  ##   use each for access by default for categories - why? why not?
+
+
+  def self.read( path )   ## convenience helper
+    text = File.open( path, 'r:utf-8' ) { |f| f.read }
+    b = ProfileBuilder.new( text )
+    b.profile
+  end
+
+
+  def initialize
+    @categories = {}
+  end
+
+  def add( category )
+    @categories[ category.title ] = category
+  end
+  alias_method :<<, :add
+
+  def [](key)  ### convenience shortcut
+    if key.is_a?( Integer )  ## allow access by 0,1,2, etc.
+      @categories.values[ key ]
+    else
+      @categories[key]
+    end
+  end
+
+  def size()   @categories.size; end
+
+
+
+  def to_h
+    data = {}
+    @categories.each do |_,category|
+       data[ category.title ] = category.data
+    end
+    data
+  end
+
+  def to_json( minify: false )  ## convenience helper for data.to_json; note: pretty print by default!
+    if minify
+      to_h.to_json
+    else ## note: pretty print by default!
+      JSON.pretty_generate( to_h )
+    end
+  end
+
+end # class Profile
+end # module Factbook

data/lib/factbook-fields/version.rb

@@ -0,0 +1,24 @@
+
+module Factbook
+module  Module
+module   Fields
+  MAJOR = 0
+  MINOR = 1
+  PATCH = 0
+  VERSION = [MAJOR,MINOR,PATCH].join('.')
+
+  def self.version
+    VERSION
+  end
+
+  def self.banner
+    "factbook-fields/#{VERSION} on Ruby #{RUBY_VERSION} (#{RUBY_RELEASE_DATE}) [#{RUBY_PLATFORM}] in (#{root})"
+  end
+
+  def self.root
+    File.expand_path( File.dirname(File.dirname(File.dirname(__FILE__))) )
+  end
+
+end # module Fields
+end # module Module
+end # module Factbook

data/lib/factbook/fields.rb

@@ -0,0 +1,6 @@
+# note: allow require 'factbook/fields' too
+#        (in addition to require 'factbook-fields')
+
+require_relative '../factbook-fields'
+
+

data/test/helper.rb

@@ -0,0 +1,10 @@
+$LOAD_PATH.unshift( "../factbook-codes/lib" )
+
+## minitest setup
+require 'minitest/autorun'
+
+
+## our own code
+require 'factbook/fields'
+
+

data/test/test_builder.rb

@@ -0,0 +1,30 @@
+###
+#  to run use
+#     ruby -I ./lib -I ./test test/test_builder.rb
+
+
+require 'helper'
+
+
+class TestBuilder < MiniTest::Test
+
+  def test_read
+    code = 'au'
+    path = "#{Factbook::Module::Fields.root}/../testdata/json/#{code}.json"
+    profile = Factbook::Profile.read( path )
+
+    assert_equal 11, profile.size
+    assert_equal  1, profile[0].size                ## e.g. Introduction/Background
+    assert_equal  1, profile['Introduction'].size   ## e.g. Introduction/Background
+
+    assert_equal 'Central Europe, north of Italy and Slovenia',
+                 profile['Geography']['Location']['text']
+    assert_equal '83,871 sq km',
+                 profile['Geography']['Area']['total']['text']
+
+
+    assert true    ## assume everthing ok
+  end
+
+end # class TestBuilder
+

data/test/test_comparisons.rb

@@ -0,0 +1,16 @@
+###
+#  to run use
+#     ruby -I ./lib -I ./test test/test_comparisons.rb
+
+
+require 'helper'
+
+
+class TestComparisons < MiniTest::Test
+
+  def test_comparisons
+    assert_equal 74, Factbook.comparisons.size
+    assert_equal 74, Factbook.comparisons.to_a.size
+  end
+
+end # class TestComparisons

data/test/test_fields.rb

@@ -0,0 +1,59 @@
+###
+#  to run use
+#     ruby -I ./lib -I ./test test/test_fields.rb
+
+
+require 'helper'
+
+
+class TestFields < MiniTest::Test
+
+  def test_fields_new
+
+    field0 = Factbook::Field.new( 'Location' )
+    field0.data  = { 'text' => 'Central Europe, north of Italy and Slovenia' }
+
+    field1 = Factbook::Field.new( 'Geographic coordinates' )
+    field1.data  = { 'text' => '47 20 N, 13 20 E' }
+
+    category = Factbook::Category.new( 'Geography' )
+    category << field0
+    category << field1
+
+    profile = Factbook::Profile.new
+    profile << category
+
+
+    assert_equal 'Central Europe, north of Italy and Slovenia',
+                 profile[ 'Geography' ][ 'Location' ][ 'text' ]
+
+    assert_equal '47 20 N, 13 20 E',
+                 profile[ 'Geography' ][ 'Geographic coordinates' ][ 'text' ]
+
+    pp profile
+
+    puts
+    puts "json:"
+    puts profile.to_json
+  end
+
+
+  def test_fields_au
+    # note: use builtin test page (do NOT fetch via internet)
+    code = 'au'
+    path = "#{Factbook::Module::Fields.root}/../testdata/json/#{code}.json"
+    profile  = Factbook::Profile.read( path )
+
+    assert_equal '-0.7% (of GDP) (2017 est.)',
+                  profile['Economy']['Budget surplus (+) or deficit (-)']['text']
+    assert_equal '0.7%',
+                  profile['Economy']['Labor force - by occupation']['agriculture']['text']
+
+    assert_equal 'Enns, Krems, Linz, Vienna (Danube)',
+                 profile['Transportation']['Ports and terminals']['river port(s)']['text']
+  end
+
+
+
+end # class TestFields
+

data/test/test_normalize.rb

@@ -0,0 +1,21 @@
+###
+#  to run use
+#     ruby -I ./lib -I ./test test/test_normalize.rb
+
+
+require 'helper'
+
+
+class TestNormalizer < MiniTest::Test
+
+  include Factbook::NormalizeHelper
+
+  def test_normalize
+    assert_equal 'border countries', normalize_title( 'border countries:'  )
+    assert_equal 'border countries', normalize_title( 'border countries: ' )
+    assert_equal 'border countries', normalize_title( 'border countries (8):' )
+    assert_equal 'border countries', normalize_title( 'border countries (10): ' )
+  end
+
+end # class TestNormalizer
+

metadata

@@ -0,0 +1,117 @@
+--- !ruby/object:Gem::Specification
+name: factbook-fields
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Gerald Bauer
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2021-03-05 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: factbook-codes
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rdoc
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '4.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '4.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '7'
+- !ruby/object:Gem::Dependency
+  name: hoe
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.22'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.22'
+description: factbook-fields - world factbook country profile meta data - categories,
+  fields, subfields, and more
+email: openmundi@googlegroups.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- CHANGELOG.md
+- Manifest.txt
+- README.md
+files:
+- CHANGELOG.md
+- Manifest.txt
+- README.md
+- Rakefile
+- data/categories.csv
+- data/comparisons.csv
+- lib/factbook-fields.rb
+- lib/factbook-fields/builder.rb
+- lib/factbook-fields/category.rb
+- lib/factbook-fields/comparisons.rb
+- lib/factbook-fields/field.rb
+- lib/factbook-fields/normalize.rb
+- lib/factbook-fields/profile.rb
+- lib/factbook-fields/version.rb
+- lib/factbook/fields.rb
+- test/helper.rb
+- test/test_builder.rb
+- test/test_comparisons.rb
+- test/test_fields.rb
+- test/test_normalize.rb
+homepage: https://github.com/factbook/factbook
+licenses:
+- Public Domain
+metadata: {}
+post_install_message:
+rdoc_options:
+- "--main"
+- README.md
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.2.2
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.1.4
+signing_key:
+specification_version: 4
+summary: factbook-fields - world factbook country profile meta data - categories,
+  fields, subfields, and more
+test_files: []