iron-web 1.0.0

data/spec/web/color_spec.rb

@@ -0,0 +1,58 @@
+require File.join(File.dirname(__FILE__), '..', 'spec_helper')
+
+SAMPLE_LIBRARY = {
+  :red => '#FF0000',
+  :purplish => '#FF20EE',
+  :orange => '#F0FF00'
+}
+
+describe Color do
+  
+  it 'should default to white' do
+    Color.new.r.should == 255
+    Color.new.g.should == 255
+    Color.new.b.should == 255
+    Color.new.a.should == 255
+  end
+  
+  it 'should convert to string as a web string' do
+    Color.parse(1,2,3).to_s.should == '#010203'
+  end
+  
+  it 'should parse web colors' do
+    Color.new('#f8019c').should == Color.new(248,1,156)
+  end
+
+  it 'should make the global rgb() method available' do
+    defined?(:rgb).should be_true
+  end
+  
+  it 'should parse values with rgb()' do
+    ['#fa8', Color::BLACK].each do |test|
+      rgb(test).should == Color.parse(test)
+    end
+  end
+  
+  it 'should support alpha' do
+    c = rgb('abc')
+    c.a.should == 255
+    c.trans?.should be_false
+    c.opaque?.should be_true
+    c.to_s.should == '#AABBCC'
+    
+    c.a = 38
+    c.a.should == 38
+    c.trans?.should be_true
+    c.opaque?.should be_false
+    c.to_s.should == '#AABBCC26'
+  end
+
+  it 'should support a definable callback for symbols' do
+    Color.lookup_callback = lambda{|val| SAMPLE_LIBRARY[val]}
+    SAMPLE_LIBRARY.each_pair do |k,v|
+      rgb(k).should == rgb(v)
+    end
+    Color.parse(:purplish).should == SAMPLE_LIBRARY[:purplish]
+  end
+
+end

data/spec/web/element_spec.rb

@@ -0,0 +1,69 @@
+describe Html::Element do
+
+  # Helper to shortcut a lot of typing...
+  def build(*args, &block)
+    Html::Element.build(*args, &block)
+  end
+
+  it 'should build standard tags' do
+    Html::Element.new('b').render.should == '<b></b>'
+    Html::Element.build('script').should include('<script></script>')
+  end
+  
+  it 'should build singleton tags' do
+    build('img').should == '<img>'
+    build('input').should == '<input>'
+  end
+  
+  it 'should build attributes' do
+    build('img', :src => '/foo.jpg').should == '<img src="/foo.jpg">'
+    build('span', :id => 'alpha', :class => 'bold').should == '<span id="alpha" class="bold"></span>'
+  end
+  
+  it 'should support basic text' do
+    build('span', 'heya').should == '<span>heya</span>'
+  end
+  
+  it 'should html escape basic text' do
+    build('span', '"boo!"').should == '<span>&quot;boo!&quot;</span>'
+  end
+  
+  it 'should html escape attr values' do 
+    build('a', :alt => 'We had "fun"').should == '<a alt="We had &quot;fun&quot;"></a>'
+  end
+  
+  it 'should support indenting' do
+    Html::Element.new('div', 'indent!').render.should == "\n<div>\n  indent!\n</div>\n"
+  end
+  
+  it 'should support block indenting by skipping initial newline' do
+    Html::Element.new('div', 'indent!').render(0,true).should == "<div>\n  indent!\n</div>\n"
+  end
+  
+  it 'should add attributes when called as setters' do
+    span = Html::Element.new(:span)
+    span.class = 'dynamic'
+    span.id = 'header'
+    span.attrs.keys.should include(:class, :id)
+    span.render.should == '<span class="dynamic" id="header"></span>'
+  end
+  
+  it 'should yield a block for customization on creation' do
+    Html::Element.new(:span) {|span|
+      span.id = 'fun'
+    }.render.should == '<span id="fun"></span>'
+  end
+  
+  it 'should contain HTML' do
+    Html::Element.new(:span).html.should be_a(Html)
+  end
+  
+  it 'should allow setting the inner html' do
+    span = Html::Element.new(:span)
+    span.html = 'some text'
+    span.render.should == '<span>some text</span>'
+    span.html = Html.new.strong('more text!')
+    span.render.should == '<span><strong>more text!</strong></span>'
+  end
+  
+end

data/spec/web/html_safe_string_spec.rb

@@ -0,0 +1,25 @@
+# Don't run specs if HtmlSafeString is not present, eg when running in a rails environment
+if defined?(HtmlSafeString)
+
+describe HtmlSafeString do
+  
+  it 'should be html safe at creation' do
+    HtmlSafeString.new.should be_html_safe
+  end
+  
+  it 'should stay html safe after concatenation' do
+    s = HtmlSafeString.new('alpha')
+    s += 'beta'
+    s.should == 'alphabeta'
+    s.should be_html_safe
+  end
+  
+  it 'should safely escape dangerous chars on concatenation' do
+    s = HtmlSafeString.new('alpha')
+    s += 'b&ta'
+    s.should == 'alphab&ta'
+  end
+  
+end
+
+end

data/spec/web/html_spec.rb

@@ -0,0 +1,20 @@
+describe Html do
+  
+  it 'should generate simple HTML' do
+    Html.build do |html|
+      html.span('hello wwworld')
+    end.should == '<span>hello wwworld</span>'
+  end
+  
+  it 'should escape unsafe characters' do
+    Html.escape_once('"hi&<guy>"').should == '&quot;hi&amp;&lt;guy&gt;&quot;'
+  end
+  
+  it 'should support comments' do
+    Html.build do |html|
+      html.comment! 'Important stuff'
+      html.h1 'Da header'
+    end.should == "<!-- Important stuff -->\n\n<h1>\n  Da header\n</h1>\n"
+  end
+  
+end

