easel_helpers 0.3.0

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Josh Clayton
+
+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/Manifest

@@ -0,0 +1,31 @@
+easel_helpers.gemspec
+lib/easel_helpers/helpers/date_helper.rb
+lib/easel_helpers/helpers/form_helper.rb
+lib/easel_helpers/helpers/grid_helper.rb
+lib/easel_helpers/helpers/jquery_helper.rb
+lib/easel_helpers/helpers/link_helper.rb
+lib/easel_helpers/helpers/message_helper.rb
+lib/easel_helpers/helpers/navigation_helper.rb
+lib/easel_helpers/helpers/rjs_helper.rb
+lib/easel_helpers/helpers/structure_helper.rb
+lib/easel_helpers/helpers/table_helper.rb
+lib/easel_helpers/helpers.rb
+lib/easel_helpers/rails_partial_caching.rb
+lib/easel_helpers.rb
+Manifest
+MIT-LICENSE
+rails/init.rb
+Rakefile
+README.textile
+tasks/easel_helpers_tasks.rake
+test/date_helper_test.rb
+test/form_helper_test.rb
+test/grid_helper_test.rb
+test/jquery_helper_test.rb
+test/link_helper_test.rb
+test/message_helper_test.rb
+test/navigation_helper_test.rb
+test/rjs_helper_test.rb
+test/structure_helper_test.rb
+test/table_helper_test.rb
+test/test_helper.rb

data/README.textile

@@ -0,0 +1,3 @@
+h1. Easel Helpers
+
+Copyright (c) 2009 Josh Clayton, released under the MIT license

data/Rakefile

@@ -0,0 +1,18 @@
+require 'rake'
+require 'rake/testtask'
+require 'rcov/rcovtask'
+require 'echoe'
+
+Echoe.new("easel_helpers", "0.3.0") do |p|
+  p.description = "Fusionary Rails View Helpers"
+  p.url = "http://github.com/fusionary/easel_helpers"
+  p.author = "Joshua Clayton"
+  p.email = "joshua.clayton@gmail.com"
+  p.ignore_pattern = ["tmp/*"]
+  p.development_dependencies = ["actionview >= 2.1.0", "activesupport >= 2.1.0", "hpricot >= 0.8.1"]
+end
+
+Rcov::RcovTask.new("rcov:current") do |t|
+  t.libs << "test"
+  t.test_files = FileList['test/*_test.rb']
+end

data/easel_helpers.gemspec

@@ -0,0 +1,41 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{easel_helpers}
+  s.version = "0.3.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Joshua Clayton"]
+  s.date = %q{2009-08-21}
+  s.description = %q{Fusionary Rails View Helpers}
+  s.email = %q{joshua.clayton@gmail.com}
+  s.extra_rdoc_files = ["lib/easel_helpers/helpers/date_helper.rb", "lib/easel_helpers/helpers/form_helper.rb", "lib/easel_helpers/helpers/grid_helper.rb", "lib/easel_helpers/helpers/jquery_helper.rb", "lib/easel_helpers/helpers/link_helper.rb", "lib/easel_helpers/helpers/message_helper.rb", "lib/easel_helpers/helpers/navigation_helper.rb", "lib/easel_helpers/helpers/rjs_helper.rb", "lib/easel_helpers/helpers/structure_helper.rb", "lib/easel_helpers/helpers/table_helper.rb", "lib/easel_helpers/helpers.rb", "lib/easel_helpers/rails_partial_caching.rb", "lib/easel_helpers.rb", "README.textile", "tasks/easel_helpers_tasks.rake"]
+  s.files = ["easel_helpers.gemspec", "lib/easel_helpers/helpers/date_helper.rb", "lib/easel_helpers/helpers/form_helper.rb", "lib/easel_helpers/helpers/grid_helper.rb", "lib/easel_helpers/helpers/jquery_helper.rb", "lib/easel_helpers/helpers/link_helper.rb", "lib/easel_helpers/helpers/message_helper.rb", "lib/easel_helpers/helpers/navigation_helper.rb", "lib/easel_helpers/helpers/rjs_helper.rb", "lib/easel_helpers/helpers/structure_helper.rb", "lib/easel_helpers/helpers/table_helper.rb", "lib/easel_helpers/helpers.rb", "lib/easel_helpers/rails_partial_caching.rb", "lib/easel_helpers.rb", "Manifest", "MIT-LICENSE", "rails/init.rb", "Rakefile", "README.textile", "tasks/easel_helpers_tasks.rake", "test/date_helper_test.rb", "test/form_helper_test.rb", "test/grid_helper_test.rb", "test/jquery_helper_test.rb", "test/link_helper_test.rb", "test/message_helper_test.rb", "test/navigation_helper_test.rb", "test/rjs_helper_test.rb", "test/structure_helper_test.rb", "test/table_helper_test.rb", "test/test_helper.rb"]
+  s.has_rdoc = true
+  s.homepage = %q{http://github.com/fusionary/easel_helpers}
+  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Easel_helpers", "--main", "README.textile"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{easel_helpers}
+  s.rubygems_version = %q{1.3.2}
+  s.summary = %q{Fusionary Rails View Helpers}
+  s.test_files = ["test/date_helper_test.rb", "test/form_helper_test.rb", "test/grid_helper_test.rb", "test/jquery_helper_test.rb", "test/link_helper_test.rb", "test/message_helper_test.rb", "test/navigation_helper_test.rb", "test/rjs_helper_test.rb", "test/structure_helper_test.rb", "test/table_helper_test.rb", "test/test_helper.rb"]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<actionview>, [">= 0", "= 2.1.0"])
+      s.add_development_dependency(%q<activesupport>, [">= 0", "= 2.1.0"])
+      s.add_development_dependency(%q<hpricot>, [">= 0", "= 0.8.1"])
+    else
+      s.add_dependency(%q<actionview>, [">= 0", "= 2.1.0"])
+      s.add_dependency(%q<activesupport>, [">= 0", "= 2.1.0"])
+      s.add_dependency(%q<hpricot>, [">= 0", "= 0.8.1"])
+    end
+  else
+    s.add_dependency(%q<actionview>, [">= 0", "= 2.1.0"])
+    s.add_dependency(%q<activesupport>, [">= 0", "= 2.1.0"])
+    s.add_dependency(%q<hpricot>, [">= 0", "= 0.8.1"])
+  end
+end

