youthtree-helpers 0.1.4 → 0.2.0

data/Rakefile

@@ -17,6 +17,7 @@ begin
     gem.version     = YouthTree::Helpers::VERSION
     gem.add_dependency "activesupport",      "~> 3.0.0.rc"
     gem.add_dependency "actionpack",         "~> 3.0.0.rc"
+    gem.add_dependency "formtastic",         "~> 1.2"
     gem.add_dependency "youthtree-js"
     gem.add_dependency "youthtree-settings"
   end

data/lib/youth_tree/helpers.rb

@@ -2,7 +2,7 @@ require 'active_support/concern'
 
 module YouthTree
   module Helpers
-    VERSION = "0.1.4".freeze
+    VERSION = "0.2.0".freeze
     
     extend ActiveSupport::Autoload
     
@@ -12,6 +12,7 @@ module YouthTree
     autoload :EmbedHelper
     autoload :SidebarHelper
     autoload :UuidTrackerHelper
+    autoload :FormBuilder
     
     def self.install!
       ActionView::Base.class_eval do
@@ -22,6 +23,7 @@ module YouthTree
         include SidebarHelper
         include UuidTrackerHelper
       end
+      FormBuilder.install!
     end
     
     if defined?(Rails::Railtie)
@@ -29,6 +31,11 @@ module YouthTree
         initializer "youthtree-helpers.setup-helpers" do
           YouthTree::Helpers.install!
         end
+        
+        initializer "youthtree-helpers.setup-i18n" do
+          config.i18n.load_path += Dir[Pathname(__FILE__).dirname.join("locales", "**", "*.{yml,rb}")]
+        end
+        
       end
     end
     

data/lib/youth_tree/helpers/form_builder.rb

@@ -0,0 +1,111 @@
+module YouthTree
+  module Helpers
+    class FormBuilder < Formtastic::SemanticFormBuilder
+      
+      def self.install!
+        Formtastic::SemanticFormHelper.builder   = self
+        self.include_blank_for_select_by_default = true
+        self.i18n_lookups_by_default             = true
+        self.required_string                     = proc { ::Formtastic::I18n.t(:required).html_safe }
+        self.optional_string                     = proc { ::Formtastic::I18n.t(:optional).html_safe }
+      end
+      
+      def submit(value = "Save changes", options = {})
+        @template.content_tag(:button, value, options.reverse_merge(:type => "submit", :id => "#{object_name}_submit"))
+      end
+
+      # Generates a label, using a safe buffer and a few other things along those lines.
+      def label(*args)
+        super(*args).gsub(/\?\s*\:\<\/label\>/, "?</label>").gsub(/\?\s*\:\s*\<abbr/, "? <abbr")
+      end
+
+      def boolean_input(method, options)
+        super.gsub(":</label>", "</label>").gsub(": <abbr", " <abbr")
+      end
+
+      def dob_input(*args)
+        options = args.extract_options!
+        options.merge!(:start_year => (Time.now.year - 100), :end_year => Time.now.year, :selected => nil)
+        args << options
+        date_input(*args)
+      end
+
+      def commit_button_with_cancel(*args)
+        options = args.extract_options!
+        text = options.delete(:label) || args.shift
+        cancel_options = options.delete(:cancel)
+
+        if @object && @object.respond_to?(:new_record?)
+          key = @object.new_record? ? :create : :update
+
+          # Deal with some complications with ActiveRecord::Base.human_name and two name models (eg UserPost)
+          # ActiveRecord::Base.human_name falls back to ActiveRecord::Base.name.humanize ("Userpost")
+          # if there's no i18n, which is pretty crappy.  In this circumstance we want to detect this
+          # fall back (human_name == name.humanize) and do our own thing name.underscore.humanize ("User Post")
+          if @object.class.model_name.respond_to?(:human)
+            object_name = @object.class.model_name.human
+          else
+            object_human_name = @object.class.human_name                # default is UserPost => "Userpost", but i18n may do better ("User post")
+            crappy_human_name = @object.class.name.humanize             # UserPost => "Userpost"
+            decent_human_name = @object.class.name.underscore.humanize  # UserPost => "User post"
+            object_name = (object_human_name == crappy_human_name) ? decent_human_name : object_human_name
+          end
+        else
+          key = :submit
+          object_name = @object_name.to_s.send(self.class.label_str_method)
+        end
+
+        text = (self.localized_string(key, text, :action, :model => object_name) ||
+                ::Formtastic::I18n.t(key, :model => object_name)) unless text.is_a?(::String)
+
+        button_html = options.delete(:button_html) || {}
+        button_html.merge!(:class => [button_html[:class], key].compact.join(' '))
+        element_class = ['commit', options.delete(:class)].compact.join(' ') # TODO: Add class reflecting on form action.
+        accesskey = (options.delete(:accesskey) || self.class.default_commit_button_accesskey) unless button_html.has_key?(:accesskey)
+        button_html = button_html.merge(:accesskey => accesskey) if accesskey
+        inner = Formtastic::Util.html_safe(self.submit(text, button_html))
+        # Start custom code
+        if cancel_options.present?
+          inner << template.content_tag(:span, "or", :class => "or")
+          inner << @template.link_to(cancel_options.delete(:text), cancel_options.delete(:url), cancel_options)
+        end
+        # End custom code
+        template.content_tag(:li, inner, :class => element_class)
+      end
+
+      # Returns errors converted to a sentence, adding a full stop.
+      def error_sentence(errors, options = {})
+        error_class = options[:error_class] || self.class.default_inline_error_class
+        error_text = errors.to_sentence.untaint.strip
+        error_text << "." unless %w(? ! . :).include?(error_text[-1, 1])
+        template.content_tag(:p, Formtastic::Util.html_safe(error_text), :class => error_class)
+      end
+
+      def datetime_picker_input(method, options = {})
+        format = (options[:format] || Time::DATE_FORMATS[:default] || '%d %B %Y %I:%M %p')
+        string_input(method, datetime_picker_options(format, object.send(method)).merge(options))
+      end
+    
+      def date_picker_input(method, options = {})
+        format = (options[:format] || Time::DATE_FORMATS[:default] || '%d %B %Y')
+        string_input(method, date_picker_options(format, object.send(method)).merge(options))
+      end
+
+      protected
+
+      def datetime_picker_options(format, value = nil)
+        input_options   = {:class => 'ui-datetime-picker',:value => value.try(:strftime, format)}
+        wrapper_options = {:class => 'datetime-picker'}
+        return :wrapper_html => wrapper_options, :input_html => input_options
+      end
+      
+      def date_picker_options(format, value = nil)
+        input_options   = {:class => 'ui-date-picker',:value => value.try(:strftime, format)}
+        wrapper_options = {:class => 'date-picker'}
+        return :wrapper_html => wrapper_options, :input_html => input_options
+      end
+      
+      
+    end
+  end
+end