data/spec/web/string_spec.rb

@@ -0,0 +1,16 @@
+describe String do
+  
+  it 'should not be html safe' do
+    String.new.should_not be_html_safe
+    'bob'.should_not be_html_safe
+  end
+  
+  it 'should become a safe string on calls to #html_safe' do
+    'abc'.html_safe.should be_a(HtmlSafeString)
+  end
+  
+  it 'should not change contents on calls to #html_safe' do
+    '<span class="fun">'.html_safe.should == '<span class="fun">'
+  end
+  
+end

data/spec/web/url_spec.rb

@@ -0,0 +1,101 @@
+describe Url do
+  
+  it 'should parse url paths' do
+    {
+      '/' => '/',
+      'http://google.com' => '',
+      '/site/main-bar?foo=123bar#some_bit' => '/site/main-bar'
+    }.each_pair do |url, path|
+      Url.parse(url).path.should == path
+    end
+  end
+  
+  it 'should parse servers' do 
+    {
+      '/' => nil,
+      'google.com' => nil,
+      'http://google.com' => 'google.com',
+      'http://google.com:8080' => 'google.com',
+      'http://www3.text-mates.org.uk:1234?foo' => 'www3.text-mates.org.uk',
+      'http://abc.com/yes.com/no.com#fun' => 'abc.com'
+    }.each_pair do |url, server|
+      Url.parse(url).server.should == server
+    end
+  end
+
+  it 'should parse a really complex url' do
+    u = Url.parse('sftp://mondo122.goober.com:819/this/is-a-bunch.jpg?of=crazy&free[]=55#now')
+    u.scheme.should == 'sftp'
+    u.server.should == 'mondo122.goober.com'
+    u.port.should == 819
+    u.path.should == '/this/is-a-bunch.jpg'
+    u.params['of'].should == 'crazy'
+    u.params['free[]'].should == '55'
+    u.fragment.should == 'now'
+  end
+  
+  it 'should construct a simple url' do
+    u = Url.new
+    u.path = '/bob.jpg'
+    u.to_s.should == '/bob.jpg'
+  end
+  
+  it 'should construct a complex url' do
+    u = Url.new
+    u.server = 'jimbo.net.org'
+    u.port = 1044
+    u.path = '/south-west'
+    u.add_param('site', 'http://goober.com?123')
+    u.fragment = 'boggle-noggle'
+    u.to_s.should == 'http://jimbo.net.org:1044/south-west?site=http%3A%2F%2Fgoober.com%3F123#boggle-noggle'
+  end
+  
+  it 'should allow adding params' do
+    u = Url.parse('http://irongaze.com')
+    u.params['foo'] = 'bar'
+    u.to_s.should == 'http://irongaze.com?foo=bar'
+  end
+  
+  it 'should allow multiple values for a single param' do
+    u = Url.new('/scores')
+    u.add_param('soccer', '123')
+    u.add_param('soccer', '456')
+    u = Url.parse(u.to_s)
+    val = u.params['soccer']
+    val.should be_an(Array)
+    val.length.should == 2
+    val[1].should == '456'
+  end
+  
+  it 'should allow resetting params' do
+    u = Url.parse('/?a=1&b=2')
+    u.params.length.should == 2
+    u.reset_params
+    u.should_not have_params
+  end
+  
+  it 'should allow removing a param' do 
+    u = Url.parse('/?a=1&b=2')
+    u.remove_param('a')
+    u.params.length.should == 1
+    u.to_s.should == '/?b=2'
+  end
+  
+  it 'should support adding to the path' do
+    u = Url.parse('/')
+    u += 'main/site'
+    u.to_s.should == '/main/site'
+  end
+  
+  it 'should make relative urls absolute' do
+    u = Url.parse('/bar')
+    u.relative?.should be_true
+    Url.default_server = 'irongaze.com'
+    u.make_absolute.should == 'http://irongaze.com/bar'
+  end
+  
+  it 'should escape params correctly' do
+    Url.build('/foo', 'one:two' => 'http://other.com').should == '/foo?one%3Atwo=http%3A%2F%2Fother.com'
+  end
+  
+end

metadata

@@ -0,0 +1,87 @@
+--- !ruby/object:Gem::Specification
+name: iron-web
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+  prerelease: 
+platform: ruby
+authors:
+- Rob Morris
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-03-05 00:00:00.000000000Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: iron-extensions
+  requirement: &2152615480 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *2152615480
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &2152608900 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.6'
+  type: :development
+  prerelease: false
+  version_requirements: *2152608900
+description: Html builder, color helper class and url parser/builder class for use
+  in Rails projects or other web-based content generation.
+email:
+- rob@irongaze.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/iron/web/color.rb
+- lib/iron/web/html/element.rb
+- lib/iron/web/html.rb
+- lib/iron/web/string.rb
+- lib/iron/web/url.rb
+- lib/iron/web.rb
+- spec/spec_helper.rb
+- spec/web/color_spec.rb
+- spec/web/element_spec.rb
+- spec/web/html_safe_string_spec.rb
+- spec/web/html_spec.rb
+- spec/web/string_spec.rb
+- spec/web/url_spec.rb
+- LICENSE
+- History.txt
+- Version.txt
+- README.rdoc
+- .rspec
+homepage: http://irongaze.com
+licenses:
+- MIT
+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.10
+signing_key: 
+specification_version: 3
+summary: Helper classes for generating web content
+test_files: []