data/lib/easel_helpers.rb

@@ -0,0 +1,3 @@
+require "hpricot"
+require "easel_helpers/helpers"
+require "easel_helpers/rails_partial_caching"

data/lib/easel_helpers/helpers.rb

@@ -0,0 +1,81 @@
+require "easel_helpers/helpers/date_helper"
+require "easel_helpers/helpers/form_helper"
+require "easel_helpers/helpers/link_helper"
+require "easel_helpers/helpers/structure_helper"
+require "easel_helpers/helpers/table_helper"
+require "easel_helpers/helpers/grid_helper"
+require "easel_helpers/helpers/message_helper"
+require "easel_helpers/helpers/rjs_helper"
+require "easel_helpers/helpers/jquery_helper"
+require "easel_helpers/helpers/navigation_helper"
+
+module EaselHelpers
+  module Helpers
+    include DateHelper
+    include FormHelper
+    include LinkHelper
+    include StructureHelper
+    include TableHelper
+    include GridHelper
+    include MessageHelper
+    include RjsHelper
+    include JqueryHelper
+    include NavigationHelper
+
+    protected
+
+    def other_than_grid?(classes)
+      (standardize_css_classes(classes).map {|s| s.to_s } -
+       EaselHelpers::Helpers::GridHelper::MULTIPLE_FRACTIONS).any?
+    end
+
+    def clean_css_classes(string_or_array, replace = {})
+      css_classes = [] + standardize_css_classes(string_or_array)
+
+      if replace.any?
+        replace.keys.each do |k|
+          if css_classes.include? k
+            css_classes.delete(k)
+            css_classes << replace[k]
+          end
+        end
+      end
+
+      fractions = css_classes & EaselHelpers::Helpers::GridHelper::MULTIPLE_FRACTIONS
+      if css_classes.any? && fractions.any?
+        fractions.each do |fraction|
+          css_classes.delete(fraction)
+          css_classes << self.send(fraction)
+          if fraction == "full" && @_easel_column_count != application_width
+            css_classes << last_column
+          end
+        end
+      end
+
+      css_classes.map {|s| s.strip }.reject {|s| s.blank? }.uniq.join(" ").strip
+    end
+
+    private
+
+    def standardize_css_classes(string_or_array)
+      [string_or_array].flatten.join(" ").split(/ /)
+    end
+
+    BLOCK_CALLED_FROM_ERB = 'defined? __in_erb_template'
+
+    if RUBY_VERSION < '1.9.0'
+      # Check whether we're called from an erb template.
+      # We'd return a string in any other case, but erb <%= ... %>
+      # can't take an <% end %> later on, so we have to use <% ... %>
+      # and implicitly concat.
+      def block_is_within_action_view?(block)
+        block && eval(BLOCK_CALLED_FROM_ERB, block)
+      end
+    else
+      def block_is_within_action_view?(block)
+        block && eval(BLOCK_CALLED_FROM_ERB, block.binding)
+      end
+    end
+
+  end
+end

