deas-erbtags 0.1.0

data/.gitignore

@@ -0,0 +1,19 @@
+*.gem
+*.log
+*.rbc
+.rbx/
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/Gemfile

@@ -0,0 +1,6 @@
+source "https://rubygems.org"
+
+gemspec
+
+gem 'rake'
+gem 'pry'

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013-Present Kelly Redding and Collin Redding
+
+MIT License
+
+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,72 @@
+# Deas::ErbTags
+
+Template helpers for creating html tags using Erb (or Erubis, etc).
+
+## Usage
+
+```ruby
+require 'deas-erbtags'
+
+class MyDeasServer
+  include Deas::Server
+
+  # ...
+
+  template_helpers(Deas::ErbTags) # include them all
+
+  # OR just include some...
+
+  template_helpers(Deas::ErbTags::LinkTo)
+  template_helpers(Deas::ErbTags::ImageTag)
+
+  # ...
+
+end
+```
+
+## Tags
+
+All helpers are based off of the basic `tag` helper:
+
+```ruby
+tag(:br)                             # => <br />
+tag(:h1, 'shizam', :title => "boom") # => <h1 title="boom">shizam</h1>
+```
+
+### LinkTo
+
+TODO
+
+### MailTo
+
+TODO
+
+### ImageTag
+
+TODO
+
+### FormTags
+
+TODO
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'deas-erbtags'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install deas-erbtags
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Added some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/deas-tags.gemspec

@@ -0,0 +1,22 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "deas-erbtags/version"
+
+Gem::Specification.new do |gem|
+  gem.name        = "deas-erbtags"
+  gem.version     = Deas::ErbTags::VERSION
+  gem.authors     = ["Kelly Redding", "Collin Redding"]
+  gem.email       = ["kelly@kellyredding.com", "collin.redding@me.com"]
+  gem.description = %q{Deas template helpers for creating HTML tags using Erb.}
+  gem.summary     = %q{Deas template helpers for creating HTML tags using Erb.}
+  gem.homepage    = "http://github.com/redding/deas-erbtags"
+
+  gem.files         = `git ls-files`.split($/)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ["lib"]
+
+  gem.add_development_dependency("assert")
+
+end

data/lib/deas-erbtags/tag.rb

@@ -0,0 +1,17 @@
+require 'deas-erbtags/utils'
+
+module Deas::ErbTags
+  module Tag
+
+    def tag(name, *args)
+      opts, content = [
+        args.last.kind_of?(::Hash) ? args.pop : {},
+        args.first
+      ]
+      attrs = U.html_attrs(opts)
+
+      "<#{name}#{attrs}#{content ? ">#{content}</#{name}" : ' /'}>"
+    end
+
+  end
+end

data/lib/deas-erbtags/utils.rb

@@ -0,0 +1,37 @@
+module Deas; end
+module Deas::ErbTags
+
+  module Utils
+
+    def self.html_attrs(attrs="", ns=nil)
+      return attrs.to_s if !attrs.kind_of?(::Hash)
+
+      attrs.collect do |k_v|
+        [ns ? "#{ns}_#{k_v.first}" : k_v.first.to_s, k_v.last]
+      end.sort.collect do |k_v|
+        if k_v.last.kind_of?(::Hash)
+          html_attrs(k_v.last, k_v.first)
+        elsif k_v.last.kind_of?(::Array)
+          " #{k_v.first}=\"#{escape_attr_value(k_v.last.join(' '))}\""
+        else
+          " #{k_v.first}=\"#{escape_attr_value(k_v.last)}\""
+        end
+      end.join
+    end
+
+    ESCAPE_ATTRS = {
+      "&" => "&",
+      "<" => "&lt;",
+      '"' => "&quot;"
+    }
+    ESCAPE_ATTRS_PATTERN = Regexp.union(*ESCAPE_ATTRS.keys)
+    def self.escape_attr_value(value)
+      value.to_s.gsub(ESCAPE_ATTRS_PATTERN){|c| ESCAPE_ATTRS[c] }
+    end
+
+  end
+
+  # alias for brevity
+  U = Utils
+
+end

data/lib/deas-erbtags/version.rb

@@ -0,0 +1,4 @@
+module Deas; end
+module Deas::ErbTags
+  VERSION = "0.1.0"
+end

data/lib/deas-erbtags.rb

@@ -0,0 +1,17 @@
+require 'deas-erbtags/version'
+require 'deas-erbtags/utils'
+
+require 'deas-erbtags/tag'
+
+module Deas; end
+module Deas::ErbTags
+
+  # this implements the "include them all" behavior
+
+  def self.included(receiver)
+    receiver.class_eval do
+      include Tag
+    end
+  end
+
+end

data/test/helper.rb

@@ -0,0 +1,10 @@
+# this file is automatically required when you run `assert`
+# put any test helpers here
+
+# add the root dir to the load path
+$LOAD_PATH.unshift(File.expand_path("../..", __FILE__))
+
+# require pry for debugging (`binding.pry`)
+require 'pry'
+
+require 'test/support/factory'

data/test/support/factory.rb

@@ -0,0 +1,17 @@
+require 'deas-erbtags/utils'
+require 'deas-erbtags/tag'
+
+module Factory
+
+  def self.template(*included_modules)
+    template_class = Class.new do
+      include *included_modules
+    end
+    template_class.new
+  end
+
+  def self.html_attrs(opts)
+    Deas::ErbTags::Utils.html_attrs(opts)
+  end
+
+end

data/test/unit/deas-erbtags_tests.rb

