ziptedu 0.1.0

data/lib/ziptedu.rb

@@ -0,0 +1,39 @@
+require "ziptedu/version"
+require "ziptedu/zipcode"
+require "ziptedu/zipcode_parser"
+
+module Ziptedu
+  class << self
+
+    ZIPS_CSV_FILE = File.join(__dir__, 'data', 'zips.csv')
+
+    def initialize
+      zipcodes
+    end
+
+    def random(how_many = 1)
+      zipcodes.sample(how_many)
+    end
+
+    def zipcode(zipcode)
+      zipcodes.find { |zip| zip.zipcode == zipcode.to_s }
+    end
+
+    def citystate(city, state)
+      zipcodes.find { |zip| zip.city.upcase == city.upcase && zip.state.upcase == state.upcase }
+    end
+
+    def latlong(latitude, longitude)
+      zipcodes.reject { |zip| !zip.longitude || !zip.latitude }
+        .find { |zip| zip.latitude.upcase == latitude.to_s.upcase && zip.longitude.upcase == longitude.to_s.upcase }
+    end
+
+    private
+
+    def zipcodes
+      # Cache zipcodes after doing this once...
+      @zipcodes ||= ZipcodeParser.parse ZIPS_CSV_FILE
+    end
+
+  end
+end

data/lib/ziptedu/version.rb

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

data/lib/ziptedu/zipcode.rb

@@ -0,0 +1,20 @@
+require 'json'
+
+module Ziptedu
+  class Zipcode
+  	attr_accessor :zipcode, :city, :state, :latitude, :longitude
+  	attr_reader :type
+
+  	def initialize
+  	  yield self if block_given?
+  	end
+
+  	def type=(type)
+  	  @type = type.downcase
+  	end
+
+  	def to_s
+  	  JSON.pretty_generate({ zipcode: zipcode, type: type, city: city, state: state, latitude: latitude, longitude: longitude })
+  	end
+  end
+end

data/lib/ziptedu/zipcode_parser.rb

@@ -0,0 +1,36 @@
+require 'csv'
+
+module Ziptedu
+  class ZipcodeParser
+
+  	def self.parse(csv_file_path)
+  	  # Initialize to an empty array
+      zipcodes = []
+
+      # We only care about a subset of columns in the CSV file
+      # Map the attributes in the Zipcode class to headers in CSV file
+      attr_to_csv_mapping = {
+      	zipcode: "Zipcode",
+        type: "ZipCodeType",
+        city: "City",
+       	state: "State",
+        latitude: "Lat",
+        longitude: "Long"
+      }
+
+	  CSV.foreach(csv_file_path, headers: true) do |data|
+
+    	zipcode = Zipcode.new do |zip|
+    		attr_to_csv_mapping.each do |attr, csv_header_name|
+    			zip.send "#{attr}=", data[csv_header_name]
+    		end
+    	end
+
+        zipcodes << zipcode
+      end
+
+      zipcodes
+  	end
+
+  end
+end

data/ziptedu.gemspec

@@ -0,0 +1,28 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'ziptedu/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "ziptedu"
+  spec.version       = Ziptedu::VERSION
+  spec.authors       = ["Kalman Hazins"]
+  spec.email         = ["kalman.hazins@ghs.com"]
+
+  spec.summary       = %q{ Zip code to city, state translator. (Ruby) }
+  spec.description   = %q{ Functions for looking up zipcode, city, state, latitude and longitude using a zipcode,
+                           city + state, or latitude + longitude. You can also get random sets of this data.}
+  spec.homepage      = "https://github.com/kalmanh/ziptedu"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|spec|features)/})
+  end
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.13"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec", "~> 3.0"
+end

metadata

@@ -0,0 +1,103 @@
+--- !ruby/object:Gem::Specification
+name: ziptedu
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Kalman Hazins
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2016-09-16 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.13'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.13'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: |2-
+   Functions for looking up zipcode, city, state, latitude and longitude using a zipcode,
+                             city + state, or latitude + longitude. You can also get random sets of this data.
+email:
+- kalman.hazins@ghs.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- lib/data/zips.csv
+- lib/ziptedu.rb
+- lib/ziptedu/version.rb
+- lib/ziptedu/zipcode.rb
+- lib/ziptedu/zipcode_parser.rb
+- ziptedu.gemspec
+homepage: https://github.com/kalmanh/ziptedu
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.6
+signing_key: 
+specification_version: 4
+summary: Zip code to city, state translator. (Ruby)
+test_files: []