herbie 0.0.1

data/lib/herbie.rb

@@ -0,0 +1,7 @@
+require 'herbie/erb_helpers.rb'
+require 'herbie/generic_helpers.rb'
+require 'herbie/html_helpers.rb'
+
+module Herbie
+  VERSION = '0.0.1'
+end

data/lib/herbie/erb_helpers.rb

@@ -0,0 +1,21 @@
+module Herbie
+  module Helpers
+    
+    def erb_with_output_buffer(buf = '')
+      @_out_buf, old_buffer = buf, @_out_buf
+      yield
+      @_out_buf
+    ensure
+      @_out_buf = old_buffer
+    end
+
+    def capture_erb(*args, &block)
+      erb_with_output_buffer { block_given? && block.call(*args) }
+    end
+
+    def erb_concat(text)
+      @_out_buf << text if !@_out_buf.nil?
+    end
+    
+  end
+end

data/lib/herbie/generic_helpers.rb

@@ -0,0 +1,25 @@
+module Herbie
+  module Helpers
+    
+    def snake_case(string)
+      return string.downcase if string =~ /^[A-Z]+$/
+      string.gsub(/([A-Z]+)(?=[A-Z][a-z]?)|\B[A-Z]/, '_\&') =~ /_*(.*)/
+      return $+.downcase
+    end
+
+    def attributes(hash)
+      a = []
+      hash.each_pair do |k,v|
+        unless v.nil?
+          if v === true
+            a.push "#{snake_case(k.to_s).sub(/^(.{1,1})/) { |m| m.downcase }}"
+          else
+            a.push "#{snake_case(k.to_s).sub(/^(.{1,1})/) { |m| m.downcase }}=\"#{v}\""
+          end
+        end
+      end
+      a.join(' ')
+    end 
+
+  end
+end

data/lib/herbie/html_helpers.rb

