actionpack 0.9.0

data/lib/action_view/helpers/date_helper.rb

@@ -0,0 +1,223 @@
+require "date"
+
+module ActionView
+  module Helpers
+    # The Date Helper primarily creates select/option tags for different kinds of dates and date elements. All of the select-type methods
+    # share a number of common options that are as follows:
+    #
+    # * <tt>:prefix</tt> - overwrites the default prefix of "date" used for the select names. So specifying "birthday" would give 
+    #   birthday[month] instead of date[month] if passed to the select_month method.
+    # * <tt>:include_blank</tt> - set to true if it should be possible to set an empty date.
+    # * <tt>:discard_type</tt> - set to true if you want to discard the type part of the select name. If set to true, the select_month
+    #   method would use simply "date" (which can be overwritten using <tt>:prefix</tt>) instead of "date[month]".
+    module DateHelper
+      DEFAULT_PREFIX = "date" unless const_defined?("DEFAULT_PREFIX")
+
+      # Reports the approximate distance in time between to Time objects. For example, if the distance is 47 minutes, it'll return 
+      # "about 1 hour". See the source for the complete wording list.
+      def distance_of_time_in_words(from_time, to_time)
+        distance_in_minutes = ((to_time - from_time) / 60).round
+        
+        case distance_in_minutes
+          when 0..45      then "#{distance_in_minutes} minutes"
+          when 46..90     then "about 1 hour"
+          when 90..1440   then "about #{(distance_in_minutes.to_f / 60.0).round} hours"
+          when 1441..2880 then "1 day"
+          else                 "#{(distance_in_minutes / 1440).round} days"
+        end
+      end
+
+      # Returns a set of select tags (one for year, month, and day) pre-selected for accessing a specified date-based attribute (identified by
+      # +method+) on an object assigned to the template (identified by +object+). It's possible to tailor the selects through the +options+ hash, 
+      # which both accepts all the keys that each of the individual select builders does (like :use_month_numbers for select_month) and a range
+      # of discard options. The discard options are <tt>:discard_month</tt> and <tt>:discard_day</tt>. Set to true, they'll drop the respective
+      # select. Discarding the month select will also automatically discard the day select. 
+      #
+      # NOTE: Discarded selects will default to 1. So if no month select is available, January will be assumed. Additionally, you can get the 
+      # month select before the year by setting :month_before_year to true in the options. This is especially useful for credit card forms. 
+      # Examples:
+      #
+      #   date_select("post", "written_on")
+      #   date_select("post", "written_on", :start_year => 1995)
+      #   date_select("post", "written_on", :start_year => 1995, :use_month_numbers => true, 
+      #                                     :discard_day => true, :include_blank => true)
+      #
+      # The selects are prepared for multi-parameter assignment to an Active Record object.
+      def date_select(object, method, options = {})
+        InstanceTag.new(object, method, self).to_date_select_tag(options)
+      end
+
+      # Returns a set of select tags (one for year, month, day, hour, and minute) pre-selected for accessing a specified datetime-based
+      # attribute (identified by +method+) on an object assigned to the template (identified by +object+). Examples:
+      #
+      #   datetime_select("post", "written_on")
+      #   datetime_select("post", "written_on", :start_year => 1995)
+      #
+      # The selects are prepared for multi-parameter assignment to an Active Record object.
+      def datetime_select(object, method, options = {})
+        InstanceTag.new(object, method, self).to_datetime_select_tag(options)
+      end
+
+      # Returns a set of html select-tags (one for year, month, and day) pre-selected with the +date+.
+      def select_date(date = Date.today, options = {})
+        select_year(date, options) + select_month(date, options) + select_day(date, options)
+      end
+
+      # Returns a set of html select-tags (one for year, month, day, hour, and minute) preselected the +datetime+.
+      def select_datetime(datetime = Time.now, options = {})
+        select_year(datetime, options) + select_month(datetime, options) + select_day(datetime, options) +
+        select_hour(datetime, options) + select_minute(datetime, options)
+      end
+
+      # Returns a select tag with options for each of the minutes 0 through 59 with the current minute selected.
+      # The <tt>minute</tt> can also be substituted for a minute number.
+      def select_minute(datetime, options = {})
+        minute_options = []
+
+        0.upto(59) do |minute|
+          minute_options << ((datetime.kind_of?(Fixnum) ? datetime : datetime.min) == minute ?
+            "<option selected=\"selected\">#{leading_zero_on_single_digits(minute)}</option>\n" : 
+            "<option>#{leading_zero_on_single_digits(minute)}</option>\n"
+          )
+        end
+
+        select_html("minute", minute_options, options[:prefix], options[:include_blank], options[:discard_type])
+      end
+
+      # Returns a select tag with options for each of the hours 0 through 23 with the current hour selected.
+      # The <tt>hour</tt> can also be substituted for a hour number.
+      def select_hour(datetime, options = {})
+        hour_options = []
+
+        0.upto(23) do |hour|
+          hour_options << ((datetime.kind_of?(Fixnum) ? datetime : datetime.hour) == hour ?
+            "<option selected=\"selected\">#{leading_zero_on_single_digits(hour)}</option>\n" : 
+            "<option>#{leading_zero_on_single_digits(hour)}</option>\n"
+          )
+        end
+
+        select_html("hour", hour_options, options[:prefix], options[:include_blank], options[:discard_type])
+      end
+
+      # Returns a select tag with options for each of the days 1 through 31 with the current day selected.
+      # The <tt>date</tt> can also be substituted for a hour number.
+      def select_day(date, options = {})
+        day_options = []
+
+        1.upto(31) do |day|
+          day_options << ((date.kind_of?(Fixnum) ? date : date.day) == day ?
+            "<option selected=\"selected\">#{day}</option>\n" : 
+            "<option>#{day}</option>\n"
+          )
+        end
+
+        select_html("day", day_options, options[:prefix], options[:include_blank], options[:discard_type])
+      end
+      
+      # Returns a select tag with options for each of the months January through December with the current month selected.
+      # The month names are presented as keys (what's shown to the user) and the month numbers (1-12) are used as values
+      # (what's submitted to the server). It's also possible to use month numbers for the presentation instead of names --
+      # set the <tt>:use_month_numbers</tt> key in +options+ to true for this to happen. If you want both numbers and names, 
+      # set the <tt>:add_month_numbers</tt> key in +options+ to true. Examples:
+      #
+      #   select_month(Date.today)                             # Will use keys like "January", "March"
+      #   select_month(Date.today, :use_month_numbers => true) # Will use keys like "1", "3"
+      #   select_month(Date.today, :add_month_numbers => true) # Will use keys like "1 - January", "3 - March"
+      def select_month(date, options = {})
+        month_options = []
+
+        1.upto(12) do |month_number|
+          month_name = if options[:use_month_numbers] 
+            month_number
+          elsif options[:add_month_numbers]
+            month_number.to_s + " - " + Date::MONTHNAMES[month_number]
+          else
+            Date::MONTHNAMES[month_number]
+          end
+
+          month_options << ((date.kind_of?(Fixnum) ? date : date.month) == month_number ?
+            "<option value='#{month_number}' selected=\"selected\">#{month_name}</option>\n" : 
+            "<option value='#{month_number}'>#{month_name}</option>\n"
+          )
+        end
+
+        select_html("month", month_options, options[:prefix], options[:include_blank], options[:discard_type])
+      end
+      
+      # Returns a select tag with options for each of the five years on each side of the current, which is selected. The five year radius
+      # can be changed using the <tt>:start_year</tt> and <tt>:end_year</tt> keys in the +options+. The <tt>date</tt> can also be substituted 
+      # for a year given as a number. Example:
+      #
+      #   select_year(Date.today, :start_year => 1992, :end_year => 2007)
+      def select_year(date, options = {})
+        year_options = []
+        unless date.kind_of?(Fixnum) then default_start_year, default_end_year = date.year - 5, date.year + 5 end
+
+        (options[:start_year] || default_start_year).upto(options[:end_year] || default_end_year) do |year|
+          year_options << ((date.kind_of?(Fixnum) ? date : date.year) == year ?
+            "<option selected=\"selected\">#{year}</option>\n" : 
+            "<option>#{year}</option>\n"
+          )
+        end
+
+        select_html("year", year_options, options[:prefix], options[:include_blank], options[:discard_type])
+      end
+      
+      private
+        def select_html(type, options, prefix = nil, include_blank = false, discard_type = false)
+          select_html  = "<select name='#{prefix || DEFAULT_PREFIX}"
+          select_html << "[#{type}]" unless discard_type
+          select_html << "'>\n"
+          select_html << "<option></option>\n" if include_blank
+          select_html << options.to_s
+          select_html << "</select>\n"
+
+          return select_html
+        end
+        
+        def leading_zero_on_single_digits(number)
+          number > 9 ? number : "0#{number}"
+        end
+    end
+
+    class InstanceTag #:nodoc:
+      include DateHelper
+
+      def to_date_select_tag(options = {})
+        defaults = { :discard_type => true }
+        options  = defaults.merge(options) 
+        options_with_prefix = Proc.new { |position| options.update({ :prefix => "#{@object_name}[#{@method_name}(#{position}i)]" }) }
+        date     = options[:include_blank] ? (value || 0) : (value || Date.today)
+
+        date_select = ""
+        
+        if options[:month_before_year]
+          date_select << select_month(date, options_with_prefix.call(2)) unless options[:discard_month]
+          date_select << select_year(date, options_with_prefix.call(1))
+        else
+          date_select << select_year(date, options_with_prefix.call(1))
+          date_select << select_month(date, options_with_prefix.call(2)) unless options[:discard_month]
+        end
+
+        date_select << select_day(date, options_with_prefix.call(3))   unless options[:discard_day] || options[:discard_month]
+
+        return date_select
+      end
+      
+      def to_datetime_select_tag(options = {})
+        defaults = { :discard_type => true }
+        options  = defaults.merge(options) 
+        options_with_prefix = Proc.new { |position| options.update({ :prefix => "#{@object_name}[#{@method_name}(#{position}i)]" }) }
+        datetime = options[:include_blank] ? (value || 0) : (value || Time.now)
+
+        datetime_select  = select_year(datetime, options_with_prefix.call(1))
+        datetime_select << select_month(datetime, options_with_prefix.call(2)) unless options[:discard_month]
+        datetime_select << select_day(datetime, options_with_prefix.call(3)) unless options[:discard_day] || options[:discard_month]
+        datetime_select << " &mdash; " + select_hour(datetime, options_with_prefix.call(4)) unless options[:discard_hour]
+        datetime_select << " : " + select_minute(datetime, options_with_prefix.call(5)) unless options[:discard_minute] || options[:discard_hour]
+        
+        return datetime_select
+      end
+    end
+  end
+end