data/lib/easel_helpers/helpers/date_helper.rb

@@ -0,0 +1,15 @@
+module EaselHelpers
+  module Helpers
+    module DateHelper
+
+      def datetime(dt = nil, default_text = "", format_string = :long)
+        dt ? dt.to_time.to_s(format_string) : default_text
+      end
+
+      def date(dt = nil, default_text = "", format_string = :long)
+        dt ? dt.to_date.to_s(format_string) : default_text
+      end
+
+    end
+  end
+end

data/lib/easel_helpers/helpers/form_helper.rb

@@ -0,0 +1,68 @@
+module EaselHelpers
+  module Helpers
+    module FormHelper
+
+      def submit_button(value, *args)
+        options = args.extract_options!
+        css_classes = ["btn"] << options.delete(:class) << args
+        css_classes = clean_css_classes(css_classes, {"last" => last_column})
+
+        content_tag :button,
+                    "<span>#{value}</span>",
+                    { :value => value,
+                      :type => "submit",
+                      :class => css_classes
+                    }.merge(options)
+      end
+
+      def set(*args, &block)
+        options = args.extract_options!
+        css_classes = [] << options.delete(:class) << args
+
+        if !other_than_grid?(args.map(&:to_s) - ["error", "last", last_column.to_s])
+          css_classes << "text"
+        end
+
+        if standardize_css_classes(css_classes).include?("textarea")
+          css_classes << "text"
+        end
+
+        css_classes = clean_css_classes(css_classes, {"last" => last_column})
+
+        html = clean_column(css_classes) do
+          content_tag :div,
+                      capture(&block),
+                      options.merge(:class => css_classes)
+        end
+
+        concat(html)
+      end
+
+      def fieldset(*args, &block)
+        options = args.extract_options!
+        css_classes = [] << options.delete(:class) << args
+        title = args.shift if args.first.is_a?(String)
+        legend = if title.blank?
+          ""
+        else
+          legend_opts = options.delete(:legend) || {}
+          legend_classes = clean_css_classes([legend_opts.delete(:class)] << "legend")
+          content_tag :h3,
+                      title,
+                      {:class => legend_classes}.merge(legend_opts)
+        end
+
+        css_classes = clean_css_classes(css_classes, {"last" => last_column})
+
+        html = clean_column(css_classes) do
+          content_tag :fieldset,
+                      legend + capture(&block),
+                      options.merge(:class => css_classes)
+        end
+
+        concat(html)
+      end
+
+    end
+  end
+end

data/lib/easel_helpers/helpers/grid_helper.rb