@@ -0,0 +1,55 @@
+module Herbie
+  module Helpers
+    def tag(name, attrs={}, &block)
+      if block_given?
+        erb_concat "<#{name}#{' ' + attributes(attrs) unless attrs.nil? || attrs.empty?}>#{capture_erb(&block)}</#{name}>"
+      elsif !attrs[:content].nil?
+        content = attrs.delete :content
+        "<#{name}#{' ' + attributes(attrs) unless attrs.nil? || attrs.empty?}>#{content}</#{name}>"
+      else
+        "<#{name}#{' ' + attributes(attrs) unless attrs.nil? || attrs.empty?}>"
+      end
+    end
+  
+    def script(source=nil, &block)
+      attrs = {
+        :type    => "text/javascript",
+        :charset => "utf-8"
+      }
+      
+      if block_given?
+        erb_concat "#{tag :script, attrs}\n#{capture_erb(&block)}\n</script>"
+      else
+        source = "/javascripts/#{source}" unless source.nil? || source.match(/^\//)
+        attrs = attrs.merge({:src => source})
+        "#{tag :script, attrs}</script>"
+      end
+    end
+    
+    def style(href=nil, attrs={}, &block)
+      default_attrs = {
+        :rel  => "stylesheet",
+        :type => "text/css"
+      }
+      
+      if block_given?
+        default_attrs.delete :rel
+        erb_concat "#{tag :style, default_attrs.merge(attrs)}\n#{capture_erb(&block)}\n</style>"
+      else
+        href = "/stylesheets/#{href}" unless href.match(/^\//)
+        attrs = default_attrs.merge({:href => href}.merge(attrs))
+        "#{tag :link, attrs}"        
+      end
+    end
+    
+    def link(href, text=nil, attrs={}, &block)
+      attrs = {:href => href}.merge(attrs)
+      if block_given?
+        erb_concat "#{tag :a, attrs}#{capture_erb(&block)}</a>"
+      else
+        "#{tag :a, attrs}#{text ||= attrs[:href]}</a>"
+      end
+    end
+    
+  end
+end

data/spec/herbie_spec.rb

@@ -0,0 +1,111 @@
+# encoding: utf-8
+require_relative "../lib/herbie.rb"
+
+describe Herbie::Helpers do
+  include Herbie::Helpers
+  
+  it "should be able to output a simple tag" do
+    attrs = {
+      :src    => "/path/to/image.jpg",
+      :height => 320,
+      :width  => 640,
+      :alt    => "An image of something"
+    }
+    
+    tag(:img, attrs).should == "<img src=\"#{attrs[:src]}\" height=\"#{attrs[:height]}\" width=\"#{attrs[:width]}\" alt=\"#{attrs[:alt]}\">"
+  end
+  
+  it "should not output attributes whose values are nil" do
+    attrs = {
+      :type    => "checkbox",
+      :name    => "stay_logged_in",
+      :value   => "true",
+      :checked => nil
+    }
+    
+    tag(:input, attrs).should == "<input type=\"#{attrs[:type]}\" name=\"#{attrs[:name]}\" value=\"#{attrs[:value]}\">"
+  end
+  
+  it "should output just the property name for attributes with a boolean value of true" do
+    attrs = {
+      :type    => "checkbox",
+      :name    => "stay_logged_in",
+      :value   => "true",
+      :checked => true
+    }
+    
+    tag(:input, attrs).should == "<input type=\"#{attrs[:type]}\" name=\"#{attrs[:name]}\" value=\"#{attrs[:value]}\" checked>"
+  end
+  
+  describe "script helpers" do
+    it "should prefix the path to the script with ‘/javascripts’ if the script path is relative" do
+      script("script.js").should == "<script type=\"text/javascript\" charset=\"utf-8\" src=\"/javascripts/script.js\"></script>"
+    end
+    
+    it "should output a script with an absolute path to the script if the path provided was absolute" do
+      script("/path/to/script.js").should == "<script type=\"text/javascript\" charset=\"utf-8\" src=\"/path/to/script.js\"></script>"
+    end
+    
+    it "should output a script element with arbitrary javascript content provided by a block" do
+      pending "Need a mechanism for capturing erb output within a passed block"
+      script_block = Proc.new { "function hello_world(){ console.log(\"hello world!\"); }" }
+      script(&script_block).should == "<script type=\"text/javascript\" charset=\"utf-8\">\n#{capture_erb(&script_block)}\n</script>"
+    end
+  end
+  
+  describe "stylesheet helpers" do
+    it "should prefix the path to the script with ‘/stylesheets’ if the stylesheet path is relative" do
+      style("foo.css").should == "<link rel=\"stylesheet\" type=\"text/css\" href=\"/stylesheets/foo.css\">"
+    end
+    
+    it "should output a link element with the absolute path to the stylesheet if the path provided was absolute" do
+      style("/style/foo.css").should == "<link rel=\"stylesheet\" type=\"text/css\" href=\"/style/foo.css\">"
+    end
+    
+    it "should output a link element with appropriate media query attribute if provided" do
+      media = "screen and (min-width:500px)"
+      style("/style/foo.css", :media => media).should == "<link rel=\"stylesheet\" type=\"text/css\" href=\"/style/foo.css\" media=\"#{media}\">"
+    end
+    
+    it "should output a style element with arbitrary content provided by a block" do
+      pending "Need a mechanism for capturing erb output within a passed block"
+      media     = "screen and (min-width:500px)"
+      css_block = Proc.new { "body { font-family:'Helvetica'; }" }
+      style({:media => media}, &css_block).should == "<script type=\"text/css\" media=\"#{media}\">\n#{capture_erb(&css_block)}\n</script>"
+    end
+  end
+  
+  describe "link helpers" do
+    it "should be able to output a simple link" do
+      href = "http://www.foo.com/"
+      link(href).should == "<a href=\"#{href}\">#{href}</a>"
+    end
+    
+    it "should be able to output a link with href and text" do
+      href = "http://www.foo.com/"
+      text = "Visit foo.com"
+      link(href, text).should == "<a href=\"#{href}\">#{text}</a>"
+    end
+    
+    it "should be able to output links with arbitrary attributes" do
+      href = "http://www.foo.com/"
+      text = "Visit foo.com"
+      attrs = {
+        :class => "navigation",
+        :target => "_parent"
+      }
+      link(href, text, attrs).should == "<a href=\"#{href}\" class=\"#{attrs[:class]}\" target=\"#{attrs[:target]}\">#{text}</a>"
+    end
+    
+    it "should be able to output a link enclosing arbitrary markup provided by a block" do
+      pending "Need a mechanism for capturing erb output within a passed block"
+      href = "http://www.foo.com/"
+      text = "Visit foo.com"
+      attrs = {
+        :class => "image"
+      }
+      markup_block = Proc.new { tag :img, :src => "foo.png" }
+      link(href, text, attrs, &markup_block).should == "<a href=\"#{href}\" class=\"#{attrs[:class]}\">#{capture_erb(&markup_block)}</a>"
+    end
+  end
+end

metadata

@@ -0,0 +1,63 @@
+--- !ruby/object:Gem::Specification
+name: herbie
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Ben Darlow
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2011-09-22 00:00:00.000000000Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &70317520033180 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.6'
+  type: :development
+  prerelease: false
+  version_requirements: *70317520033180
+description: Lovable HTML view helpers for use with ERB.
+email: ben@kapowaz.net
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/herbie/erb_helpers.rb
+- lib/herbie/generic_helpers.rb
+- lib/herbie/html_helpers.rb
+- lib/herbie.rb
+- spec/herbie_spec.rb
+- spec/spec_helper.rb
+homepage: http://github.com/kapowaz/herbie
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: 1.9.2
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.6
+signing_key: 
+specification_version: 3
+summary: herbie
+test_files:
+- spec/herbie_spec.rb
+- spec/spec_helper.rb