data/lib/action_view/helpers/debug_helper.rb

@@ -0,0 +1,17 @@
+module ActionView
+  module Helpers
+    # Provides a set of methods for making it easier to locate problems.
+    module DebugHelper
+      # Returns a <pre>-tag set with the +object+ dumped by YAML. Very readable way to inspect an object.
+      def debug(object)
+        begin
+          Marshal::dump(object)
+          "<pre class='debug_dump'>#{h(object.to_yaml).gsub("  ", "&nbsp; ")}</pre>"
+        rescue Object => e
+          # Object couldn't be dumped, perhaps because of singleton methods -- this is the fallback
+          "<code class='debug_dump'>#{h(object.inspect)}</code>"
+        end
+      end
+    end
+  end
+end

data/lib/action_view/helpers/form_helper.rb

@@ -0,0 +1,176 @@
+require 'cgi'
+require File.dirname(__FILE__) + '/date_helper'
+require File.dirname(__FILE__) + '/tag_helper'
+
+module ActionView
+  module Helpers
+    # Provides a set of methods for working with forms and especially forms related to objects assigned to the template.
+    # The following is an example of a complete form for a person object that works for both creates and updates built
+    # with all the form helpers. The <tt>@person</tt> object was assigned by an action on the controller:
+    #   <form action="save_person" method="post">
+    #     Name:           
+    #     <%= text_field "person", "name", "size" => 20 %>
+    #
+    #     Password:       
+    #     <%= password_field "person", "password", "maxsize" => 20 %>
+    #
+    #     Single?:
+    #     <%= check_box "person", "single" %>
+    #
+    #     Description:
+    #     <%= text_area "person", "description", "cols" => 20 %>
+    #
+    #     <input type="submit" value="Save">
+    #   </form>
+    #
+    # ...is compiled to:
+    #
+    #   <form action="save_person" method="post">
+    #     Name:           
+    #     <input type="text" id="person_name" name="person[name]" 
+    #       size="20" value="<%= @person.name %>" />
+    #
+    #     Password:       
+    #     <input type="password" id="person_password" name="person[password]" 
+    #       size="20" maxsize="20" value="<%= @person.password %>" />
+    #
+    #     Single?:
+    #     <input type="checkbox" id="person_single" name="person[single] value="1" />
+    #
+    #     Description:
+    #     <textarea cols="20" rows="40" id="person_description" name="person[description]">
+    #       <%= @person.description %>
+    #     </textarea>
+    #
+    #     <input type="submit" value="Save">
+    #   </form>    
+    #
+    # There's also methods for helping to build form tags in link:classes/ActionView/Helpers/FormOptionsHelper.html, 
+    # link:classes/ActionView/Helpers/DateHelper.html, and link:classes/ActionView/Helpers/ActiveRecordHelper.html
+    module FormHelper
+      # Returns an input tag of the "text" type tailored for accessing a specified attribute (identified by +method+) on an object
+      # assigned to the template (identified by +object+). Additional options on the input tag can be passed as a
+      # hash with +options+.
+      #
+      # Examples (call, result):
+      #   text_field("post", "title", "size" => 20)
+      #     <input type="text" id="post_title" name="post[title]" size="20" value="#{@post.title}" />
+      def text_field(object, method, options = {}) 
+        InstanceTag.new(object, method, self).to_input_field_tag("text", options)
+      end
+
+      # Works just like text_field, but returns a input tag of the "password" type instead.
+      def password_field(object, method, options = {})
+        InstanceTag.new(object, method, self).to_input_field_tag("password", options)
+      end
+
+      # Works just like text_field, but returns a input tag of the "hidden" type instead.
+      def hidden_field(object, method, options = {})
+        InstanceTag.new(object, method, self).to_input_field_tag("hidden", options)
+      end
+
+      # Returns a textarea opening and closing tag set tailored for accessing a specified attribute (identified by +method+)
+      # on an object assigned to the template (identified by +object+). Additional options on the input tag can be passed as a
+      # hash with +options+.
+      #
+      # Example (call, result):
+      #   text_area("post", "body", "cols" => 20, "rows" => 40)
+      #     <textarea cols="20" rows="40" id="post_body" name="post[body]">
+      #       #{@post.body}
+      #     </textarea>
+      def text_area(object, method, options = {})
+        InstanceTag.new(object, method, self).to_text_area_tag(options)
+      end
+      
+      # Returns a checkbox tag tailored for accessing a specified attribute (identified by +method+) on an object
+      # assigned to the template (identified by +object+). It's intended that +method+ returns an integer and if that
+      # integer is above zero, then the checkbox is checked. Additional options on the input tag can be passed as a
+      # hash with +options+. The +value+ defaults to 1, which is convenient for boolean values. 
+      #
+      # Example (call, result). Imagine that @post.validated? returns 1:
+      #   check_box("post", "validated")
+      #     <input type="checkbox" id="post_validate" name="post[validated] value="1" checked="checked" />
+      def check_box(object, method, options = {}, value = "1")
+        InstanceTag.new(object, method, self).to_check_box_tag(options, value)
+      end
+    end
+
+    class InstanceTag #:nodoc:
+      include Helpers::TagHelper
+
+      attr_reader :method_name, :object_name
+      
+      DEFAULT_FIELD_OPTIONS     = { "size" => 30 } unless const_defined?("DEFAULT_FIELD_OPTIONS")
+      DEFAULT_TEXT_AREA_OPTIONS = { "wrap" => "virtual", "cols" => 40, "rows" => 20 } unless const_defined?("DEFAULT_TEXT_AREA_OPTIONS")
+
+      def initialize(object_name, method_name, template_object, local_binding = nil)
+        @object_name, @method_name = object_name, method_name
+        @template_object, @local_binding = template_object, local_binding
+      end
+      
+      def to_input_field_tag(field_type, options = {})
+        html_options = DEFAULT_FIELD_OPTIONS.merge(options)
+        html_options.merge!({ "size" => options["maxlength"]}) if options["maxlength"] && !options["size"]
+        html_options.merge!({ "type" =>  field_type, "value" => value.to_s })
+        add_default_name_and_id(html_options)
+        tag("input", html_options)
+      end
+      
+      def to_text_area_tag(options = {})
+        options = DEFAULT_TEXT_AREA_OPTIONS.merge(options)
+        add_default_name_and_id(options)
+        content_tag("textarea", html_escape(value), options)
+      end
+
+      def to_check_box_tag(options = {}, checked_value = "1")
+        options.merge!({"checked" => "checked"}) if !value.nil? && ((value.is_a?(TrueClass) || value.is_a?(FalseClass)) ? value : value.to_i > 0)
+        options.merge!({ "type" => "checkbox", "value" => checked_value })
+        add_default_name_and_id(options)
+        tag("input", options)
+      end
+
+      def to_date_tag()
+        defaults = { "discard_type" => true }
+        date     = value || Date.today
+        options  = Proc.new { |position| defaults.update({ :prefix => "#{@object_name}[#{@method_name}(#{position}i)]" }) }
+
+        html_day_select(date, options.call(3)) +
+        html_month_select(date, options.call(2)) + 
+        html_year_select(date, options.call(1))
+      end
+
+      def to_boolean_select_tag(options = {})
+        add_default_name_and_id(options)
+        tag_text = "<select"
+        tag_text << tag_options(options)
+        tag_text << "><option value=\"false\""
+        tag_text << " selected" if value == false
+        tag_text << ">False</option><option value=\"true\""
+        tag_text << " selected" if value
+        tag_text << ">True</option></select>"
+      end
+
+      def object
+        @template_object.instance_variable_get "@#{@object_name}"
+      end
+
+      def value
+        object.send(@method_name) unless object.nil?
+      end
+
+      private
+        def add_default_name_and_id(options)
+          options['name'] = tag_name unless options.has_key? "name"
+          options['id'] = tag_id unless options.has_key? "id"
+        end
+				
+        def tag_name
+          "#{@object_name}[#{@method_name}]"
+        end
+
+        def tag_id
+          "#{@object_name}_#{@method_name}"
+        end
+    end
+  end
+end