@@ -0,0 +1,178 @@
+module EaselHelpers
+  module Helpers
+    module GridHelper
+      MULTIPLES = {
+        :one_twentyfourth =>          (1/24.to_f),
+        :one_twelfth =>               (1/12.to_f),
+        :one_eigth =>                 (1/8.to_f),
+        :one_sixth =>                 (1/6.to_f),
+        :five_twentyfourths =>        (5/24.to_f),
+        :one_fourth =>                (1/4.to_f),
+        :seven_twentyfourths =>       (7/24.to_f),
+        :one_third =>                 (1/3.to_f),
+        :three_eigths =>              (3/8.to_f),
+        :five_twelfths =>             (5/12.to_f),
+        :eleven_twentyfourths =>      (11/24.to_f),
+        :one_half =>                  (1/2.to_f),
+        :half =>                      (1/2.to_f),
+        :thirteen_twentyfourths =>    (13/24.to_f),
+        :seven_twelfths =>            (7/12.to_f),
+        :five_eigths =>               (5/8.to_f),
+        :two_thirds =>                (2/3.to_f),
+        :seventeen_twentyfourths =>   (17/24.to_f),
+        :three_fourths =>             (3/4.to_f),
+        :nineteen_twentyfourths =>    (19/24.to_f),
+        :five_sixths =>               (5/6.to_f),
+        :seven_eigths =>              (7/8.to_f),
+        :eleven_twelfths =>           (11/12.to_f),
+        :twentythree_twentyfourths => (23/24.to_f),
+        :full =>                      (1.to_f)
+      }.freeze
+      MULTIPLE_FRACTIONS = MULTIPLES.keys.map {|key| key.to_s }.freeze
+
+      def self.easel_grid!
+        @@last_column = "col-last"
+        @@column_prefix = "col"
+      end
+
+      def self.blueprint_grid!
+        @@last_column = "last"
+        @@column_prefix = "span"
+      end
+
+      easel_grid!
+
+      def last_column
+        @@last_column
+      end
+
+      def column(*args, &block)
+        @_easel_column_count ||= application_width
+        col(*args, &block)
+      end
+
+      def container(size=nil, *args, &block)
+        opts = args.extract_options!
+        opts.merge!(:suppress_col => true) if size.nil?
+        args = args.insert(0, :container)
+        column(size, *([args, opts].flatten), &block)
+      end
+
+      def clean_column(classes, &block)
+        size = classes.scan(/#{column_prefix}-(\d+)/).flatten.last
+
+        if size.nil?
+          html = capture(&block)
+          if block_given? && block_is_within_action_view?(block)
+            concat(html)
+          else
+            html
+          end
+        else
+          size = size.to_i
+          increase_depth(size)
+          html = capture(&block)
+
+          if block_given? && block_is_within_action_view?(block)
+            concat(html)
+            decrease_depth(size)
+          else
+            decrease_depth(size)
+            html
+          end
+        end
+      end
+
+      def method_missing_with_easel_widths(call, *args)
+        # filter out any initial helper calls
+        found = false
+        MULTIPLE_FRACTIONS.each do |fraction|
+          found = true and break if call.to_s.include?(fraction)
+        end
+
+        method_missing_without_easel_widths(call, *args) and return unless found
+
+        # one of the widths is somewhere in the helper call; let's find it
+        call.to_s =~ /^((append|prepend|#{column_prefix})_)?(.+)$/
+        class_name = $2 || column_prefix
+        class_width = $3
+
+        if MULTIPLES.keys.include?(class_width.to_sym)
+          width = @_easel_column_count || application_width
+          "#{class_name}-#{(width*MULTIPLES[class_width.to_sym]).to_i}"
+        else
+          method_missing_without_easel_widths(call, *args)
+        end
+      end
+
+      alias_method_chain :method_missing, :easel_widths
+
+      private
+
+      def application_width; 24; end
+
+      def increase_depth(size)
+        @_easel_current_width ||= [application_width.to_s]
+
+        if @_easel_column_count.present?
+          @_easel_current_width.push(@_easel_column_count.to_s)
+        end
+
+        @_easel_column_count = if size.to_s =~ /^\d+$/
+          size.to_s.to_i
+        else
+          (@_easel_column_count*MULTIPLES[size]).to_i
+        end
+      end
+
+      def decrease_depth(size)
+        @_easel_column_count = if size.is_a?(Integer)
+          @_easel_current_width.last.to_i
+        else
+          (@_easel_column_count/MULTIPLES[size]).to_i
+        end
+
+        @_easel_current_width.pop
+      end
+
+      def col(*args, &block)
+        fractional_width = MULTIPLE_FRACTIONS.include?(args.first.to_s)
+        explicit_column_width = args.first.is_a?(Integer)
+        size = (fractional_width || explicit_column_width) ? args.shift : :full
+
+        increase_depth(size)
+        output_tag = generate_output_tag(size, *args, &block)
+
+        if block_given? && block_is_within_action_view?(block)
+          concat(output_tag)
+          decrease_depth(size)
+        else
+          decrease_depth(size)
+          output_tag
+        end
+      end
+
+      def generate_output_tag(size, *args, &block)
+        options = args.extract_options!
+
+        css_classes = [] << options.delete(:class) << args
+        unless options.delete(:suppress_col)
+          css_classes << "#{column_prefix}-#{@_easel_column_count}"
+        end
+
+        if (size.to_sym rescue nil) == :full && @_easel_column_count != application_width
+          css_classes << last_column
+        end
+
+        css_classes = clean_css_classes(css_classes, {"last" => last_column})
+        content_tag(options.delete(:tag) || :div,
+                    capture(&block),
+                    {:class => css_classes}.merge(options))
+      end
+
+      def column_prefix
+        @@column_prefix
+      end
+    end
+  end
+end