@@ -0,0 +1,27 @@
+require 'assert'
+require 'deas-erbtags'
+
+module Deas::ErbTags
+
+  class BaseTests < Assert::Context
+    desc "Deas::ErbTags"
+    setup do
+      @template = Factory.template(Deas::ErbTags)
+    end
+    subject{ @template }
+
+    should have_imeths :tag
+
+    should "include all of the individual modules" do
+      exp_modules = [
+        Tag
+      ]
+
+      exp_modules.each do |m|
+        assert_includes m, subject.class.included_modules
+      end
+    end
+
+  end
+
+end

data/test/unit/tag_tests.rb

@@ -0,0 +1,38 @@
+require 'assert'
+require 'deas-erbtags/tag'
+
+module Deas::ErbTags::Tag
+
+  class BaseTests < Assert::Context
+    desc "the basic tag method"
+    setup do
+      @opts = { :class => 'big', :id => '1234' }
+      @content = "Loud Noises"
+      @opts_attrs = Factory.html_attrs(@opts)
+      @template = Factory.template(Deas::ErbTags::Tag)
+    end
+    subject{ @template }
+
+    should have_imeth :tag
+
+    should "create an empty html tag" do
+      assert_equal "<br />", @template.tag(:br)
+    end
+
+    should "create an html tag with attributes" do
+      assert_equal "<br#{@opts_attrs} />", @template.tag(:br, @opts)
+    end
+
+    should "create an html tag with content" do
+      exp_markup = "<h1>#{@content}</h1>"
+      assert_equal exp_markup, @template.tag(:h1, @content)
+    end
+
+    should "create an html tag with attributes and content" do
+      exp_markup = "<h1#{@opts_attrs}>#{@content}</h1>"
+      assert_equal exp_markup, @template.tag(:h1, @content, @opts)
+    end
+
+  end
+
+end

data/test/unit/utils_tests.rb

@@ -0,0 +1,76 @@
+require "assert"
+require 'deas-erbtags/utils'
+
+module Deas::ErbTags::Utils
+
+  class BaseTests < Assert::Context
+    desc 'Deas::ErbTags::Helpers'
+    subject { Deas::ErbTags::Utils }
+
+    should have_imeths :html_attrs, :escape_attr_value
+
+    should "alias itself as `Deas::ErbTags::U`" do
+      assert_same Deas::ErbTags::Utils, Deas::ErbTags::U
+    end
+
+  end
+
+  class HashAttrsTests < BaseTests
+    desc "the element class hash_attrs util"
+
+    should "convert an empty hash to element attrs" do
+      assert_equal '', subject.html_attrs({})
+    end
+
+    should "convert a basic hash to element attrs" do
+      attrs = subject.html_attrs(:class => "test", :id => "test_1")
+      assert_match /^\s{1}/, attrs
+      assert_includes 'class="test"', attrs
+      assert_includes 'id="test_1"', attrs
+
+      attrs = subject.html_attrs('key' => "string")
+      assert_includes 'key="string"', attrs
+    end
+
+    should "escape double-quotes in attr values" do
+      attrs = subject.html_attrs('escaped' => '"this" is double-quoted')
+      assert_includes 'escaped="&quot;this&quot; is double-quoted"', attrs
+    end
+
+    should "escape '<' in attr values" do
+      attrs = subject.html_attrs('escaped' => 'not < escaped')
+      assert_includes 'escaped="not &lt; escaped"', attrs
+    end
+
+    should "escape '&' in attr values" do
+      attrs = subject.html_attrs('escaped' => 'not & escaped')
+      assert_includes 'escaped="not &amp; escaped"', attrs
+    end
+
+    should "convert a nested array to element attrs" do
+      attrs = subject.html_attrs({
+        :class => "testing",
+        :id => "test_2",
+        :nested => [:something, 'is_awesome', 1]
+      })
+      assert_match /^\s{1}/, attrs
+      assert_included 'class="testing"', attrs
+      assert_included 'id="test_2"', attrs
+      assert_included 'nested="something is_awesome 1"', attrs
+    end
+
+    should "convert a nested hash to element attrs" do
+      attrs = subject.html_attrs({
+        :class => "testing",
+        :id => "test_2",
+        :nested => {:something => 'is_awesome'}
+      })
+      assert_match /^\s{1}/, attrs
+      assert_included 'class="testing"', attrs
+      assert_included 'id="test_2"', attrs
+      assert_included 'nested_something="is_awesome"', attrs
+    end
+
+  end
+
+end

metadata

@@ -0,0 +1,101 @@
+--- !ruby/object:Gem::Specification 
+name: deas-erbtags
+version: !ruby/object:Gem::Version 
+  hash: 27
+  prerelease: 
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- Kelly Redding
+- Collin Redding
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2013-05-16 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: assert
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id001
+description: Deas template helpers for creating HTML tags using Erb.
+email: 
+- kelly@kellyredding.com
+- collin.redding@me.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- deas-tags.gemspec
+- lib/deas-erbtags.rb
+- lib/deas-erbtags/tag.rb
+- lib/deas-erbtags/utils.rb
+- lib/deas-erbtags/version.rb
+- log/.gitkeep
+- test/helper.rb
+- test/support/factory.rb
+- test/unit/deas-erbtags_tests.rb
+- test/unit/tag_tests.rb
+- test/unit/utils_tests.rb
+- tmp/.gitkeep
+homepage: http://github.com/redding/deas-erbtags
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: Deas template helpers for creating HTML tags using Erb.
+test_files: 
+- test/helper.rb
+- test/support/factory.rb
+- test/unit/deas-erbtags_tests.rb
+- test/unit/tag_tests.rb
+- test/unit/utils_tests.rb