data/lib/action_view/helpers/form_options_helper.rb

@@ -0,0 +1,169 @@
+require 'cgi'
+require 'erb'
+require File.dirname(__FILE__) + '/form_helper'
+
+module ActionView
+  module Helpers
+    # Provides a number of methods for turning different kinds of containers into a set of option tags. Neither of the methods provide
+    # the actual select tag, so you'll need to construct that in HTML manually.
+    module FormOptionsHelper
+      include ERB::Util
+      
+      def select(object, method, choices, options = {}, html_options = {})
+        InstanceTag.new(object, method, self).to_select_tag(choices, options, html_options)
+      end
+
+      def collection_select(object, method, collection, value_method, text_method, options = {}, html_options = {})
+        InstanceTag.new(object, method, self).to_collection_select_tag(collection, value_method, text_method, options, html_options)
+      end
+
+      def country_select(object, method, priority_countries = nil, options = {}, html_options = {})
+        InstanceTag.new(object, method, self).to_country_select_tag(priority_countries, options, html_options)
+      end
+      
+      # Accepts a container (hash, array, enumerable, your type) and returns a string of option tags. Given a container 
+      # where the elements respond to first and last (such as a two-element array), the "lasts" serve as option values and
+      # the "firsts" as option text. Hashes are turned into this form automatically, so the keys become "firsts" and values
+      # become lasts. If +selected+ is specified, the matching "last" or element will get the selected option-tag.  +Selected+
+      # may also be an array of values to be selected when using a multiple select.
+      #
+      # Examples (call, result):
+      #   options_for_select([["Dollar", "$"], ["Kroner", "DKK"]])
+      #     <option value="$">Dollar</option>\n<option value="DKK">Kroner</option>
+      #
+      #   options_for_select([ "VISA", "Mastercard" ], "Mastercard")
+      #     <option>VISA</option>\n<option selected="selected">Mastercard</option>
+      #
+      #   options_for_select({ "Basic" => "$20", "Plus" => "$40" }, "$40")
+      #     <option value="$20">Basic</option>\n<option value="$40" selected="selected">Plus</option>
+      #
+      #   options_for_select([ "VISA", "Mastercard", "Discover" ], ["VISA", "Discover"])
+      #     <option selected="selected">VISA</option>\n<option>Mastercard</option>\n<option selected="selected">Discover</option>
+      def options_for_select(container, selected = nil)
+        container = container.to_a if Hash === container
+      
+        options_for_select = container.inject([]) do |options, element| 
+          if element.respond_to?(:first) && element.respond_to?(:last)
+            is_selected = ( (selected.respond_to?(:include?) ? selected.include?(element.last) : element.last == selected) )
+            if is_selected
+              options << "<option value=\"#{html_escape(element.last.to_s)}\" selected=\"selected\">#{html_escape(element.first.to_s)}</option>"
+            else
+              options << "<option value=\"#{html_escape(element.last.to_s)}\">#{html_escape(element.first.to_s)}</option>"
+            end
+          else
+            is_selected = ( (selected.respond_to?(:include?) ? selected.include?(element) : element == selected) )
+            options << ((is_selected) ? "<option selected=\"selected\">#{html_escape(element.to_s)}</option>" : "<option>#{html_escape(element.to_s)}</option>")
+          end
+        end
+        
+        options_for_select.join("\n")
+      end
+
+      # Returns a string of option tags that has been compiled by iterating over the +collection+ and assigning the 
+      # the result of a call to the +value_method+ as the option value and the +text_method+ as the option text.
+      # If +selected_value+ is specified, the element returning a match on +value_method+ will get the selected option tag.
+      #
+      # Example (call, result). Imagine a loop iterating over each +person+ in <tt>@project.people</tt> to generate a input tag:
+      #   options_from_collection_for_select(@project.people, "id", "name")
+      #     <option value="#{person.id}">#{person.name}</option>
+      def options_from_collection_for_select(collection, value_method, text_method, selected_value = nil)
+        options_for_select(
+          collection.inject([]) { |options, object| options << [ object.send(text_method), object.send(value_method) ] }, 
+          selected_value
+        )
+      end
+
+      # Returns a string of option tags, like options_from_collection_for_select, but surrounds them by <optgroup> tags.
+      #
+      # An array of group objects are passed. Each group should return an array of options when calling group_method
+      # Each group should should return its name when calling group_label_method.
+      #
+      # html_option_groups_from_collection(@continents, "countries", "contient_name", "country_id", "country_name", @selected_country.id)
+      #
+      # Could become:
+      #  <optgroup label="Africa">
+      #   <select>Egypt</select>
+      #   <select>Rwanda</select>
+      #   ...
+      #  </optgroup>
+      #  <optgroup label="Asia">
+      #   <select>China</select>
+      #   <select>India</select>
+      #   <select>Japan</select>
+      #   ...
+      #  </optgroup>
+      #
+      # with objects of the following classes:
+      # class Continent
+      #	  def initialize(p_name, p_countries)	@continent_name = p_name; @countries = p_countries;	end
+      #	  def continent_name() @continent_name; end
+      #	  def countries() @countries; end
+      # end
+      # class Country
+      #	  def initialize(id, name) @id = id; @name = name end
+      #	  def country_id() @id; end
+      #	  def country_name() @name; end
+      # end
+      def option_groups_from_collection_for_select(collection, group_method, group_label_method, 
+            option_key_method, option_value_method, selected_key = nil)
+        collection.inject("") do |options_for_select, group|
+          group_label_string = eval("group.#{group_label_method}")
+          options_for_select += "<optgroup label=\"#{html_escape(group_label_string)}\">"
+          options_for_select += options_from_collection_for_select(eval("group.#{group_method}"), option_key_method, option_value_method, selected_key)
+          options_for_select += '</optgroup>'
+        end
+      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.
+      def country_options_for_select(selected = nil, priority_countries = nil)
+        country_options = ""
+        
+        if priority_countries
+          country_options += options_for_select(priority_countries, selected)
+          country_options += "<option>-------------</option>\n"
+        end
+
+        if priority_countries && priority_countries.include?(selected)
+          country_options += options_for_select(COUNTRIES - priority_countries, selected)
+        else
+          country_options += options_for_select(COUNTRIES, selected)
+        end
+
+        return country_options
+      end
+
+
+      private
+        # All the countries included in the country_options output.
+        COUNTRIES = [ "Albania", "Algeria", "American Samoa", "Andorra", "Angola", "Anguilla", "Antarctica", "Antigua And Barbuda", "Argentina", "Armenia", "Aruba", "Australia", "Austria", "Azerbaijan", "Bahamas", "Bahrain", "Bangladesh", "Barbados", "Belarus", "Belgium", "Belize", "Benin", "Bermuda", "Bhutan", "Bolivia", "Bosnia and Herzegowina", "Botswana", "Bouvet Island", "Brazil", "British Indian Ocean Territory", "Brunei Darussalam", "Bulgaria", "Burkina Faso", "Burma", "Burundi", "Cambodia", "Cameroon", "Canada", "Cape Verde", "Cayman Islands", "Central African Republic", "Chad", "Chile", "China", "Christmas Island", "Cocos (Keeling) Islands", "Colombia", "Comoros", "Congo", "Congo, the Democratic Republic of the", "Cook Islands", "Costa Rica", "Cote d'Ivoire", "Croatia", "Cyprus", "Czech Republic", "Denmark", "Djibouti", "Dominica", "Dominican Republic", "East Timor", "Ecuador", "Egypt", "El Salvador", "England", "Equatorial Guinea", "Eritrea", "Espana", "Estonia", "Ethiopia", "Falkland Islands", "Faroe Islands", "Fiji", "Finland", "France", "French Guiana", "French Polynesia", "French Southern Territories", "Gabon", "Gambia", "Georgia", "Germany", "Ghana", "Gibraltar", "Great Britain", "Greece", "Greenland", "Grenada", "Guadeloupe", "Guam", "Guatemala", "Guinea", "Guinea-Bissau", "Guyana", "Haiti", "Heard and Mc Donald Islands", "Honduras", "Hong Kong", "Hungary", "Iceland", "India", "Indonesia", "Ireland", "Israel", "Italy", "Jamaica", "Japan", "Jordan", "Kazakhstan", "Kenya", "Kiribati", "Korea, Republic of", "Korea (South)", "Kuwait", "Kyrgyzstan", "Lao People's Democratic Republic", "Latvia", "Lebanon", "Lesotho", "Liberia", "Liechtenstein", "Lithuania", "Luxembourg", "Macau", "Macedonia", "Madagascar", "Malawi", "Malaysia", "Maldives", "Mali", "Malta", "Marshall Islands", "Martinique", "Mauritania", "Mauritius", "Mayotte", "Mexico", "Micronesia, Federated States of", "Moldova, Republic of", "Monaco", "Mongolia", "Montserrat", "Morocco", "Mozambique", "Myanmar", "Namibia", "Nauru", "Nepal", "Netherlands", "Netherlands Antilles", "New Caledonia", "New Zealand", "Nicaragua", "Niger", "Nigeria", "Niue", "Norfolk Island", "Northern Ireland", "Northern Mariana Islands", "Norway", "Oman", "Pakistan", "Palau", "Panama", "Papua New Guinea", "Paraguay", "Peru", "Philippines", "Pitcairn", "Poland", "Portugal", "Puerto Rico", "Qatar", "Reunion", "Romania", "Russia", "Russian Federation", "Rwanda", "Saint Kitts and Nevis", "Saint Lucia", "Saint Vincent and the Grenadines", "Samoa (Independent)", "San Marino", "Sao Tome and Principe", "Saudi Arabia", "Scotland", "Senegal", "Seychelles", "Sierra Leone", "Singapore", "Slovakia", "Slovenia", "Solomon Islands", "Somalia", "South Africa", "South Georgia and the South Sandwich Islands", "South Korea", "Spain", "Sri Lanka", "St. Helena", "St. Pierre and Miquelon", "Suriname", "Svalbard and Jan Mayen Islands", "Swaziland", "Sweden", "Switzerland", "Taiwan", "Tajikistan", "Tanzania", "Thailand", "Togo", "Tokelau", "Tonga", "Trinidad", "Trinidad and Tobago", "Tunisia", "Turkey", "Turkmenistan", "Turks and Caicos Islands", "Tuvalu", "Uganda", "Ukraine", "United Arab Emirates", "United Kingdom", "United States", "United States Minor Outlying Islands", "Uruguay", "Uzbekistan", "Vanuatu", "Vatican City State (Holy See)", "Venezuela", "Viet Nam", "Virgin Islands (British)", "Virgin Islands (U.S.)", "Wales", "Wallis and Futuna Islands", "Western Sahara", "Yemen", "Zambia", "Zimbabwe" ] unless const_defined?("COUNTRIES")
+    end
+
+    class InstanceTag #:nodoc:
+      include FormOptionsHelper
+
+      def to_select_tag(choices, options, html_options)
+        add_default_name_and_id(html_options)
+        content_tag("select", add_blank_option(options_for_select(choices, value), options[:include_blank]), html_options)
+      end
+
+      def to_collection_select_tag(collection, value_method, text_method, options, html_options)
+        add_default_name_and_id(html_options)
+        content_tag(
+          "select", add_blank_option(options_from_collection_for_select(collection, value_method, text_method, value), options[:include_blank]), html_options
+        )
+      end
+      
+      def to_country_select_tag(priority_countries, options, html_options)
+        add_default_name_and_id(html_options)
+        content_tag("select", add_blank_option(country_options_for_select(value, priority_countries), options[:include_blank]), html_options)
+      end
+
+      private
+        def add_blank_option(option_tags, add_blank)
+          add_blank ? "<option></option>\n" + option_tags : option_tags
+        end
+    end
+  end
+end