list_select 0.0.1

data/.gitignore

@@ -0,0 +1 @@
+pkg/

data/Gemfile

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

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2010-2011 Dmitry Naumov
+
+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.rdoc

@@ -0,0 +1,106 @@
+== ListSelect
+
+Localiazed select lists helper.
+
+Provides a simple helper to get an HTML select list of any lists defined in your locales files.
+Has builtin lists for selecting countries, languages and more.
+Adds country_select helper to integrate with SimpleForm and Formtastic.
+
+
+== Requirements
+
+Tested with Rails 3. Might work with other versions, too.
+
+
+== Installation
+
+Install a gem:
+
+  gem install list_select
+
+Or add it to your Gemfile:
+
+  gem 'list_select'
+
+Also you can install as a plugin:
+
+  rails plugin install git@github.com:bitzesty/list_select.git
+
+
+== Example
+
+Define any list in your locale file RAILS_ROOT/config/locales/en.rb:
+
+  { :en => { :animals => {
+    :dog => 'A Dog',
+    :cat => 'A Cat',
+    :cow => 'A Cow',
+    :pig => 'A Pig'
+  }}}
+
+Make a select list in your view(examples of different usage):
+
+  <%= f.list_select(:pet, :animals) %>
+
+  <%= list_select("user", "pet", :animals) %>
+
+  <%= list_select_tag("user_pet", :animals) %>
+
+
+== Options
+
+The only List Select specific option is a :priority_items option.
+All other options are the same as for other Rails form helpers.
+
+  <%= f.list_select(:pet, :animals, :priority_items => [ :dog, :cat ]) %>
+  <%= f.list_select(:pet, :animals, :default => :dog) %>
+  <%= f.list_select(:pet, :animals, :include_blank => 'Select your pet...') %>
+
+
+== Built in lists
+
+There are built in lists. They are:
+
+* countries_cldr.en
+* countries_iso3166_1_alpha_2.en      # Recommended for Chargify API
+* languages_cldr.en
+* google_adwords_countries.en
+* google_search_languages.en
+* google_adwords_languages.en
+* google_interface_languages.en
+
+You need to install list you need before you can use it.
+
+You can do this wth list_select generator.
+
+Example:
+  rails generate list_select --help               # See avalable lists
+  rails generate list_select countries_cldr.en    # Install one you need
+
+Notice:
+You might need to restart your server for installed list to be available.
+
+
+== Integration with 3rd party gems
+
+ListSelect works with SimpleForm and Formtastic.
+It adds country_select helper campatible with them.
+You can also customize the countries list you use.
+Default country list is :countries_cldr.
+
+See examples:
+
+  <%= f.input :country %>                              # will use countries_cldr list (you should install it first)
+  <%= f.input :country, :list => :my_country_list %>   # use :my_country_list defined in your locale files
+  <%= f.input :country, :priority => [:US,:BY] %>      # set priority options
+  <%= f.input :country, :prompt => 'Select one...' %>  # set the prompt
+  <%= f.input :country, :include_blank => true %>      # include blank option
+
+
+== TODO
+
+* Add tests
+* Add rake tasks to refetch lists
+* Add more lists and locales
+
+Copyright (c) 2010-2011 Dmitry Naumov, released under the MIT license

data/Rakefile

@@ -0,0 +1,3 @@
+require 'bundler'
+include Rake::DSL
+Bundler::GemHelper.install_tasks

data/init.rb

@@ -0,0 +1 @@
+require 'list_select'

data/lib/generators/USAGE

@@ -0,0 +1,15 @@
+Description:
+    Install one of ListSelect built in lists. Available lists:
+      countries_cldr.en
+      countries_iso3166_1_alpha_2.en
+      languages_cldr.en
+      google_adwords_countries.en
+      google_search_languages.en
+      google_adwords_languages.en
+      google_interface_languages.en
+
+Example:
+    rails generate list_select LIST_NAME
+
+    This will create:
+        locales/list_name.rb

data/lib/generators/list_select_generator.rb

@@ -0,0 +1,7 @@
+class ListSelectGenerator < Rails::Generators::NamedBase
+  source_root File.expand_path('../templates', __FILE__)
+
+  def copy_list_file
+    copy_file "#{file_name}.rb", "config/locales/#{file_name}.rb"
+  end
+end

data/lib/generators/templates/countries_cldr.en.rb

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