geonames_api 0.0.3 → 0.0.4

data/README.md

@@ -73,7 +73,12 @@ The geonames api uses the ISO code of the country as its natural key.
     
     => ... array of GeoNamesAPI::Country instances
     
-There are no additional methods offered for countries.
+The [postal code exports](http://download.geonames.org/export/zip/) are also available for each country either in string of ruby CSV form.
+
+    # String
+    > GeoNamesAPI::Country.find("US").postal_code_export
+    # CSV::Table
+    > GeoNamesAPI::Country.find("US").postal_code_csv
 
 ### Weather
 

data/geonames_api.gemspec

@@ -11,7 +11,10 @@ Gem::Specification.new do |gem|
   gem.description   = %q{Simple ruby client for the GeoNames API to get free and easy geographic info.}
   gem.summary       = %q{This is a lightweight client for the GeoNames API. Huge thanks to them for such a great service! There are many GeoNames API clients. BUT, most are rewritten versions of a Java API whose interface is a little funny =| This is a simplified ruby implementation that does not implement the entire API. But, its lightweight and has a nice interface and will be easy to extend :)}
   gem.homepage      = "https://github.com/buytruckload/geonames_api"
+  
   gem.add_runtime_dependency "activesupport"
+  gem.add_runtime_dependency "zipruby"
+  
   gem.files         = `git ls-files`.split($/)
   gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
   gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})

data/lib/geonames_api.rb

@@ -1,6 +1,8 @@
 require 'open-uri'
 require 'json'
+require 'csv'
 require 'active_support/all'
+require 'zipruby'
 require "geonames_api/version"
 require "geonames_api/hash"
 require "geonames_api/error"

data/lib/geonames_api/country.rb

@@ -2,7 +2,30 @@ module GeoNamesAPI
   class Country < GeoNamesAPI::Object
 
     METHOD = "countryInfoJSON"
-    ID = "country"        
+    ID = "country"
 
+    EXPORT_BASE_URL = "http://download.geonames.org/export/zip/"
+    EXPORT_HEADERS = %W(country_code postal_code place_name admin_name1 admin_code1 admin_name2 admin_code2 admin_name3 admin_code3 latitude longitude accuracy)
+
+    def postal_code_export
+      zip_data = open(postal_code_export_url) { |f| f.binmode; f.read }
+      stream = lambda { return zip_data.slice!(0, 256) }
+      csv = EXPORT_HEADERS.join("\t") + "\n"
+      Zip::Archive.open_buffer(stream) do |archive|
+        archive.each do |f|
+          csv << f.read if f.name =~ /\A#{country_code}/
+        end
+      end
+      csv
+    end
+    
+    def postal_code_csv
+      CSV.parse(postal_code_export, headers: true, col_sep: "\t", header_converters: :symbol)
+    end
+    
+    def postal_code_export_url
+      EXPORT_BASE_URL + country_code + ".zip"
+    end
+    
   end
 end

data/lib/geonames_api/version.rb

@@ -1,3 +1,3 @@
 module GeoNamesAPI
-  VERSION = "0.0.3"
+  VERSION = "0.0.4"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: geonames_api
 version: !ruby/object:Gem::Version
-  version: 0.0.3
+  version: 0.0.4
   prerelease: 
 platform: ruby
 authors:
@@ -27,6 +27,22 @@ dependencies:
     - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: zipruby
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 description: Simple ruby client for the GeoNames API to get free and easy geographic
   info.
 email: