geography_helper 0.1.0

data/.gitignore

@@ -0,0 +1,9 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/

data/.rspec

@@ -0,0 +1,2 @@
+--format documentation
+--color

data/.travis.yml

@@ -0,0 +1,4 @@
+language: ruby
+rvm:
+  - 2.0.0
+before_install: gem install bundler -v 1.10.3

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in geography_helper.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2017 Eric Iacutone
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,49 @@
+# GeographyHelper
+
+One source of truth for countries both states and provinces. I built this because it is easy to get into the habit of putting an array of arrays of states and countries into `application.rb`. This gem also uses hashes instead of nested arrays, making it easier to call values from a key. This approach is more efficient than looping through an array of arrays to find a correct state or country value. It is also easier to understand, for example, calling `state['NY'] => 'New York'`.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'geography_helper'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install geography_helper
+
+## Usage
+
+call `GeographyHelper.states` for a hash of states and provinces
+call `GeographyHelper.countries` for a hash of countries
+
+The gem also provides helper two methods to render state/province and country dropdowns from a Rails select dropdown.
+
+* `country_options_for_select`
+* `state_options_for_select` 
+
+``` ruby example.html.erb
+<%= form.select :country, country_options_for_select, {include_blank: true} %>
+```
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake rspec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/iacutone/geography_helper.
+
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
+

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "geography_helper"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start

data/bin/setup

@@ -0,0 +1,7 @@
+#!/bin/bash
+set -euo pipefail
+IFS=$'\n\t'
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/geography_helper.gemspec

@@ -0,0 +1,24 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'geography_helper/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "geography_helper"
+  spec.version       = GeographyHelper::VERSION
+  spec.authors       = ["Eric Iacutone"]
+  spec.email         = ["eric.iacutone@gmail.com"]
+
+  spec.summary       = "Hash state, province and country codes."
+  spec.homepage      = "https://github.com/iacutone/geography_helper"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.10"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec"
+end

data/lib/geography_helper.rb

@@ -0,0 +1,7 @@
+require "geography_helper/version"
+require 'geography_helper/states'
+require 'geography_helper/countries'
+require 'geography_helper/form_options_helper'
+
+module GeographyHelper
+end

data/lib/geography_helper/countries.rb

