rails_view_helpers 0.0.1

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright 2013 YOURNAME
+
+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.md

@@ -0,0 +1,3 @@
+# RailsViewHelpers
+
+[API documentation](http://rubydoc.info/gems/rails_view_helpers/frames/file/README.md)

data/Rakefile

@@ -0,0 +1,29 @@
+#!/usr/bin/env rake
+begin
+  require 'bundler/setup'
+rescue LoadError
+  puts 'You must `gem install bundler` and `bundle install` to run rake tasks'
+end
+begin
+  require 'rdoc/task'
+rescue LoadError
+  require 'rdoc/rdoc'
+  require 'rake/rdoctask'
+  RDoc::Task = Rake::RDocTask
+end
+
+RDoc::Task.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'RailsViewHelpers'
+  rdoc.options << '--line-numbers'
+  rdoc.rdoc_files.include('README.rdoc')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+APP_RAKEFILE = File.expand_path("../spec/dummy/Rakefile", __FILE__)
+load 'rails/tasks/engine.rake'
+
+
+
+Bundler::GemHelper.install_tasks
+

data/app/helpers/rails_view_helpers/common_helper.rb

@@ -0,0 +1,60 @@
+# Utililty methods used by Bootstrap::*Helper classes
+module RailsViewHelpers::CommonHelper
+  ArgumentError = Class.new(::ArgumentError)
+  
+  # Returns a new Hash with:
+  # * keys converted to Symbols
+  # * the +:class+ key has its value converted to an Array of String
+  # @example
+  #   canonicalize_options("id" => "ID", "class" => "CLASS")  # => {:id=>"ID", :class=>["CLASS"]} 
+  #   canonicalize_options(:class => 'one two')               # => {:class=>["one", "two"]}
+  #   canonicalize_options("class" => [:one, 2])              # => {:class=>["one", "2"]} 
+  # @param [Hash] hash typically an +options+ param to a method call
+  # @raise [ArgumentError] if _hash_ is not a Hash
+  # @return [Hash]
+  def canonicalize_options(hash)
+    raise ArgumentError.new("expected a Hash, got #{hash.inspect}") unless hash.is_a?(Hash)
+
+    hash.symbolize_keys.tap do |h|
+      h[:class] = arrayify_and_stringify_elements(h[:class])
+    end
+  end
+
+  # Returns a new Array of String from _arg_.
+  # @example
+  #   arrayify_and_stringify_elements(nil)            #=> [] 
+  #   arrayify_and_stringify_elements('foo')          #=> ["foo"]
+  #   arrayify_and_stringify_elements('foo bar')      #=> ["foo", "bar"]
+  #   arrayify_and_stringify_elements([:foo, 'bar'])  #=> ["foo", "bar"]
+  # @param [String, Array] arg
+  # @return [Array of String]
+  def arrayify_and_stringify_elements(arg)
+    return false if arg == false
+    
+    case
+    when arg.blank? then []
+    when arg.is_a?(Array) then arg
+    else arg.to_s.strip.split(/\s/)
+    end.map(&:to_s)
+  end
+  
+  # Returns new (canonicalized) Hash where :class value includes _klasses_.
+  # 
+  # @example
+  #   ensure_class({class: []}, 'foo')                               #=> {class: 'foo'}
+  #   ensure_class({class: ['bar'], id: 'my-id'}, ['foo', 'foo2'])   #=> {:class=>["bar", "foo", "foo2"], :id=>"my-id"}
+  # @param [Hash] hash
+  # @param [String, Array] klasses one or more classes to add to the +:class+ key of _hash_
+  # @return [Hash]
+  def ensure_class(hash, klasses)
+    canonicalize_options(hash)
+    
+    hash.dup.tap do |h|
+      Array(klasses).map(&:to_s).each do |k|
+        h[:class] << k unless h[:class].include?(k)
+      end
+    end
+  end
+
+
+end

data/app/helpers/rails_view_helpers/html_helper.rb

@@ -0,0 +1,62 @@
+module RailsViewHelpers
+  
+  module HtmlHelper
+
+    # Includes controller and action name as data attributes.
+    #
+    # @example
+    #  body_tag()  #=> <body data-action='index' data-controller='home'>
+    #
+    #  body_tag(id: 'my-id', class: 'my-class')  #=> <body class="my-class" data-action="index" data-controller="home" id="my-id">
+    def body_tag(options={}, &block)
+      options = canonicalize_options(options)
+      options.delete(:class) if options[:class].blank?
+      options[:data] ||= {}
+      options[:data][:controller] = controller.controller_name
+      options[:data][:action] = controller.action_name
+      
+      content_tag(:body, options) do
+        yield
+      end
+    end
+    
+    # Displays a check-mark (&#10004;) when _bln_ is +true+ else +nbsp+.
+    #
+    # @example
+    #  bln(true)                         #=> "&#10004;"  (check mark)
+    #  bln(false)                        #=> "&nbsp;"    (space)
+    #  bln(true, 'Admin')                #=> "Admin"
+    #  bln(false, 'Admin', "not Admin")  #=> "not Admin"
+    # @param bool [Boolean]
+    # @param true_string [String] the string to display if _bln_ is +true+.  Caller is responsible for escaping and/or marking html_safe.
+    # @param false_string [String] the string to display if _bln_ is +false+. Caller is responsible for escaping and/or marking html_safe.
+    def bln(bool, true_string="&#10004;".html_safe, false_string=nbsp)
+      if bool
+        true_string
+      else
+        false_string
+      end
+    end
+    
+    def td_bln(*args)
+      options = canonicalize_options(args.extract_options!)
+      options = ensure_class(options, 'c')
+      
+      content_tag(:td, bln(*args), options)
+    end
+    
+    # Returns one or more non-breaking spaces (&nbsp;) marked +html_safe+.
+    #
+    # @example
+    #   nbsp      #=> "&nbsp;"
+    #   nbsp(3)   #=> "&nbsp;&nbsp;&nbsp;"
+    #
+    # @param count [FixNum] the number of non-breaking spaces to return
+    # @return [String] that is html_safe
+    def nbsp(count=1)
+      ('&nbsp;' * count).html_safe
+    end
+    
+  end
+  
+end

data/config/routes.rb

@@ -0,0 +1,2 @@
+Rails.application.routes.draw do
+end

data/lib/rails_view_helpers/engine.rb

@@ -0,0 +1,6 @@
+module RailsViewHelpers
+  class Engine < ::Rails::Engine
+    config.generators.integration_tool :rspec
+    config.generators.test_framework :rspec
+  end
+end

data/lib/rails_view_helpers/version.rb

@@ -0,0 +1,3 @@
+module RailsViewHelpers
+  VERSION = "0.0.1"
+end

data/lib/rails_view_helpers.rb

@@ -0,0 +1,4 @@
+require "rails_view_helpers/engine"
+
+module RailsViewHelpers
+end

data/lib/tasks/rails_view_helpers_tasks.rake

@@ -0,0 +1,4 @@
+# desc "Explaining what the task does"
+# task :rails_view_helpers do
+#   # Task goes here
+# end

metadata

@@ -0,0 +1,302 @@
+--- !ruby/object:Gem::Specification
+name: rails_view_helpers
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Steve Downey
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-06-14 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 3.2.13
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 3.2.13
+- !ruby/object:Gem::Dependency
+  name: jquery-rails
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec-rails
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: capybara
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: guard-rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: guard-spork
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: coveralls
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: sqlite3
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: haml
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: better_errors
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: binding_of_caller
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: redcarpet
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: quiet_assets
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: thin
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: 
+email:
+- steve.downtown@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- app/helpers/rails_view_helpers/common_helper.rb
+- app/helpers/rails_view_helpers/html_helper.rb
+- config/routes.rb
+- lib/rails_view_helpers/engine.rb
+- lib/rails_view_helpers/version.rb
+- lib/rails_view_helpers.rb
+- lib/tasks/rails_view_helpers_tasks.rake
+- MIT-LICENSE
+- Rakefile
+- README.md
+homepage: https://github.com/stevedowney/rails_view_helpers
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: -3460792648407326703
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: -3460792648407326703
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.25
+signing_key: 
+specification_version: 3
+summary: Convenience methods for Rails views
+test_files: []
+has_rdoc: