model_un 0.1

data/.gitignore

@@ -0,0 +1,4 @@
+pkg/*
+*.gem
+.bundle
+.DS_Store

data/Gemfile

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

data/Gemfile.lock

@@ -0,0 +1,24 @@
+PATH
+  remote: .
+  specs:
+    model_un (0.0.1)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    diff-lcs (1.1.2)
+    rspec (2.4.0)
+      rspec-core (~> 2.4.0)
+      rspec-expectations (~> 2.4.0)
+      rspec-mocks (~> 2.4.0)
+    rspec-core (2.4.0)
+    rspec-expectations (2.4.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.4.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  model_un!
+  rspec

data/README.md

@@ -0,0 +1,48 @@
+ModelUN - Quick and easy country and US State abbreviations
+===========================================================
+
+ModelUN is a tiny little Ruby library for abbreviating and, er, de-abbreviating Countries and US State names. 
+
+Brought to you by [Uh Huh Yeah](http://uhhuhyeah.com/) and [Climber](http://www.climber.com/)
+
+Installation
+-------------
+
+    gem install model_un
+
+
+ModelUN API
+===========
+
+Convert a US State to it's abbreviated name
+-------------------------------------------
+
+		my_state = 'California'
+		my_state_abbr = ModelUN.convert_state_name(my_state) # returns 'CA'
+	
+Convert a US State abbreviation to it's full name
+-------------------------------------------------
+
+		my_state_abbr = 'CA'
+		my_state_name = ModelUN.convert_state_abbr(my_state_abbr) # returns 'California'
+	
+Or, a shortcut for either method
+--------------------------------
+
+		my_state = 'California'
+		my_state_abbr = ModelUN.convert(my_state) # returns 'CA'	
+
+		my_state_abbr = 'CA'
+		my_state_name = ModelUN.convert(my_state_abbr) # returns 'California'	
+
+
+Current version: v0.1 (February 2011)
+=====================================
+
+*	Supports conversion of US State names (including Guam, Marshal and Virgin Islands)
+* [Country conversions to be added in next release] 
+
+Known issues
+------------
+
+*	No known issues. Please report bugs to [david@uhhuhyeah.com](mailto:david@uhhuhyeah.com?subject=ModelUN), or fee free for send me a patch.

data/Rakefile

@@ -0,0 +1,2 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks

data/lib/model_un/data.rb

@@ -0,0 +1,189 @@
+module ModelUN
+  US_STATE_ABBR = [
+    'AL',
+    'AK',
+    'AS',
+    'AZ',
+    'AR',
+    'CA',
+    'CO',
+    'CT',
+    'DE',
+    'DC',
+    'FM',
+    'FL',
+    'GA',
+    'GU',
+    'HI',
+    'ID',
+    'IL',
+    'IN',
+    'IA',
+    'KS',
+    'KY',
+    'LA',
+    'ME',
+    'MH',
+    'MD',
+    'MA',
+    'MI',
+    'MN',
+    'MS',
+    'MO',
+    'MT',
+    'NE',
+    'NV',
+    'NH',
+    'NJ',
+    'NM',
+    'NY',
+    'NC',
+    'ND',
+    'MP',
+    'OH',
+    'OK',
+    'OR',
+    'PW',
+    'PA',
+    'PR',
+    'RI',
+    'SC',
+    'SD',
+    'TN',
+    'TX',
+    'UT',
+    'VT',
+    'VI',
+    'VA',
+    'WA',
+    'WV',
+    'WI',
+    'WY'
+  ]
+  
+  
+  US_STATE_NAMES = [
+     'ALABAMA',                         
+     'ALASKA',                          
+     'AMERICAN SAMOA',                  
+     'ARIZONA',                         
+     'ARKANSAS',                        
+     'CALIFORNIA',                      
+     'COLORADO',                        
+     'CONNECTICUT',                     
+     'DELAWARE',                        
+     'DISTRICT OF COLUMBIA',            
+     'FEDERATED STATES OF MICRONESIA',  
+     'FLORIDA',                         
+     'GEORGIA',                         
+     'GUAM',                            
+     'HAWAII',                          
+     'IDAHO',                           
+     'ILLINOIS',                        
+     'INDIANA',                         
+     'IOWA',                            
+     'KANSAS',                          
+     'KENTUCKY',                        
+     'LOUISIANA',                       
+     'MAINE',                           
+     'MARSHALL ISLANDS',                
+     'MARYLAND',                        
+     'MASSACHUSETTS',                   
+     'MICHIGAN',                        
+     'MINNESOTA',                       
+     'MISSISSIPPI',                     
+     'MISSOURI',                        
+     'MONTANA',                         
+     'NEBRASKA',                        
+     'NEVADA',                          
+     'NEW HAMPSHIRE',                   
+     'NEW JERSEY',                      
+     'NEW MEXICO',                      
+     'NEW YORK',                        
+     'NORTH CAROLINA',                  
+     'NORTH DAKOTA',                    
+     'NORTHERN MARIANA ISLANDS',        
+     'OHIO',                            
+     'OKLAHOMA',                        
+     'OREGON',                          
+     'PALAU',                           
+     'PENNSYLVANIA',                    
+     'PUERTO RICO',                     
+     'RHODE ISLAND',                    
+     'SOUTH CAROLINA',                  
+     'SOUTH DAKOTA',                    
+     'TENNESSEE',                       
+     'TEXAS',                           
+     'UTAH',                            
+     'VERMONT',                         
+     'VIRGIN ISLANDS',                  
+     'VIRGINIA',                        
+     'WASHINGTON',                      
+     'WEST VIRGINIA',                   
+     'WISCONSIN',                       
+     'WYOMING',                         
+   ]
+  
+  US_STATES = [
+    {'full' => 'ALABAMA',                         'abbr' => 'AL'},
+    {'full' => 'ALASKA',                          'abbr' => 'AK'},
+    {'full' => 'AMERICAN SAMOA',                  'abbr' => 'AS'},
+    {'full' => 'ARIZONA',                         'abbr' => 'AZ'},
+    {'full' => 'ARKANSAS',                        'abbr' => 'AR'},
+    {'full' => 'CALIFORNIA',                      'abbr' => 'CA'},
+    {'full' => 'COLORADO',                        'abbr' => 'CO'},
+    {'full' => 'CONNECTICUT',                     'abbr' => 'CT'},
+    {'full' => 'DELAWARE',                        'abbr' => 'DE'},
+    {'full' => 'DISTRICT OF COLUMBIA',            'abbr' => 'DC'},
+    {'full' => 'FEDERATED STATES OF MICRONESIA',  'abbr' => 'FM'},
+    {'full' => 'FLORIDA',                         'abbr' => 'FL'},
+    {'full' => 'GEORGIA',                         'abbr' => 'GA'},
+    {'full' => 'GUAM',                            'abbr' => 'GU'},
+    {'full' => 'HAWAII',                          'abbr' => 'HI'},
+    {'full' => 'IDAHO',                           'abbr' => 'ID'},
+    {'full' => 'ILLINOIS',                        'abbr' => 'IL'},
+    {'full' => 'INDIANA',                         'abbr' => 'IN'},
+    {'full' => 'IOWA',                            'abbr' => 'IA'},
+    {'full' => 'KANSAS',                          'abbr' => 'KS'},
+    {'full' => 'KENTUCKY',                        'abbr' => 'KY'},
+    {'full' => 'LOUISIANA',                       'abbr' => 'LA'},
+    {'full' => 'MAINE',                           'abbr' => 'ME'},
+    {'full' => 'MARSHALL ISLANDS',                'abbr' => 'MH'},
+    {'full' => 'MARYLAND',                        'abbr' => 'MD'},
+    {'full' => 'MASSACHUSETTS',                   'abbr' => 'MA'},
+    {'full' => 'MICHIGAN',                        'abbr' => 'MI'},
+    {'full' => 'MINNESOTA',                       'abbr' => 'MN'},
+    {'full' => 'MISSISSIPPI',                     'abbr' => 'MS'},
+    {'full' => 'MISSOURI',                        'abbr' => 'MO'},
+    {'full' => 'MONTANA',                         'abbr' => 'MT'},
+    {'full' => 'NEBRASKA',                        'abbr' => 'NE'},
+    {'full' => 'NEVADA',                          'abbr' => 'NV'},
+    {'full' => 'NEW HAMPSHIRE',                   'abbr' => 'NH'},
+    {'full' => 'NEW JERSEY',                      'abbr' => 'NJ'},
+    {'full' => 'NEW MEXICO',                      'abbr' => 'NM'},
+    {'full' => 'NEW YORK',                        'abbr' => 'NY'},
+    {'full' => 'NORTH CAROLINA',                  'abbr' => 'NC'},
+    {'full' => 'NORTH DAKOTA',                    'abbr' => 'ND'},
+    {'full' => 'NORTHERN MARIANA ISLANDS',        'abbr' => 'MP'},
+    {'full' => 'OHIO',                            'abbr' => 'OH'},
+    {'full' => 'OKLAHOMA',                        'abbr' => 'OK'},
+    {'full' => 'OREGON',                          'abbr' => 'OR'},
+    {'full' => 'PALAU',                           'abbr' => 'PW'},
+    {'full' => 'PENNSYLVANIA',                    'abbr' => 'PA'},
+    {'full' => 'PUERTO RICO',                     'abbr' => 'PR'},
+    {'full' => 'RHODE ISLAND',                    'abbr' => 'RI'},
+    {'full' => 'SOUTH CAROLINA',                  'abbr' => 'SC'},
+    {'full' => 'SOUTH DAKOTA',                    'abbr' => 'SD'},
+    {'full' => 'TENNESSEE',                       'abbr' => 'TN'},
+    {'full' => 'TEXAS',                           'abbr' => 'TX'},
+    {'full' => 'UTAH',                            'abbr' => 'UT'},
+    {'full' => 'VERMONT',                         'abbr' => 'VT'},
+    {'full' => 'VIRGIN ISLANDS',                  'abbr' => 'VI'},
+    {'full' => 'VIRGINIA',                        'abbr' => 'VA'},
+    {'full' => 'WASHINGTON',                      'abbr' => 'WA'},
+    {'full' => 'WEST VIRGINIA',                   'abbr' => 'WV'},
+    {'full' => 'WISCONSIN',                       'abbr' => 'WI'},
+    {'full' => 'WYOMING',                         'abbr' => 'WY'}
+  ]
+  
+end

data/lib/model_un/version.rb

@@ -0,0 +1,3 @@
+module ModelUN
+  VERSION = "0.1"
+end

data/lib/model_un.rb

@@ -0,0 +1,40 @@
+module ModelUN
+  require "model_un/data"
+  require 'yaml'
+  
+  class << self
+    
+    def convert(string)
+      if string.length == 2
+        self.convert_state_abbr(string.upcase)
+      else
+        self.convert_state_name(string.upcase)
+      end
+    end
+    
+    def convert_state_abbr(state_abbr)
+      self.convert_state_abbreviation(state_abbr)
+    end
+    
+    def convert_state_abbreviation(state_abbr)
+      begin
+        return US_STATE_NAMES[US_STATE_ABBR.index(state_abbr)].downcase.gsub(/\b\w/){$&.upcase}
+      rescue Exception
+        return state_abbr
+      end
+    end
+    
+    def convert_state_name(state_name)
+      begin
+        return US_STATE_ABBR[US_STATE_NAMES.index(state_name)]
+      rescue Exception
+        return state_name.downcase.gsub(/\b\w/){$&.upcase}
+      end
+    end
+    
+    def export_states_list
+      {'US States' => US_STATES}.to_yaml.gsub(/\n/,'').gsub(/-/, '').strip
+    end
+    
+  end
+end

data/model_un.gemspec

@@ -0,0 +1,22 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "model_un/version"
+
+Gem::Specification.new do |s|
+  s.name        = "model_un"
+  s.version     = ModelUN::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Uh Huh Yeah"]
+  s.email       = ["david@uhhuhyeah.com"]
+  s.homepage    = "https://github.com/uhhuhyeah/model_un"
+  s.summary     = %q{Quick and easy country and US State abbreviations}
+  s.description = %q{Converts US State names and (most) country names to their normally accepted abbreviations and back.}
+
+  s.add_development_dependency "rspec"
+  s.rubyforge_project = "model_un"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+end

data/spec/model_un_spec.rb

@@ -0,0 +1,30 @@
+require 'model_un'
+
+describe ModelUN do
+  
+  it "should be able to read the data hash" do
+    ModelUN::US_STATE_NAMES.should_not == nil
+    ModelUN::US_STATE_ABBR.should_not == nil
+  end
+  
+  it "should return an abbreviation for a full state" do
+    state = 'California'
+    ModelUN.convert(state).should == 'CA'
+  end
+  
+  it "should return a full state for an abbreviation" do
+    abbr = 'CA'
+    ModelUN.convert(abbr).should == 'California'
+  end
+  
+  it "should return the input if no match on abbreviation" do
+    abbr = 'XX'
+    ModelUN.convert(abbr).should == 'XX'
+  end
+  
+  it "should return the input if no match on full name" do
+    state = 'Foobar'
+    ModelUN.convert(state).should == state
+  end
+
+end

metadata

@@ -0,0 +1,89 @@
+--- !ruby/object:Gem::Specification 
+name: model_un
+version: !ruby/object:Gem::Version 
+  hash: 9
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  version: "0.1"
+platform: ruby
+authors: 
+- Uh Huh Yeah
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-02-05 00:00:00 -08:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id001
+description: Converts US State names and (most) country names to their normally accepted abbreviations and back.
+email: 
+- david@uhhuhyeah.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- Gemfile.lock
+- README.md
+- Rakefile
+- lib/model_un.rb
+- lib/model_un/data.rb
+- lib/model_un/version.rb
+- model_un.gemspec
+- spec/model_un_spec.rb
+has_rdoc: true
+homepage: https://github.com/uhhuhyeah/model_un
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: model_un
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Quick and easy country and US State abbreviations
+test_files: 
+- spec/model_un_spec.rb