rails_country_select 0.0.1 → 0.2.0

checksums.yaml

@@ -1,15 +1,15 @@
 ---
 !binary "U0hBMQ==":
   metadata.gz: !binary |-
-    MjExMDQ1MTZhYTRiODJhNjljZWRjNTVjYzA1MDE2ODlkNTRjNjFmOQ==
+    OWM3MGFiZmM4Yjk3NGZkNTZmZTE4ZDdkYzljMDM1NTlkNmQzYzkwMA==
   data.tar.gz: !binary |-
-    NDljOGRjMjM3M2MwODRkZmM4NWM0MzY3MGY0NWYwOGFiMzFhYjdlNQ==
+    NzVmMGIzYzc1NWY2MmY4MDdhN2ExYmQwNTEwMTYzODExYzc2YjI4Mg==
 !binary "U0hBNTEy":
   metadata.gz: !binary |-
-    OTNjY2FhODVmYjIzNjMzMzdlN2JhZGM3MGFmOWUwZGE0NTU2MWJiYTI2MjM5
-    YjlhOGI4NGY0OTFlMjZjZGMyYzA1YjkwYzVjMzdmZGZmYTdhMGNiNWEwZDM5
-    YWYwOTcwOTM5NDViNmM4NTY5NGI5ZmI3ZTIxNTk2N2ZjODdjN2Y=
+    ZGEyNThiNDg2YjUwNDBmMWEzZGY2NjVlODkyYjVlZmQxODMyYzUyMDg1ZWYw
+    ZmUyM2JmMjkwNTFiMzMzOGQyMjdmOTE2YmY0ZGJjZDdlMDg3NGM3ZTA2ZmMx
+    MThhZTIxMzY4NmFmNjI1YmU4YzNjZGQ0YWIyYjIyMjMzM2RkOTQ=
   data.tar.gz: !binary |-
-    YzEyZTExMGEyNmUwNjAwYWQ5NWY0M2EyMTBjZjc2MmM0N2Y1OGQ2ZjRmNzVj
-    ZGQ0MWJlMmFkNWQyYzI0MDk1Njk0YjYxMjM3Y2JiOTIwZWRkNzk3NmQ1NTRi
-    OTYzYWRiOTBmMzE0ODY5ZmJhMmM4ZDhlMTkzM2I3YzkyZTg0YmE=
+    Mjg5Y2MxZTYxYWExNjA0MTdlYzZiMWU3MzA4ZGIwNGFhZjI5YTk1ODI2ODI3
+    YzM2Y2IyZTQ3MWYyMzJkNTgwNjMwN2IxM2Y1NGU2Y2EyYzg5NmI0ZDgxYTE2
+    YjM3ZTE1NjU1NjM0Mjg0N2UxZjE1OWNjNWY5NjczMzAyODhlZjk=

data/CHANGELOG

@@ -0,0 +1,8 @@
+V.0.1.0
+========
+* Helper method in order to get country info.
+
+V0.0.1
+========
+* First Version, form tag country_select.
+

data/README.md