data/lib/youth_tree/locales/formtastic.en.yml

@@ -0,0 +1,9 @@
+en:
+  formtastic:
+    :yes: 'Yes'
+    :no: 'No'
+    create: 'Create'
+    save: 'Save'
+    submit: 'Submit'
+    required: ": <abbr class='required' title='This field is required'>(required)</abbr>"
+    optional: ":"

data/youthtree-helpers.gemspec

@@ -5,35 +5,35 @@
 
 Gem::Specification.new do |s|
   s.name = %q{youthtree-helpers}
-  s.version = "0.1.4"
+  s.version = "0.2.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Darcy Laycock"]
-  s.date = %q{2010-08-25}
+  s.date = %q{2010-12-12}
   s.description = %q{Helpers to make life easier when coding YT-specific apps. see the code..}
   s.email = %q{sutto@sutto.net}
   s.extra_rdoc_files = [
     "LICENSE",
-     "README.md"
+    "README.md"
   ]
   s.files = [
     ".document",
-     ".gitignore",
-     "LICENSE",
-     "README.md",
-     "Rakefile",
-     "lib/youth_tree/helpers.rb",
-     "lib/youth_tree/helpers/analytics_helper.rb",
-     "lib/youth_tree/helpers/assets_helper.rb",
-     "lib/youth_tree/helpers/embed_helper.rb",
-     "lib/youth_tree/helpers/general_helper.rb",
-     "lib/youth_tree/helpers/sidebar_helper.rb",
-     "lib/youth_tree/helpers/uuid_tracker_helper.rb",
-     "lib/youthtree-helpers.rb",
-     "youthtree-helpers.gemspec"
+    "LICENSE",
+    "README.md",
+    "Rakefile",
+    "lib/youth_tree/helpers.rb",
+    "lib/youth_tree/helpers/analytics_helper.rb",
+    "lib/youth_tree/helpers/assets_helper.rb",
+    "lib/youth_tree/helpers/embed_helper.rb",
+    "lib/youth_tree/helpers/form_builder.rb",
+    "lib/youth_tree/helpers/general_helper.rb",
+    "lib/youth_tree/helpers/sidebar_helper.rb",
+    "lib/youth_tree/helpers/uuid_tracker_helper.rb",
+    "lib/youth_tree/locales/formtastic.en.yml",
+    "lib/youthtree-helpers.rb",
+    "youthtree-helpers.gemspec"
   ]
   s.homepage = %q{http://github.com/YouthTree/youthtree-helpers}
-  s.rdoc_options = ["--charset=UTF-8"]
   s.require_paths = ["lib"]
   s.rubygems_version = %q{1.3.7}
   s.summary = %q{A exceedingly simple set of helpers used across Youth Tree web applications.}
@@ -45,17 +45,20 @@ Gem::Specification.new do |s|
     if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
       s.add_runtime_dependency(%q<activesupport>, ["~> 3.0.0.rc"])
       s.add_runtime_dependency(%q<actionpack>, ["~> 3.0.0.rc"])
+      s.add_runtime_dependency(%q<formtastic>, ["~> 1.2"])
       s.add_runtime_dependency(%q<youthtree-js>, [">= 0"])
       s.add_runtime_dependency(%q<youthtree-settings>, [">= 0"])
     else
       s.add_dependency(%q<activesupport>, ["~> 3.0.0.rc"])
       s.add_dependency(%q<actionpack>, ["~> 3.0.0.rc"])
+      s.add_dependency(%q<formtastic>, ["~> 1.2"])
       s.add_dependency(%q<youthtree-js>, [">= 0"])
       s.add_dependency(%q<youthtree-settings>, [">= 0"])
     end
   else
     s.add_dependency(%q<activesupport>, ["~> 3.0.0.rc"])
     s.add_dependency(%q<actionpack>, ["~> 3.0.0.rc"])
+    s.add_dependency(%q<formtastic>, ["~> 1.2"])
     s.add_dependency(%q<youthtree-js>, [">= 0"])
     s.add_dependency(%q<youthtree-settings>, [">= 0"])
   end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: youthtree-helpers
 version: !ruby/object:Gem::Version 
-  hash: 19
+  hash: 23
   prerelease: false
   segments: 
   - 0
-  - 1
-  - 4
-  version: 0.1.4
+  - 2
+  - 0
+  version: 0.2.0
 platform: ruby
 authors: 
 - Darcy Laycock
@@ -15,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-08-25 00:00:00 +08:00
+date: 2010-12-12 00:00:00 +08:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -53,9 +53,24 @@ dependencies:
   type: :runtime
   version_requirements: *id002
 - !ruby/object:Gem::Dependency 
-  name: youthtree-js
+  name: formtastic
   prerelease: false
   requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 11
+        segments: 
+        - 1
+        - 2
+        version: "1.2"
+  type: :runtime
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: youthtree-js
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ">="
@@ -65,11 +80,11 @@ dependencies:
         - 0
         version: "0"
   type: :runtime
-  version_requirements: *id003
+  version_requirements: *id004
 - !ruby/object:Gem::Dependency 
   name: youthtree-settings
   prerelease: false
-  requirement: &id004 !ruby/object:Gem::Requirement 
+  requirement: &id005 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ">="
@@ -79,7 +94,7 @@ dependencies:
         - 0
         version: "0"
   type: :runtime
-  version_requirements: *id004
+  version_requirements: *id005
 description: Helpers to make life easier when coding YT-specific apps. see the code..
 email: sutto@sutto.net
 executables: []
@@ -91,7 +106,6 @@ extra_rdoc_files:
 - README.md
 files: 
 - .document
-- .gitignore
 - LICENSE
 - README.md
 - Rakefile
@@ -99,9 +113,11 @@ files:
 - lib/youth_tree/helpers/analytics_helper.rb
 - lib/youth_tree/helpers/assets_helper.rb
 - lib/youth_tree/helpers/embed_helper.rb
+- lib/youth_tree/helpers/form_builder.rb
 - lib/youth_tree/helpers/general_helper.rb
 - lib/youth_tree/helpers/sidebar_helper.rb
 - lib/youth_tree/helpers/uuid_tracker_helper.rb
+- lib/youth_tree/locales/formtastic.en.yml
 - lib/youthtree-helpers.rb
 - youthtree-helpers.gemspec
 has_rdoc: true
@@ -109,8 +125,8 @@ homepage: http://github.com/YouthTree/youthtree-helpers
 licenses: []
 
 post_install_message: 
-rdoc_options: 
-- --charset=UTF-8
+rdoc_options: []
+
 require_paths: 
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement 

data/.gitignore

@@ -1,21 +0,0 @@
-## MAC OS
-.DS_Store
-
-## TEXTMATE
-*.tmproj
-tmtags
-
-## EMACS
-*~
-\#*
-.\#*
-
-## VIM
-*.swp
-
-## PROJECT::GENERAL
-coverage
-rdoc
-pkg
-
-## PROJECT::SPECIFIC