@@ -0,0 +1,254 @@
+module GeographyHelper
+  class Countries
+
+    def countries
+        {
+          'US' => 'United States',
+          'AF' => 'Afghanistan',
+          'AX' => 'Aland Islands',
+          'AL' => 'Albania',
+          'DZ' => 'Algeria',
+          'AS' => 'American Samoa',
+          'AD' => 'Andorra',
+          'AO' => 'Angola',
+          'AI' => 'Anguilla',
+          'AQ' => 'Antarctica',
+          'AG' => 'Antigua And Barbuda',
+          'AR' => 'Argentina',
+          'AM' => 'Armenia',
+          'AW' => 'Aruba',
+          'AU' => 'Australia',
+          'AT' => 'Austria',
+          'AZ' => 'Azerbaijan',
+          'BS' => 'Bahamas',
+          'BH' => 'Bahrain',
+          'BD' => 'Bangladesh',
+          'BB' => 'Barbados',
+          'BY' => 'Belarus',
+          'BE' => 'Belgium',
+          'BZ' => 'Belize',
+          'BJ' => 'Benin',
+          'BM' => 'Bermuda',
+          'BT' => 'Bhutan',
+          'BO' => 'Bolivia',
+          'BA' => 'Bosnia And Herzegovina',
+          'BW' => 'Botswana',
+          'BV' => 'Bouvet Island',
+          'BR' => 'Brazil',
+          'IO' => 'British Indian Ocean Territory',
+          'BN' => 'Brunei Darussalam',
+          'BG' => 'Bulgaria',
+          'BF' => 'Burkina Faso',
+          'BI' => 'Burundi',
+          'KH' => 'Cambodia',
+          'CM' => 'Cameroon',
+          'CA' => 'Canada',
+          'CV' => 'Cape Verde',
+          'KY' => 'Cayman Islands',
+          'CF' => 'Central African Republic',
+          'TD' => 'Chad',
+          'CL' => 'Chile',
+          'CN' => 'China',
+          'CX' => 'Christmas Island',
+          'CC' => 'Cocos (Keeling) Islands',
+          'CO' => 'Colombia',
+          'KM' => 'Comoros',
+          'CG' => 'Congo',
+          'CD' => 'Congo, Democratic Republic',
+          'CK' => 'Cook Islands',
+          'CR' => 'Costa Rica',
+          'CI' => 'Cote D\'Ivoire',
+          'HR' => 'Croatia',
+          'CU' => 'Cuba',
+          'CY' => 'Cyprus',
+          'CZ' => 'Czech Republic',
+          'DK' => 'Denmark',
+          'DJ' => 'Djibouti',
+          'DM' => 'Dominica',
+          'DO' => 'Dominican Republic',
+          'EC' => 'Ecuador',
+          'EG' => 'Egypt',
+          'SV' => 'El Salvador',
+          'GQ' => 'Equatorial Guinea',
+          'ER' => 'Eritrea',
+          'EE' => 'Estonia',
+          'ET' => 'Ethiopia',
+          'FK' => 'Falkland Islands (Malvinas)',
+          'FO' => 'Faroe Islands',
+          'FJ' => 'Fiji',
+          'FI' => 'Finland',
+          'FR' => 'France',
+          'GF' => 'French Guiana',
+          'PF' => 'French Polynesia',
+          'TF' => 'French Southern Territories',
+          'GA' => 'Gabon',
+          'GM' => 'Gambia',
+          'GE' => 'Georgia',
+          'DE' => 'Germany',
+          'GH' => 'Ghana',
+          'GI' => 'Gibraltar',
+          'GR' => 'Greece',
+          'GL' => 'Greenland',
+          'GD' => 'Grenada',
+          'GP' => 'Guadeloupe',
+          'GU' => 'Guam',
+          'GT' => 'Guatemala',
+          'GG' => 'Guernsey',
+          'GN' => 'Guinea',
+          'GW' => 'Guinea-Bissau',
+          'GY' => 'Guyana',
+          'HT' => 'Haiti',
+          'HM' => 'Heard Island & Mcdonald Islands',
+          'VA' => 'Holy See (Vatican City State)',
+          'HN' => 'Honduras',
+          'HK' => 'Hong Kong',
+          'HU' => 'Hungary',
+          'IS' => 'Iceland',
+          'IN' => 'India',
+          'ID' => 'Indonesia',
+          'IR' => 'Iran, Islamic Republic Of',
+          'IQ' => 'Iraq',
+          'IE' => 'Ireland',
+          'IM' => 'Isle Of Man',
+          'IL' => 'Israel',
+          'IT' => 'Italy',
+          'JM' => 'Jamaica',
+          'JP' => 'Japan',
+          'JE' => 'Jersey',
+          'JO' => 'Jordan',
+          'KZ' => 'Kazakhstan',
+          'KE' => 'Kenya',
+          'KI' => 'Kiribati',
+          'KR' => 'Korea',
+          'KW' => 'Kuwait',
+          'KG' => 'Kyrgyzstan',
+          'LA' => 'Lao People\'s Democratic Republic',
+          'LV' => 'Latvia',
+          'LB' => 'Lebanon',
+          'LS' => 'Lesotho',
+          'LR' => 'Liberia',
+          'LY' => 'Libyan Arab Jamahiriya',
+          'LI' => 'Liechtenstein',
+          'LT' => 'Lithuania',
+          'LU' => 'Luxembourg',
+          'MO' => 'Macao',
+          'MK' => 'Macedonia',
+          'MG' => 'Madagascar',
+          'MW' => 'Malawi',
+          'MY' => 'Malaysia',
+          'MV' => 'Maldives',
+          'ML' => 'Mali',
+          'MT' => 'Malta',
+          'MH' => 'Marshall Islands',
+          'MQ' => 'Martinique',
+          'MR' => 'Mauritania',
+          'MU' => 'Mauritius',
+          'YT' => 'Mayotte',
+          'MX' => 'Mexico',
+          'FM' => 'Micronesia, Federated States Of',
+          'MD' => 'Moldova',
+          'MC' => 'Monaco',
+          'MN' => 'Mongolia',
+          'ME' => 'Montenegro',
+          'MS' => 'Montserrat',
+          'MA' => 'Morocco',
+          'MZ' => 'Mozambique',
+          'MM' => 'Myanmar',
+          'NA' => 'Namibia',
+          'NR' => 'Nauru',
+          'NP' => 'Nepal',
+          'NL' => 'Netherlands',
+          'AN' => 'Netherlands Antilles',
+          'NC' => 'New Caledonia',
+          'NZ' => 'New Zealand',
+          'NI' => 'Nicaragua',
+          'NE' => 'Niger',
+          'NG' => 'Nigeria',
+          'NU' => 'Niue',
+          'NF' => 'Norfolk Island',
+          'MP' => 'Northern Mariana Islands',
+          'NO' => 'Norway',
+          'OM' => 'Oman',
+          'PK' => 'Pakistan',
+          'PW' => 'Palau',
+          'PS' => 'Palestinian Territory, Occupied',
+          'PA' => 'Panama',
+          'PG' => 'Papua New Guinea',
+          'PY' => 'Paraguay',
+          'PE' => 'Peru',
+          'PH' => 'Philippines',
+          'PN' => 'Pitcairn',
+          'PL' => 'Poland',
+          'PT' => 'Portugal',
+          'PR' => 'Puerto Rico',
+          'QA' => 'Qatar',
+          'RE' => 'Reunion',
+          'RO' => 'Romania',
+          'RU' => 'Russian Federation',
+          'RW' => 'Rwanda',
+          'BL' => 'Saint Barthelemy',
+          'SH' => 'Saint Helena',
+          'KN' => 'Saint Kitts And Nevis',
+          'LC' => 'Saint Lucia',
+          'MF' => 'Saint Martin',
+          'PM' => 'Saint Pierre And Miquelon',
+          'VC' => 'Saint Vincent And Grenadines',
+          'WS' => 'Samoa',
+          'SM' => 'San Marino',
+          'ST' => 'Sao Tome And Principe',
+          'SA' => 'Saudi Arabia',
+          'SN' => 'Senegal',
+          'RS' => 'Serbia',
+          'SC' => 'Seychelles',
+          'SL' => 'Sierra Leone',
+          'SG' => 'Singapore',
+          'SK' => 'Slovakia',
+          'SI' => 'Slovenia',
+          'SB' => 'Solomon Islands',
+          'SO' => 'Somalia',
+          'ZA' => 'South Africa',
+          'GS' => 'South Georgia And Sandwich Isl.',
+          'ES' => 'Spain',
+          'LK' => 'Sri Lanka',
+          'SD' => 'Sudan',
+          'SR' => 'Suriname',
+          'SJ' => 'Svalbard And Jan Mayen',
+          'SZ' => 'Swaziland',
+          'SE' => 'Sweden',
+          'CH' => 'Switzerland',
+          'SY' => 'Syrian Arab Republic',
+          'TW' => 'Taiwan',
+          'TJ' => 'Tajikistan',
+          'TZ' => 'Tanzania',
+          'TH' => 'Thailand',
+          'TL' => 'Timor-Leste',
+          'TG' => 'Togo',
+          'TK' => 'Tokelau',
+          'TO' => 'Tonga',
+          'TT' => 'Trinidad And Tobago',
+          'TN' => 'Tunisia',
+          'TR' => 'Turkey',
+          'TM' => 'Turkmenistan',
+          'TC' => 'Turks And Caicos Islands',
+          'TV' => 'Tuvalu',
+          'UG' => 'Uganda',
+          'UA' => 'Ukraine',
+          'AE' => 'United Arab Emirates',
+          'GB' => 'United Kingdom',
+          'UM' => 'United States Outlying Islands',
+          'UY' => 'Uruguay',
+          'UZ' => 'Uzbekistan',
+          'VU' => 'Vanuatu',
+          'VE' => 'Venezuela',
+          'VN' => 'Viet Nam',
+          'VG' => 'Virgin Islands, British',
+          'VI' => 'Virgin Islands, U.S.',
+          'WF' => 'Wallis And Futuna',
+          'EH' => 'Western Sahara',
+          'YE' => 'Yemen',
+          'ZM' => 'Zambia',
+          'ZW' => 'Zimbabwe'
+      }
+    end
+  end
+end

