iso_countries 0.1

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2008 [name of plugin creator]
+
+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

@@ -0,0 +1,30 @@
+= iso_countries - Store countries using ISO 3166 codes
+
+This rails plugin enables you to store country info only with the country's ISO-3166 code
+
+== Example
+
+  class Company < ActiveRecord::Base
+    iso_country :country
+  end
+
+  c = Company.new :country => "es"
+  c.country                 # => "es"
+  c.country_name            # => "Spain"
+  c.country_name = "France"
+  c.country                 # => "fr"
+  ISO::Countries.set_language "es"
+  c.country_name            # => "Francia"
+
+  <% form_for @company do |f| %>
+    <%= f.iso_country_select :country, [:es, :en] %>
+  <% end %>
+
+== Acknowledgements
+
+Translations are provided by the iso-codes package
+http://pkg-isocodes.alioth.debian.org/
+
+== License
+
+Copyright (c) 2008 Jorge Bernal <jbernal@warp.es>, released under the MIT license

data/Rakefile

@@ -0,0 +1,121 @@
+require 'rake'
+require 'rake/testtask'
+require 'rake/rdoctask'
+
+desc 'Default: run unit tests.'
+task :default => :test
+
+desc 'Test the iso_countries plugin.'
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'lib'
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = true
+end
+
+desc 'Generate documentation for the iso_countries plugin.'
+Rake::RDocTask.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'IsoCountries'
+  rdoc.options << '--line-numbers' << '--inline-source'
+  rdoc.rdoc_files.include('README')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+desc 'Download an updated list from the iso website'
+task :update do
+  url = "http://www.iso.org/iso/iso3166_en_code_lists.txt"
+  require 'open-uri'
+  iso = open(url)
+  require "iconv"
+  conv = Iconv.new('utf8', 'latin1')
+  require "unicode"
+
+  File.open('lib/country_list.rb', 'w')  do |f|
+    f.puts "module ISO"
+    f.puts "  module Countries"
+    f.puts "    COUNTRIES = {"
+    
+    # Skip the first two lines, as they don't contain country information
+    iso.readline
+    iso.readline
+    
+    countries = []
+    iso.each_line do |line|
+      country, code = line.split(';')
+      code.chomp!
+      country = Unicode.capitalize(conv.iconv(country))
+      
+      puts "#{code} => #{country}"
+      countries << "      :#{code.downcase} => N_(\"#{country}\")"
+    end
+    f.puts countries.join(",\n")
+    
+    f.puts "  }"
+    f.puts "  end"
+    f.puts "end"
+  end
+  
+end
+
+desc "Update pot/po files to match new version." 
+task :updatepo do
+  require 'gettext'
+  require 'gettext/utils'  
+
+  # GetText::ActiveRecordParser.init(:use_classname => false, :activerecord_classes => ['FakeARClass'])
+  GetText.update_pofiles('iso_countries', 
+                         Dir.glob("lib/**/*.rb"),
+                         "iso_countries plugin")
+end
+
+desc "Create mo-files"
+task :makemo do
+  require 'gettext'
+  require 'gettext/utils'  
+  GetText.create_mofiles(true, "po", "locale")
+end
+
+desc "Downloads translations from iso-codes repository"
+task :download do
+  repo = "svn://svn.debian.org/pkg-isocodes/trunk/iso-codes/iso_3166"
+  
+  FileUtils.rm_rf("tmp")
+  system "svn co #{repo} tmp"
+  Dir.glob("tmp/*.po").each do |pofile|
+    locale = File.basename(pofile, ".po")
+    FileUtils.mkdir_p("po/#{locale}")
+    puts "#{locale} -> po/#{locale}/iso_countries.po"
+    FileUtils.mv(pofile, "po/#{locale}/iso_countries.po")
+  end
+  FileUtils.rm_rf("tmp")
+end
+
+
+spec = Gem::Specification.new do |s|
+  s.name = "iso_countries"
+  s.version = "0.1"
+  s.author = "Jorge Bernal"
+  s.email = "jbernal@warp.es"
+  s.homepage = "http://github.com/koke/iso_countries"
+  s.platform = Gem::Platform::RUBY
+  s.summary = "Country selector with ISO codes"
+  s.files = FileList["README*",
+                                 "MIT-LICENSE",
+                                 "Rakefile",
+                                 "init.rb",
+                                 "{lib,tasks,test}/**/*"].to_a
+  s.require_path = "lib"
+  s.test_files = FileList["test/**/test_*.rb"].to_a
+  s.rubyforge_project = "iso_countries"
+  s.has_rdoc = false
+  s.extra_rdoc_files = FileList["README*"].to_a
+  s.rdoc_options << '--line-numbers' << '--inline-source'
+  s.requirements << "gettext"
+end
+
+desc "Generate a gemspec file for GitHub"
+task :gemspec do
+  File.open("#{spec.name}.gemspec", 'w') do |f|
+    f.write spec.to_ruby
+  end
+end

data/init.rb

@@ -0,0 +1,3 @@
+# Include hook code here
+ActiveSupport::Dependencies.load_once_paths.delete(lib_path)
+require "iso_countries"

data/lib/country_list.rb

@@ -0,0 +1,254 @@
+module ISO
+  module Countries
+    include GetText
+    
+    COUNTRIES = {
+      :af => N_("Afghanistan"),
+      :ax => N_("Åland islands"),
+      :al => N_("Albania"),
+      :dz => N_("Algeria"),
+      :as => N_("American samoa"),
+      :ad => N_("Andorra"),
+      :ao => N_("Angola"),
+      :ai => N_("Anguilla"),
+      :aq => N_("Antarctica"),
+      :ag => N_("Antigua and barbuda"),
+      :ar => N_("Argentina"),
+      :am => N_("Armenia"),
+      :aw => N_("Aruba"),
+      :au => N_("Australia"),
+      :at => N_("Austria"),
+      :az => N_("Azerbaijan"),
+      :bs => N_("Bahamas"),
+      :bh => N_("Bahrain"),
+      :bd => N_("Bangladesh"),
+      :bb => N_("Barbados"),
+      :by => N_("Belarus"),
+      :be => N_("Belgium"),
+      :bz => N_("Belize"),
+      :bj => N_("Benin"),
+      :bm => N_("Bermuda"),
+      :bt => N_("Bhutan"),
+      :bo => N_("Bolivia"),
+      :ba => N_("Bosnia and herzegovina"),
+      :bw => N_("Botswana"),
+      :bv => N_("Bouvet island"),
+      :br => N_("Brazil"),
+      :io => N_("British indian ocean territory"),
+      :bn => N_("Brunei darussalam"),
+      :bg => N_("Bulgaria"),
+      :bf => N_("Burkina faso"),
+      :bi => N_("Burundi"),
+      :kh => N_("Cambodia"),
+      :cm => N_("Cameroon"),
+      :ca => N_("Canada"),
+      :cv => N_("Cape verde"),
+      :ky => N_("Cayman islands"),
+      :cf => N_("Central african republic"),
+      :td => N_("Chad"),
+      :cl => N_("Chile"),
+      :cn => N_("China"),
+      :cx => N_("Christmas island"),
+      :cc => N_("Cocos (keeling) islands"),
+      :co => N_("Colombia"),
+      :km => N_("Comoros"),
+      :cg => N_("Congo"),
+      :cd => N_("Congo, the democratic republic of the"),
+      :ck => N_("Cook islands"),
+      :cr => N_("Costa rica"),
+      :ci => N_("Côte d'ivoire"),
+      :hr => N_("Croatia"),
+      :cu => N_("Cuba"),
+      :cy => N_("Cyprus"),
+      :cz => N_("Czech republic"),
+      :dk => N_("Denmark"),
+      :dj => N_("Djibouti"),
+      :dm => N_("Dominica"),
+      :do => N_("Dominican republic"),
+      :ec => N_("Ecuador"),
+      :eg => N_("Egypt"),
+      :sv => N_("El salvador"),
+      :gq => N_("Equatorial guinea"),
+      :er => N_("Eritrea"),
+      :ee => N_("Estonia"),
+      :et => N_("Ethiopia"),
+      :fk => N_("Falkland islands (malvinas)"),
+      :fo => N_("Faroe islands"),
+      :fj => N_("Fiji"),
+      :fi => N_("Finland"),
+      :fr => N_("France"),
+      :gf => N_("French guiana"),
+      :pf => N_("French polynesia"),
+      :tf => N_("French southern territories"),
+      :ga => N_("Gabon"),
+      :gm => N_("Gambia"),
+      :ge => N_("Georgia"),
+      :de => N_("Germany"),
+      :gh => N_("Ghana"),
+      :gi => N_("Gibraltar"),
+      :gr => N_("Greece"),
+      :gl => N_("Greenland"),
+      :gd => N_("Grenada"),
+      :gp => N_("Guadeloupe"),
+      :gu => N_("Guam"),
+      :gt => N_("Guatemala"),
+      :gg => N_("Guernsey"),
+      :gn => N_("Guinea"),
+      :gw => N_("Guinea-bissau"),
+      :gy => N_("Guyana"),
+      :ht => N_("Haiti"),
+      :hm => N_("Heard island and mcdonald islands"),
+      :va => N_("Holy see (vatican city state)"),
+      :hn => N_("Honduras"),
+      :hk => N_("Hong kong"),
+      :hu => N_("Hungary"),
+      :is => N_("Iceland"),
+      :in => N_("India"),
+      :id => N_("Indonesia"),
+      :ir => N_("Iran, islamic republic of"),
+      :iq => N_("Iraq"),
+      :ie => N_("Ireland"),
+      :im => N_("Isle of man"),
+      :il => N_("Israel"),
+      :it => N_("Italy"),
+      :jm => N_("Jamaica"),
+      :jp => N_("Japan"),
+      :je => N_("Jersey"),
+      :jo => N_("Jordan"),
+      :kz => N_("Kazakhstan"),
+      :ke => N_("Kenya"),
+      :ki => N_("Kiribati"),
+      :kp => N_("Korea, democratic people's republic of"),
+      :kr => N_("Korea, republic of"),
+      :kw => N_("Kuwait"),
+      :kg => N_("Kyrgyzstan"),
+      :la => N_("Lao people's democratic republic"),
+      :lv => N_("Latvia"),
+      :lb => N_("Lebanon"),
+      :ls => N_("Lesotho"),
+      :lr => N_("Liberia"),
+      :ly => N_("Libyan arab jamahiriya"),
+      :li => N_("Liechtenstein"),
+      :lt => N_("Lithuania"),
+      :lu => N_("Luxembourg"),
+      :mo => N_("Macao"),
+      :mk => N_("Macedonia, the former yugoslav republic of"),
+      :mg => N_("Madagascar"),
+      :mw => N_("Malawi"),
+      :my => N_("Malaysia"),
+      :mv => N_("Maldives"),
+      :ml => N_("Mali"),
+      :mt => N_("Malta"),
+      :mh => N_("Marshall islands"),
+      :mq => N_("Martinique"),
+      :mr => N_("Mauritania"),
+      :mu => N_("Mauritius"),
+      :yt => N_("Mayotte"),
+      :mx => N_("Mexico"),
+      :fm => N_("Micronesia, federated states of"),
+      :md => N_("Moldova, republic of"),
+      :mc => N_("Monaco"),
+      :mn => N_("Mongolia"),
+      :me => N_("Montenegro"),
+      :ms => N_("Montserrat"),
+      :ma => N_("Morocco"),
+      :mz => N_("Mozambique"),
+      :mm => N_("Myanmar"),
+      :na => N_("Namibia"),
+      :nr => N_("Nauru"),
+      :np => N_("Nepal"),
+      :nl => N_("Netherlands"),
+      :an => N_("Netherlands antilles"),
+      :nc => N_("New caledonia"),
+      :nz => N_("New zealand"),
+      :ni => N_("Nicaragua"),
+      :ne => N_("Niger"),
+      :ng => N_("Nigeria"),
+      :nu => N_("Niue"),
+      :nf => N_("Norfolk island"),
+      :mp => N_("Northern mariana islands"),
+      :no => N_("Norway"),
+      :om => N_("Oman"),
+      :pk => N_("Pakistan"),
+      :pw => N_("Palau"),
+      :ps => N_("Palestinian territory, occupied"),
+      :pa => N_("Panama"),
+      :pg => N_("Papua new guinea"),
+      :py => N_("Paraguay"),
+      :pe => N_("Peru"),
+      :ph => N_("Philippines"),
+      :pn => N_("Pitcairn"),
+      :pl => N_("Poland"),
+      :pt => N_("Portugal"),
+      :pr => N_("Puerto rico"),
+      :qa => N_("Qatar"),
+      :re => N_("Reunion"),
+      :ro => N_("Romania"),
+      :ru => N_("Russian federation"),
+      :rw => N_("Rwanda"),
+      :bl => N_("Saint barthélemy"),
+      :sh => N_("Saint helena"),
+      :kn => N_("Saint kitts and nevis"),
+      :lc => N_("Saint lucia"),
+      :mf => N_("Saint martin"),
+      :pm => N_("Saint pierre and miquelon"),
+      :vc => N_("Saint vincent and the grenadines"),
+      :ws => N_("Samoa"),
+      :sm => N_("San marino"),
+      :st => N_("Sao tome and principe"),
+      :sa => N_("Saudi arabia"),
+      :sn => N_("Senegal"),
+      :rs => N_("Serbia"),
+      :sc => N_("Seychelles"),
+      :sl => N_("Sierra leone"),
+      :sg => N_("Singapore"),
+      :sk => N_("Slovakia"),
+      :si => N_("Slovenia"),
+      :sb => N_("Solomon islands"),
+      :so => N_("Somalia"),
+      :za => N_("South africa"),
+      :gs => N_("South georgia and the south sandwich islands"),
+      :es => N_("Spain"),
+      :lk => N_("Sri lanka"),
+      :sd => N_("Sudan"),
+      :sr => N_("Suriname"),
+      :sj => N_("Svalbard and jan mayen"),
+      :sz => N_("Swaziland"),
+      :se => N_("Sweden"),
+      :ch => N_("Switzerland"),
+      :sy => N_("Syrian arab republic"),
+      :tw => N_("Taiwan, province of china"),
+      :tj => N_("Tajikistan"),
+      :tz => N_("Tanzania, united republic of"),
+      :th => N_("Thailand"),
+      :tl => N_("Timor-leste"),
+      :tg => N_("Togo"),
+      :tk => N_("Tokelau"),
+      :to => N_("Tonga"),
+      :tt => N_("Trinidad and tobago"),
+      :tn => N_("Tunisia"),
+      :tr => N_("Turkey"),
+      :tm => N_("Turkmenistan"),
+      :tc => N_("Turks and caicos islands"),
+      :tv => N_("Tuvalu"),
+      :ug => N_("Uganda"),
+      :ua => N_("Ukraine"),
+      :ae => N_("United arab emirates"),
+      :gb => N_("United kingdom"),
+      :us => N_("United states"),
+      :um => N_("United states minor outlying islands"),
+      :uy => N_("Uruguay"),
+      :uz => N_("Uzbekistan"),
+      :vu => N_("Vanuatu"),
+      :ve => N_("Venezuela"),
+      :vn => N_("Viet nam"),
+      :vg => N_("Virgin islands, british"),
+      :vi => N_("Virgin islands, u.s."),
+      :wf => N_("Wallis and futuna"),
+      :eh => N_("Western sahara"),
+      :ye => N_("Yemen"),
+      :zm => N_("Zambia"),
+      :zw => N_("Zimbabwe")
+  }
+  end
+end

data/lib/iso/countries/country_field.rb

@@ -0,0 +1,46 @@
+module ISO #:nodoc:
+  module Countries #:nodoc:
+    module CountryField #:nodoc:
+      def self.included(base) #:nodoc:
+        base.extend ClassMethods
+      end
+      
+      module ClassMethods
+        # Declares a field from a model as a iso code for a country
+        #
+        # Example:
+        #
+        #   class Company
+        #     iso_country :country
+        #   end
+        # 
+        #   c = Company.new(:country => "es")
+        #   c.country_name # => "Spain"
+        #   c.country_name = "France"
+        #   c.country # => "fr"
+        def iso_country(*args)
+          args.each do |f|
+            class_eval <<-EOC
+              
+              validates_inclusion_of :#{f}, :in => ISO::Countries.country_codes, :allow_nil => true
+              
+              def #{f}_name
+                ISO::Countries.get_country(#{f})
+              end
+              
+              def #{f}_name=(name)
+                code = ISO::Countries.get_code(name)
+                if code
+                  self.#{f} = code
+                else
+                  raise ArgumentError, "Invalid country name"
+                end
+              end              
+              
+            EOC
+          end
+        end
+      end
+    end
+  end
+end

data/lib/iso/countries/form_helpers.rb

@@ -0,0 +1,57 @@
+module ActionView #:nodoc:
+  module Helpers #:nodoc:
+    module FormOptionsHelper
+      # Return select and option tags for the given object and method, using iso_options_for_select to generate the list of option tags.
+
+      def iso_country_select(object, method, priority_countries = nil, options = {}, html_options = {})
+        InstanceTag.new(object, method, self).to_iso_select_tag(priority_countries, options, html_options)
+      end
+
+
+      # Returns a string of option tags for pretty much any country in the world. Supply a country name as selected to have it marked as the selected option tag. You can also supply an array of countries as priority_countries, so that they will be listed above the rest of the (long) list.
+      # 
+      # NOTE: Only the option tags are returned, you have to wrap this call in a regular HTML select tag.
+      # 
+      def iso_options_for_select(selected = nil, priority_countries = nil)
+        countries_for_select = {}
+        ISO::Countries::COUNTRIES.each_pair {|code,name| countries_for_select[ISO::Countries.get_country(code)] = code.to_s }
+
+        country_options = ""
+
+        if priority_countries
+          priority_hash = {}
+          priority_countries.each {|code| priority_hash[ISO::Countries.get_country(code)] = code.to_s }
+          country_options += options_for_select(priority_hash.sort, selected)
+          country_options += "<option value=\"\">-------------</option>\n"
+        end
+
+        if priority_countries && priority_countries.include?(selected)
+          country_options += options_for_select(countries_for_select.sort - priority_countries, selected)
+        else
+          country_options += options_for_select(countries_for_select.sort, selected)
+        end
+
+        return country_options
+      end
+
+      def to_iso_select_tag(priority_countries, options, html_options) #:nodoc:
+        if html_options.has_key?(:class)
+          html_options[:class] = html_options[:class] + " country"
+        else
+          html_options[:class] = "country"
+        end
+        html_options = html_options.stringify_keys
+        add_default_name_and_id(html_options)
+        value = value(object)
+        content_tag("select", add_options(iso_options_for_select(value, priority_countries), options, value), html_options)
+      end  
+    end
+  end
+end
+
+class ActionView::Helpers::FormBuilder
+  def iso_country_select(method, priority_countries = nil, options = {}, html_options = {})
+    @template.iso_country_select(@object_name, method, priority_countries, options.merge(:object => @object), html_options)
+  end
+end
+

data/lib/iso_countries.rb

@@ -0,0 +1,67 @@
+# IsoCountries
+
+require "rubygems"
+begin
+  require "gettext"
+rescue
+  require "ostruct"
+  GetText = OpenStruct.new
+  def _(str)
+    str
+  end
+end
+stubs = %w(activesupport activerecord actionpack actionmailer activeresource)
+stubs.each do |stub|
+  require stub
+end
+
+require "country_list"
+require "iso/countries/form_helpers"
+require "iso/countries/country_field"
+ActiveRecord::Base.send :include, ISO::Countries::CountryField
+
+module ISO
+  module Countries    
+    module ClassMethods      
+      GetText.bindtextdomain "iso_countries", :path => "#{File.dirname(__FILE__)}/../locale"
+      GetText.locale = 'en'
+      
+      # Sets the language for country translation
+      def set_language(lang)
+        @@language = lang
+        GetText.bindtextdomain "iso_countries", :path => "#{File.dirname(__FILE__)}/../locale"
+        GetText.locale = lang
+      end
+      
+      # Gets te current translation language
+      def language
+        @@language || "en"
+      end
+      
+      # Wrapper to get country name from country code. +code+ can be a symbol or a string containing the country code.
+      def get_country(code)
+        _(COUNTRIES[code.to_sym]) rescue nil
+      end
+      
+      # Wrapper to get country code from country name.
+      def get_code(name)
+        if COUNTRIES.value?(name)
+          COUNTRIES.each_pair do |k,v|
+            if v.eql?(name)
+              return k.to_s
+            end
+          end
+        end
+      end
+          
+      # Returns an array with all the available country codes
+      def country_codes
+        COUNTRIES.keys.map { |key| key.to_s }
+      end
+    end  
+    
+    class << self
+      include ClassMethods
+    end
+  end
+end

data/tasks/iso_countries_tasks.rake

@@ -0,0 +1,4 @@
+# desc "Explaining what the task does"
+# task :iso_countries do
+#   # Task goes here
+# end

data/test/iso_countries_test.rb

@@ -0,0 +1,10 @@
+require 'test/unit'
+require "iso_countries"
+
+class IsoCountriesTest < Test::Unit::TestCase
+  def test_this_plugin
+    assert_equal("Spain", ISO::Countries.get_country("es"))
+    assert_equal("es", ISO::Countries.set_language("es"))
+    assert_equal("España", ISO::Countries.get_country("es"))
+  end
+end

metadata

@@ -0,0 +1,76 @@
+--- !ruby/object:Gem::Specification 
+name: iso_countries
+version: !ruby/object:Gem::Version 
+  hash: 9
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  version: "0.1"
+platform: ruby
+authors: 
+- Jorge Bernal
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-01-19 00:00:00 -08:00
+default_executable: 
+dependencies: []
+
+description: 
+email: jbernal@warp.es
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README
+files: 
+- README
+- MIT-LICENSE
+- Rakefile
+- init.rb
+- lib/country_list.rb
+- lib/iso/countries/country_field.rb
+- lib/iso/countries/form_helpers.rb
+- lib/iso_countries.rb
+- tasks/iso_countries_tasks.rake
+- test/iso_countries_test.rb
+has_rdoc: true
+homepage: http://github.com/koke/iso_countries
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --line-numbers
+- --inline-source
+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: 
+- gettext
+rubyforge_project: iso_countries
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 2
+summary: Country selector with ISO codes
+test_files: []
+