@@ -1,11 +1,15 @@
 # RailsCountrySelect
 This project is based on Rails 2 plugin created by LukeCarrier [rails-country-select](https://github.com/rderoldan1/rails-country-select/blob/master/lib/country_definitions.rb)
+
 Select tag in order to choose a country in your forms, provides 4 options.
+
 1. Country Name.
 2. Cod
 3. ISO cod 2 chars ('CO', 'AF', 'AX', 'AL')
 4. ISO cod 3 chars ('COL', 'AFG', 'ALA', ALB')
 
+Also includes a Helper method in order to get all country info.
+
 ## Installation
 
 Add this line to your application's Gemfile:
@@ -25,7 +29,7 @@ Or install it yourself as:
 ### Basic
 value : country cod number
 text  : country name
-```ruby
+```rails
 <%= form_for @user do |f| %>
     <%= f.country_select :country %>
 <% end %>
@@ -38,26 +42,71 @@ HTML generated
     <option value="248">Albania</option>
     <option value="8">Åland Islands</option>
     <option value="12">Algeria</option>
-``
+```
 
 ### Advanced
-values, keys : [:names, :nums, :alpha2s, :alpha3s]
-selected      : set default value
-prompt       : message
-```ruby
+* values, keys : [:names, :nums, :alpha2s, :alpha3s]
+* selected      : set default value
+* prompt       : message
+
+```rails
 <%= form_for @user do |f| %>
     <%= f.country_select :country, {:keys => :names, :values => :alpha2s, :selected => "CO"}, :prompt => "Choose a country"
 <% end %>
 ```
 
 HTML generated
+
 ```html
 <select id="cliente_nacionalidad" name="user[country]" prompt="Choose a country" value="CO">
     <option value="AF">Afghanistan</option>
     <option value="AL">Albania</option>
     <option value="AX">Åland Islands</option>
     <option value="DZ">Algeria</option>
-``
+```
+
+
+### Show country info
+A helper method is available to get all the country info in the views, it return an array, the usage is.
+
+Find by name
+```ruby
+country(:name => "Colombia")
+[170, "Colombia", "CO", "COL"]
+```
+
+Find by Cod
+```ruby
+country(:num => 12)
+[12, "Algeria", "DZ", "DZA"]
+```
+
+Find by Alpha2s
+```ruby
+country(:alpha2s => "AR")
+[32, "Argentina", "AR", "ARG"]
+```
+
+Find by Alpha3s
+```ruby
+country(:alpha3s => "USA")
+[840, "United States", "US", "USA"]
+```
+
+Also you can mix all the options hash, example
+```ruby
+country(:alpha3s => "USA", :alpha2s => "US", :num => 840, :name => "United States")
+[840, "United States", "US", "USA"]
+```
+
+
+```html
+<p>Country Cod: <%= country(:num => @user.country_num)[0] %><p>
+<p>Country Name: <%= country(:num => @user.country_num)[1] %><p>
+<p>Country Apha2s: <%= country(:num => @user.country_num)[2] %><p>
+<p>Country Apha3s: <%= country(:num => @user.country_num)[3] %><p>
+```
+
 ## Contributing
 
 1. Fork it

data/lib/rails_country_select.rb

@@ -1,10 +1,11 @@
 # encoding: utf-8
 require "rails_country_select/version"
-
 require File.expand_path('../country_definitions', __FILE__)
+
 if defined?(Rails) && defined?(ActionView)
   module ActionView
     module Helpers
+      autoload :CountryHelper, 'rails_country_select/helpers/rails_country_select'
       module FormOptionsHelper
         def country_select(object, method, options = {}, html_options = {})
           options[:keys]    = :names unless options.has_key?(:keys)
@@ -27,6 +28,17 @@ if defined?(Rails) && defined?(ActionView)
           @template.country_select(@object_name, method, options.merge({:object => @object}), html_options)
         end
       end
+
+      # get country info given some params
+      def country(options = {:name => "", :num =>"", :alpha2s => "", :alpha3s => ""})
+        result = []
+        COUNTRY_NUMS.zip(COUNTRY_NAMES, COUNTRY_ALPHA2S, COUNTRY_ALPHA3S).each do |country|
+          if options[:nums].to_i.eql?(country[0]) || options[:name].eql?(country[1]) || options[:alpha2s].eql?(country[2]) || options[:alpha3s].eql?(country[3])
+            result = country
+          end
+        end
+        result
+      end
     end
   end
 end

data/lib/rails_country_select/version.rb

@@ -1,3 +1,3 @@
 module RailsCountrySelect
-  VERSION = "0.0.1"
+  VERSION = "0.2.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rails_country_select
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.2.0
 platform: ruby
 authors:
 - Ruben Espinosa
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-08-01 00:00:00.000000000 Z
+date: 2013-08-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -47,6 +47,7 @@ extensions: []
 extra_rdoc_files: []
 files:
 - .gitignore
+- CHANGELOG
 - Gemfile
 - LICENSE.txt
 - README.md