data/lib/geography_helper/form_options_helper.rb

@@ -0,0 +1,20 @@
+module ActionView
+  module Helpers
+    module FormOptionsHelper
+
+      def state_options_for_select
+        geography = GeographyHelper::States.new
+        state_options = geography.states
+        province_options = geography.provinces
+        state_and_province_options = {'United States' => state_options['United States'].invert}.merge({'Canada' => province_options['Canada'].invert})
+
+        grouped_options_for_select(state_and_province_options)
+      end
+
+      def country_options_for_select
+        geography = GeographyHelper::Countries.new
+        geography.countries.invert
+      end
+    end
+  end
+end

data/lib/geography_helper/states.rb

@@ -0,0 +1,86 @@
+module GeographyHelper
+  class States
+
+    def states
+      {
+        'United States' => {
+          'AK' => 'Alaska',
+          'AL' => 'Alabama',
+          'AR' => 'Arkansas',
+          'AS' => 'American Samoa',
+          'AZ' => 'Arizona',
+          'CA' => 'California',
+          'CO' => 'Colorado',
+          'CT' => 'Connecticut',
+          'DC' => 'District of Columbia',
+          'DE' => 'Delaware',
+          'FL' => 'Florida',
+          'GA' => 'Georgia',
+          'GU' => 'Guam',
+          'HI' => 'Hawaii',
+          'IA' => 'Iowa',
+          'ID' => 'Idaho',
+          'IL' => 'Illinois',
+          'IN' => 'Indiana',
+          'KS' => 'Kansas',
+          'KY' => 'Kentucky',
+          'LA' => 'Louisiana',
+          'MA' => 'Massachusetts',
+          'MD' => 'Maryland',
+          'ME' => 'Maine',
+          'MI' => 'Michigan',
+          'MN' => 'Minnesota',
+          'MO' => 'Missouri',
+          'MS' => 'Mississippi',
+          'MT' => 'Montana',
+          'NC' => 'North Carolina',
+          'ND' => 'North Dakota',
+          'NE' => 'Nebraska',
+          'NH' => 'New Hampshire',
+          'NJ' => 'New Jersey',
+          'NM' => 'New Mexico',
+          'NV' => 'Nevada',
+          'NY' => 'New York',
+          'OH' => 'Ohio',
+          'OK' => 'Oklahoma',
+          'OR' => 'Oregon',
+          'PA' => 'Pennsylvania',
+          'PR' => 'Puerto Rico',
+          'RI' => 'Rhode Island',
+          'SC' => 'South Carolina',
+          'SD' => 'South Dakota',
+          'TN' => 'Tennessee',
+          'TX' => 'Texas',
+          'UT' => 'Utah',
+          'VA' => 'Virginia',
+          'VI' => 'Virgin Islands',
+          'VT' => 'Vermont',
+          'WA' => 'Washington',
+          'WI' => 'Wisconsin',
+          'WV' => 'West Virginia',
+          'WY' => 'Wyoming'
+        }
+      }
+    end
+
+    def provinces
+      {
+        'Canada' => {
+          'AB' => 'Alberta',
+          'BC' => 'British Columbia',
+          'MB' => 'Manitoba',
+          'NB' => 'New Brunswick',
+          'NL' => 'Newfoundland and Labrador',
+          'NT' => 'Northwest Territories',
+          'NS' => 'Nova Scotia',
+          'NU' => 'Nunavut',
+          'PE' => 'Prince Edward Island',
+          'SK' => 'Saskatchewan',
+          'ON' => 'Ontario',
+          'QC' => 'Quebec',
+          'YT' => 'Yukon'
+        }
+      }
+    end
+  end
+end

data/lib/geography_helper/version.rb

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

metadata

@@ -0,0 +1,110 @@
+--- !ruby/object:Gem::Specification
+name: geography_helper
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+  prerelease: 
+platform: ruby
+authors:
+- Eric Iacutone
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2017-06-12 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.10'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: 
+email:
+- eric.iacutone@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- .travis.yml
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- geography_helper.gemspec
+- lib/geography_helper.rb
+- lib/geography_helper/countries.rb
+- lib/geography_helper/form_options_helper.rb
+- lib/geography_helper/states.rb
+- lib/geography_helper/version.rb
+homepage: https://github.com/iacutone/geography_helper
+licenses:
+- MIT
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.25
+signing_key: 
+specification_version: 3
+summary: Hash state, province and country codes.
+test_files: []
+has_rdoc: