fortitude 0.0.4-java

data/lib/fortitude/method_templates/tag_method_template.rb.smpl

@@ -0,0 +1,68 @@
+def #{method_name}(content_or_attributes = nil, attributes = nil)
+  o = @_fortitude_output_buffer_holder.output_buffer
+  rc = @_fortitude_rendering_context                                       # :if needs_element_rules || needs_formatting
+
+  this_tag = #{tag_object_const}                                           # :if needs_element_rules || needs_attribute_rules || needs_id_uniqueness
+  rc.record_tag(self, this_tag) do                                         # :if needs_element_rules
+    format_output = rc.format_output?                                      # :if needs_formatting
+    if format_output                                                       # :if needs_formatting
+      rc.needs_newline!                                                    # :if needs_formatting && newline_before
+      rc.about_to_output_non_whitespace!                                   # :if needs_formatting
+    end                                                                    # :if needs_formatting
+
+    if (! content_or_attributes)
+      if block_given?
+        _fortitude_raise_no_content_allowed_error(#{tag_object_const})     # :if ! content_allowed
+        o.#{concat_method}(#{open_const})
+        #{yield_call}
+        o.#{concat_method}(#{close_const})
+      else
+        o.#{concat_method}(#{alone_const})
+      end
+    elsif content_or_attributes.kind_of?(Hash)
+      this_tag.validate_attributes(self, content_or_attributes)            # :if needs_attribute_rules
+      this_tag.validate_id_uniqueness(self, content_or_attributes)         # :if needs_id_uniqueness
+      o.#{concat_method}(#{partial_open_const})
+      content_or_attributes.fortitude_append_as_attributes(o, nil)
+
+      if block_given?
+        _fortitude_raise_no_content_allowed_error(#{tag_object_const})     # :if ! content_allowed
+        o.#{concat_method}(#{partial_open_end_const})
+        #{yield_call}
+        o.#{concat_method}(#{close_const})
+      else
+        o.#{concat_method}(#{partial_open_alone_end_const})
+      end
+    elsif (! attributes)
+      _fortitude_raise_no_content_allowed_error(#{tag_object_const})       # :if ! content_allowed
+      o.#{concat_method}(#{open_const})
+      rc.record_tag(self, FORTITUDE_TEXT_PSEUDOTAG) { } unless content_or_attributes.instance_variable_get("@html_safe") # :if needs_element_rules
+      content_or_attributes.to_s.fortitude_append_escaped_string(o)        # :if escape_direct_content
+      o.#{concat_method}(content_or_attributes.to_s)                       # :if ! escape_direct_content
+      if block_given?
+        _fortitude_raise_no_content_allowed_error(#{tag_object_const})     # :if ! content_allowed
+        #{yield_call}
+      end
+      o.#{concat_method}(#{close_const})
+    else
+      _fortitude_raise_no_content_allowed_error(#{tag_object_const})       # :if ! content_allowed
+      this_tag.validate_attributes(self, attributes)                       # :if needs_attribute_rules
+      this_tag.validate_id_uniqueness(self, attributes)                    # :if needs_id_uniqueness
+      o.#{concat_method}(#{partial_open_const})
+      attributes.fortitude_append_as_attributes(o, nil)
+      o.#{concat_method}(#{partial_open_end_const})
+
+      rc.record_tag(self, FORTITUDE_TEXT_PSEUDOTAG) { } unless content_or_attributes.instance_variable_get("@html_safe") # :if needs_element_rules
+      content_or_attributes.to_s.fortitude_append_escaped_string(o)        # :if escape_direct_content
+      o.#{concat_method}(content_or_attributes.to_s)                       # :if ! escape_direct_content
+      if block_given?
+        _fortitude_raise_no_content_allowed_error(#{tag_object_const})     # :if ! content_allowed
+        #{yield_call}
+      end
+      o.#{concat_method}(#{close_const})
+    end
+    rc.needs_newline! if format_output                                     # :if needs_formatting && newline_before
+  end                                                                      # :if needs_element_rules
+
+  FORTITUDE_NO_RETURN_VALUE_FROM_TAGS
+end

data/lib/fortitude/method_templates/text_method_template.rb.smpl

@@ -0,0 +1,17 @@
+def tag_text(s)
+  @_fortitude_rendering_context.about_to_output_non_whitespace!    # :if format_output
+
+  unless s.instance_variable_get("@html_safe")                     # :if needs_element_rules
+    @_fortitude_rendering_context.record_tag(self, FORTITUDE_TEXT_PSEUDOTAG) { } # :if needs_element_rules
+  end                                                              # :if needs_element_rules
+
+  s.to_s.fortitude_append_escaped_string(@_fortitude_output_buffer_holder.output_buffer)
+end
+
+def tag_rawtext(s)
+  @_fortitude_rendering_context.about_to_output_non_whitespace!    # :if format_output
+  @_fortitude_output_buffer_holder.output_buffer.original_concat(s)
+end
+
+alias_method :text, :tag_text
+alias_method :rawtext, :tag_rawtext

data/lib/fortitude/rails.rb

@@ -0,0 +1,26 @@
+# See if we can load Rails -- but don't fail if we can't; we'll just use this to decide whether we should
+# load the Railtie or not.
+begin
+  gem 'rails'
+rescue Gem::LoadError => le
+  # ok
+end
+
+begin
+  require 'rails'
+rescue LoadError => le
+  # ok
+end
+
+if defined?(::Rails)
+  require 'action_view'
+
+  require 'fortitude/rails/widget_methods'
+  require 'fortitude/rails/renderer'
+  require 'fortitude/rails/template_handler'
+  require 'fortitude/rails/railtie'
+else
+  ::String.class_eval do
+    alias_method :original_concat, :concat
+  end
+end

data/lib/fortitude/rails/helpers.rb

@@ -0,0 +1,153 @@
+module Fortitude
+  module Rails
+    module Helpers
+      class << self
+        def helper(name, options = { })
+          @helpers ||= { }
+          @helpers[name] = options
+        end
+
+        def helper_options(name)
+          @helpers[name.to_s.strip.downcase.to_sym]
+        end
+
+        def apply_refined_helpers_to!(o)
+          @helpers.each do |name, options|
+            o.helper(name, options)
+          end
+        end
+      end
+
+      # tags/
+      # active_model_helper
+      # asset_tag_helper
+      helper :javascript_include_tag, :transform => :output_return_value
+      helper :stylesheet_link_tag, :transform => :output_return_value
+      helper :auto_discovery_link_tag, :transform => :output_return_value
+      helper :favicon_link_tag, :transform => :output_return_value
+      helper :image_tag, :transform => :output_return_value
+      helper :video_tag, :transform => :output_return_value
+      helper :audio_tag, :transform => :output_return_value
+
+      # asset_url_helper
+      # atom_feed_helper
+      # cache_helper
+      # capture_helper
+      # controller_helper
+      # csrf_helper
+      helper :csrf_meta_tags, :transform => :output_return_value
+      helper :csrf_meta_tag, :transform => :output_return_value
+
+      # date_helper
+      helper :date_select, :transform => :output_return_value
+      helper :time_select, :transform => :output_return_value
+      helper :datetime_select, :transform => :output_return_value
+      helper :select_datetime, :transform => :output_return_value
+      helper :select_date, :transform => :output_return_value
+      helper :select_time, :transform => :output_return_value
+      helper :select_second, :transform => :output_return_value
+      helper :select_minute, :transform => :output_return_value
+      helper :select_hour, :transform => :output_return_value
+      helper :select_day, :transform => :output_return_value
+      helper :select_month, :transform => :output_return_value
+      helper :select_year, :transform => :output_return_value
+      helper :time_tag, :transform => :output_return_value
+
+      # debug_helper
+      helper :debug, :transform => :output_return_value
+
+      # form_helper
+      FORM_FOR_YIELDED_METHODS_TO_OUTPUT =
+        # Directly from form_helper
+        %w{check_box color_field date_field datetime_field datetime_local_field} +
+        %w{email_field file_field hidden_field label month_field number_field password_field phone_field} +
+        %w{radio_button range_field search_field telephone_field text_area text_field time_field url_field} +
+        %w{week_field} +
+
+        # From form_options_helper
+        %w{select collection_select grouped_collection_select time_zone_select options_for_select} +
+        %w{options_from_collection_for_select option_groups_from_collection_for_select grouped_options_for_select} +
+        %w{time_zone_options_for_select collection_radio_buttons collection_check_boxes}
+
+      helper :form_for, :transform => :output_return_value, :output_yielded_methods => FORM_FOR_YIELDED_METHODS_TO_OUTPUT
+      helper :fields_for, :transform => :output_return_value, :output_yielded_methods => FORM_FOR_YIELDED_METHODS_TO_OUTPUT
+
+      # form_options_helper
+      # helper :select, :transform => :output_return_value # conflicts with HTML <select> tag
+      helper :collection_select, :transform => :output_return_value
+      helper :grouped_collection_select, :transform => :output_return_value
+      helper :time_zone_select, :transform => :output_return_value
+      helper :options_for_select, :transform => :output_return_value
+      helper :options_from_collection_for_select, :transform => :output_return_value
+      helper :option_groups_from_collection_for_select, :transform => :output_return_value
+      helper :grouped_options_for_select, :transform => :output_return_value
+      helper :time_zone_options_for_select, :transform => :output_return_value
+      helper :collection_radio_buttons, :transform => :output_return_value
+      helper :collection_check_boxes, :transform => :output_return_value
+
+      # form_tag_helper
+      helper :form_tag, :transform => :output_return_value
+      helper :select_tag, :transform => :output_return_value
+      helper :text_field_tag, :transform => :output_return_value
+      helper :label_tag, :transform => :output_return_value
+      helper :hidden_field_tag, :transform => :output_return_value
+      helper :file_field_tag, :transform => :output_return_value
+      helper :password_field_tag, :transform => :output_return_value
+      helper :text_area_tag, :transform => :output_return_value
+      helper :check_box_tag, :transform => :output_return_value
+      helper :radio_button_tag, :transform => :output_return_value
+      helper :submit_tag, :transform => :output_return_value
+      helper :button_tag, :transform => :output_return_value
+      helper :image_submit_tag, :transform => :output_return_value
+      helper :field_set_tag, :transform => :output_return_value
+      helper :color_field_tag, :transform => :output_return_value
+      helper :search_field_tag, :transform => :output_return_value
+      helper :telephone_field_tag, :transform => :output_return_value
+      helper :phone_field_tag, :transform => :output_return_value
+      helper :date_field_tag, :transform => :output_return_value
+      helper :time_field_tag, :transform => :output_return_value
+      helper :datetime_field_tag, :transform => :output_return_value
+      helper :datetime_local_field_tag, :transform => :output_return_value
+      helper :month_field_tag, :transform => :output_return_value
+      helper :week_field_tag, :transform => :output_return_value
+      helper :url_field_tag, :transform => :output_return_value
+      helper :email_field_tag, :transform => :output_return_value
+      helper :number_field_tag, :transform => :output_return_value
+      helper :range_field_tag, :transform => :output_return_value
+      helper :utf8_enforcer_tag, :transform => :output_return_value
+
+      # javascript_helper
+      helper :javascript_tag, :transform => :output_return_value
+      helper :javascript_cdata_section, :transform => :output_return_value
+      helper :button_to_function, :transform => :output_return_value
+      helper :link_to_function, :transform => :output_return_value
+
+      # number_helper
+      # output_safety_helper
+      # record_tag_helper
+      helper :div_for, :transform => :output_return_value
+      helper :content_tag_for, :transform => :output_return_value
+
+      # rendering_helper
+      # #render is special-cased; Widget implements it directly
+
+      # sanitize_helper
+      # tag_helper
+      # #tag conflicts with Widget's #tag method, and probably isn't something you want anyway
+      helper :content_tag, :transform => :output_return_value
+      helper :cdata_section, :transform => :output_return_value
+
+      # text_helper
+      # translation_helper
+      # url_helper
+      helper :link_to, :transform => :output_return_value
+      helper :button_to, :transform => :output_return_value
+      helper :link_to_unless_current, :transform => :output_return_value
+      helper :link_to_unless, :transform => :output_return_value
+      helper :link_to_if, :transform => :output_return_value
+      helper :mail_to, :transform => :output_return_value
+
+      helper :capture
+    end
+  end
+end

data/lib/fortitude/rails/railtie.rb

@@ -0,0 +1,256 @@
+require 'fortitude/rendering_context'
+
+if defined?(ActiveSupport)
+  ActiveSupport.on_load(:before_initialize) do
+    ActiveSupport.on_load(:action_view) do
+      require "fortitude/rails/template_handler"
+    end
+  end
+end
+
+module Fortitude
+  class << self
+    def refine_rails_helpers(on_or_off = :not_specified)
+      @refine_rails_helpers = !! on_or_off unless on_or_off == :not_specified
+      !! @refine_rails_helpers
+    end
+  end
+
+  refine_rails_helpers true
+end
+
+module Fortitude
+  module Rails
+    class Railtie < ::Rails::Railtie
+      config.after_initialize do
+        if Fortitude.refine_rails_helpers
+          require 'fortitude/rails/helpers'
+          Fortitude::Rails::Helpers.apply_refined_helpers_to!(Fortitude::Widget)
+        end
+
+        if ::Rails.env.development?
+          ::Fortitude::Widget.class_eval do
+            format_output true
+            start_and_end_comments true
+            debug true
+          end
+        end
+      end
+
+      initializer :fortitude, :before => :set_autoload_paths do |app|
+        # All of this code is involved in setting up autoload_paths to work with Fortitude.
+        # Why so hard?
+        #
+        # We're trying to do something that ActiveSupport::Dependencies -- which is what Rails uses for
+        # class autoloading -- doesn't really support. We want app/views to be on the autoload path,
+        # because there are now Ruby classes living there. (It usually isn't just because all that's there
+        # are template source files, not actual Ruby code.) That isn't an issue, though -- adding it
+        # is trivial (just do
+        # <tt>ActiveSupport::Dependencies.autoload_paths << File.join(Rails.root, 'app/views')</tt>).
+        #
+        # The real issue is that we want the class <tt>app/views/foo/bar.rb</tt> to define a class called
+        # <tt>Views::Foo::Bar</tt>, not just plain <tt>Foo::Bar</tt>. This is what's different from what
+        # ActiveSupport::Dependencies normally supports; it expects the filesystem path underneath the
+        # root to be exactly identical to the fully-qualified class name.
+        #
+        # Why are we doing this crazy thing? Because we want you to be able to have a view called
+        # <tt>app/views/user/password.rb</tt>, and _not_ have that conflict with a module you just happen to define
+        # elsewhere called <tt>User::Password</tt>. If we don't prefix view classes with anything at all, then the
+        # potential for conflicts is enormous.
+        #
+        # As such, we have this code. We'll walk through it step-by-step; note that at the end we *do*
+        # add app/views/ to the autoload path, so all this code is doing is just dealing with the fact that
+        # the fully-qualified classname (<tt>Views::Foo::Bar</tt>) has one extra component on the front of it
+        # (<tt>Views::</tt>) when compared to the subpath (<tt>foo/bar.rb</tt>) underneath what's on the autoload
+        # path (<tt>app/views</tt>).
+
+        # Go compute our views root.
+        views_root = File.expand_path(File.join(::Rails.root, 'app', 'views'))
+
+        # Now, do all this work inside ::ActiveSupport::Dependencies...
+        ::ActiveSupport::Dependencies.module_eval do
+          @@_fortitude_views_root = views_root
+
+          # This is the method that gets called to auto-generate namespacing empty
+          # modules (_e.g._, the toplevel <tt>Views::</tt> module) for directories
+          # under an autoload path.
+          #
+          # The original method says:
+          #
+          # "Does the provided path_suffix correspond to an autoloadable module?
+          # Instead of returning a boolean, the autoload base for this module is
+          # returned."
+          #
+          # So, we just need to strip off the leading +views/+ from the +path_suffix+,
+          # and see if that maps to a directory underneath <tt>app/views/</tt>; if so,
+          # we'll return the path to <tt>.../app/views/</tt>. Otherwise, we just
+          # delegate back to the superclass method.
+          def autoloadable_module_with_fortitude?(path_suffix)
+            if path_suffix =~ %r{^views(/.*)?$}i
+              # If we got here, then we were passed a subpath of views/....
+              subpath = $1
+
+              if subpath.blank? || File.directory?(File.join(@@_fortitude_views_root, subpath))
+                return @@_fortitude_views_root
+              end
+            end
+
+            with_fortitude_views_removed_from_autoload_path do
+              autoloadable_module_without_fortitude?(path_suffix)
+            end
+          end
+
+          alias_method_chain :autoloadable_module?, :fortitude
+
+          # When we delegate back to original methods, we want them to act as if
+          # <tt>app/views/</tt> is _not_ on the autoload path. In order to be thread-safe
+          # about that, we couple this method with our override of the writer side of the
+          # <tt>mattr_accessor :autoload_paths</tt>, which simply prefers the thread-local
+          # that we set to the actual underlying variable.
+          def with_fortitude_views_removed_from_autoload_path
+            begin
+              Thread.current[:_fortitude_autoload_paths_override] = autoload_paths - [ @@_fortitude_views_root ]
+              yield
+            ensure
+              Thread.current[:_fortitude_autoload_paths_override] = nil
+            end
+          end
+
+          # The use of 'class_eval' here may seem funny, and I think it is, but, without it,
+          # the +@@autoload_paths+ gets interpreted as a class variable for this *Railtie*,
+          # rather than for ::ActiveSupport::Dependencies. (Why is that? Got me...)
+          class_eval <<-EOS
+            def self.autoload_paths
+              Thread.current[:_fortitude_autoload_paths_override] || @@autoload_paths
+            end
+          EOS
+
+          # The original method says:
+          #
+          # "Search for a file in autoload_paths matching the provided suffix."
+          #
+          # So, we just look to see if the given +path_suffix+ is specifying something like
+          # <tt>views/foo/bar</tt>; if so, we glue it together properly, removing the initial
+          # <tt>views/</tt> first. (Otherwise, the mechanism would expect
+          # <tt>Views::Foo::Bar</tt> to show up in <tt>app/views/views/foo/bar</tt> (yes, a double
+          # +views+), since <tt>app/views</tt> is on the autoload path.)
+          def search_for_file_with_fortitude(path_suffix)
+            # This just makes sure our path always ends in exactly one ".rb", whether it started
+            # with one or not.
+            new_path_suffix = path_suffix.sub(/(\.rb)?$/, ".rb")
+
+            if new_path_suffix =~ %r{^views(/.*)$}i
+              path = File.join(@@_fortitude_views_root, $1)
+              return path if File.file?(path)
+            end
+
+            # Make sure that we remove the views autoload path before letting the rest of
+            # the dependency mechanism go searching for files, or else <tt>app/views/foo/bar.rb</tt>
+            # *will* be found when looking for just <tt>::Foo::Bar</tt>.
+            with_fortitude_views_removed_from_autoload_path { search_for_file_without_fortitude(path_suffix) }
+          end
+
+          alias_method_chain :search_for_file, :fortitude
+        end
+
+        # And, finally, this is where we add our root to the set of autoload paths.
+        ::ActiveSupport::Dependencies.autoload_paths << views_root
+
+        # This is our support for partials. Fortitude doesn't really have a distinction between
+        # partials and "full" templates -- everything is just a widget, which is much more elegant --
+        # but we still want you to be able to render a widget <tt>Views::Foo::Bar</tt> by saying
+        # <tt>render :partial => 'foo/bar'</tt> (from ERb, although you can do it from Fortitude if
+        # you want for some reason, too).
+        #
+        # Normally, ActionView only looks for partials in files starting with an underscore. We
+        # do want to allow this, too (in the above case, if you define the widget in the file
+        # <tt>app/views/foo/_bar.rb</tt>, it will still work fine); however, we also want to allow
+        # you to define it in a file that does _not_ start with an underscore ('cause these are
+        # Ruby classes, and that's just plain weird).
+        #
+        # So, we patch #find_templates: if it's looking for a partial, doesn't find one, and is
+        # searching Fortitude templates (the +.rb+ handler), then we try again, turning off the
+        # +partial+ flag, and return that instead.
+        ::ActionView::PathResolver.class_eval do
+          def find_templates_with_fortitude(name, prefix, partial, details)
+            templates = find_templates_without_fortitude(name, prefix, partial, details)
+            if partial && templates.empty? && details[:handlers] && details[:handlers].include?(:rb)
+              templates = find_templates_without_fortitude(name, prefix, false, details.merge(:handlers => [ :rb ]))
+            end
+            templates
+          end
+
+          alias_method_chain :find_templates, :fortitude
+        end
+
+        require "fortitude/rails/template_handler"
+
+        # This is our support for render :widget. Although, originally, it looked like creating a new subclass
+        # of ActionView::Template was going to be the correct thing to do here, it turns out it isn't: the entire
+        # template system is predicated around the idea that you have a template, which is compiled to output
+        # Ruby source code, and then that gets evaluated to actually generate output.
+        #
+        # Because <tt>render :widget => ...</tt> takes an already-instantiated widget as input, this simply isn't
+        # possible: you can't reverse-engineer an arbitrary Ruby object into source code, and, without source code,
+        # the whole templating paradigm doesn't make sense.
+        #
+        # So, instead, we simply transform <tt>render :widget => ...</tt> into a <tt>render :text => ...</tt> of the
+        # widget's output, and let Rails take it away from there.
+        ::ActionController::Base.class_eval do
+          def fortitude_rendering_context(options)
+            @_fortitude_rendering_context ||= create_fortitude_rendering_context(options)
+          end
+
+          def create_fortitude_rendering_context(options)
+            ::Fortitude::RenderingContext.new(options)
+          end
+
+          def render_with_fortitude(*args, &block)
+            if (options = args[0]).kind_of?(Hash)
+              if (widget = options[:widget])
+                rendering_context = fortitude_rendering_context(:delegate_object => self)
+                widget.render_to(rendering_context)
+
+                options = options.dup
+                options[:text] = rendering_context.output_buffer_holder.output_buffer.html_safe
+                options[:layout] = true unless options.has_key?(:layout)
+
+                new_args = [ options ] + args[1..-1]
+                return render_without_fortitude(*new_args, &block)
+              elsif (widget_block = options[:inline]) && (options[:type] == :fortitude)
+                options.delete(:inline)
+
+                rendering_context = fortitude_rendering_context(:delegate_object => self)
+                widget_class = Class.new(Fortitude::Widgets::Html5)
+                widget_class.use_instance_variables_for_assigns(true)
+                widget_class.extra_assigns(:use)
+                widget_class.send(:define_method, :content, &widget_block)
+
+                assigns = { }
+                instance_variables.each do |ivar_name|
+                  value = instance_variable_get(ivar_name)
+                  assigns[$1.to_sym] = value if ivar_name =~ /^@(.*)$/
+                end
+                assigns = assigns.merge(options[:locals] || { })
+
+                widget = widget_class.new(assigns)
+                widget.render_to(rendering_context)
+
+                options = options.dup
+                options[:text] = rendering_context.output_buffer_holder.output_buffer.html_safe
+                options[:layout] = true unless options.has_key?(:layout)
+
+                new_args = [ options ] + args[1..-1]
+                return render_without_fortitude(*new_args, &block)
+              end
+            end
+
+            return render_without_fortitude(*args, &block)
+          end
+
+          alias_method_chain :render, :fortitude
+        end
+      end
+    end
+  end
+end