marcosinger-css_parser 1.3.0

data/test/test_css_parser_regexps.rb

@@ -0,0 +1,69 @@
+# coding: iso-8859-1
+require File.expand_path(File.dirname(__FILE__) + '/test_helper')
+
+# Test cases for CSS regular expressions
+#
+# see http://www.w3.org/TR/CSS21/syndata.html and
+# http://www.w3.org/TR/CSS21/grammar.html
+class CssParserRegexpTests < Test::Unit::TestCase
+  def test_strings
+    # complete matches
+    ['"abcd"', '" A sd s�drcv \'dsf\' asd rfg asd"', '"A\ d??ef 123!"',
+     "\"this is\\\n a test\"", '"back\67round"', '"r\000065 ed"',
+     "'abcd'", "' A sd sedrcv \"dsf\" asd rf�&23$%#%$g asd'", "'A\\\n def 123!'",
+     "'this is\\\n a test'", "'back\\67round'", "'r\\000065 ed'"     
+    ].each do |str|
+      assert_equal str, str.match(CssParser::RE_STRING).to_s
+    end
+
+    test_string = "p { background: red url(\"url\\.'p'ng\"); }"
+    assert_equal "\"url\\.'p'ng\"", test_string.match(CssParser::RE_STRING).to_s
+  
+  end
+
+  def test_unicode
+    ['back\67round', 'r\000065 ed', '\00006C'].each do |str|
+      assert_match(Regexp.new(CssParser::RE_UNICODE), str)
+    end
+  end
+
+  def test_colour
+    ['color: #fff', 'color:#f0a09c;', 'color: #04A', 'color: #04a9CE',
+     'color: rgb(100, -10%, 300);', 'color: rgb(10,10,10)', 'color:rgb(12.7253%, -12%,0)',
+     'color: black', 'color:Red;', 'color: AqUa;', 'color: blue   ', 'color: transparent'
+    ].each do |colour|
+      assert_match(CssParser::RE_COLOUR, colour)
+    end
+
+    ['color: #fa', 'color:#f009c;', 'color: #04G', 'color: #04a9Cq',
+     'color: rgb 100, -10%, 300;', 'color: rgb 10,10,10', 'color:rgb(12px, -12%,0)',
+     'color:fuscia;', 'color: thick'
+    ].each do |colour|
+      assert_no_match(CssParser::RE_COLOUR, colour)
+    end
+  end
+
+  def test_uris
+    crazy_uri = 'http://www.example.com:80/~/redb%20all.png?test=test&test;test+test#test!'
+    
+    assert_equal "url('#{crazy_uri}')", 
+                  "li { list-style: url('#{crazy_uri}') disc }".match(CssParser::RE_URI).to_s
+
+    assert_equal "url(#{crazy_uri})", 
+                  "li { list-style: url(#{crazy_uri}) disc }".match(CssParser::RE_URI).to_s
+
+    assert_equal "url(\"#{crazy_uri}\")", 
+                 "li { list-style: url(\"#{crazy_uri}\") disc }".match(CssParser::RE_URI).to_s
+  end
+
+
+protected
+  def load_test_file(filename)
+    fh = File.new("fixtures/#{filename}", 'r')
+    test_file = fh.read
+    fh.close
+
+    return test_file
+   end
+
+end

data/test/test_helper.rb

@@ -0,0 +1,6 @@
+require 'rubygems'
+require 'test/unit'
+require 'net/http'
+require 'open-uri'
+require 'WEBrick'
+require File.dirname(__FILE__) + '/../lib/css_parser'

data/test/test_merging.rb

@@ -0,0 +1,103 @@
+require File.expand_path(File.dirname(__FILE__) + '/test_helper')
+
+class MergingTests < Test::Unit::TestCase
+  include CssParser
+
+  def setup
+    @cp = CssParser::Parser.new
+  end
+
+  def test_simple_merge
+    rs1 = RuleSet.new(nil, 'color: black;')
+    rs2 = RuleSet.new(nil, 'margin: 0px;')
+    merged = CssParser.merge(rs1, rs2)
+    assert_equal '0px;', merged['margin']
+    assert_equal 'black;', merged['color']
+  end
+
+  def test_merging_array
+    rs1 = RuleSet.new(nil, 'color: black;')
+    rs2 = RuleSet.new(nil, 'margin: 0px;')
+    merged = CssParser.merge([rs1, rs2])
+    assert_equal '0px;', merged['margin']
+    assert_equal 'black;', merged['color']
+  end
+
+
+  def test_merging_multiple
+    rs1 = RuleSet.new(nil, 'color: black;')
+    rs2 = RuleSet.new(nil, 'margin: 0px;')
+    rs3 = RuleSet.new(nil, 'margin: 5px;')
+    merged = CssParser.merge(rs1, rs2, rs3)
+    assert_equal '5px;', merged['margin']
+  end
+
+  def test_multiple_selectors_should_have_zero_specificity
+    rs1 = RuleSet.new('p, a[rel="external"]', 'color: black;')
+    rs2 = RuleSet.new('a', 'color: blue;')
+    merged = CssParser.merge(rs1, rs2)
+    assert_equal 'blue;', merged['color']
+  end
+
+  def test_setting_specificity
+    rs1 = RuleSet.new(nil, 'color: red;', 20)
+    rs2 = RuleSet.new(nil, 'color: blue;', 10)
+    merged = CssParser.merge(rs1, rs2)
+    assert_equal 'red;', merged['color']
+  end
+
+  def test_properties_should_be_case_insensitive
+    rs1 = RuleSet.new(nil, ' CoLor   : red  ;', 20)
+    rs2 = RuleSet.new(nil, 'color: blue;', 10)
+    merged = CssParser.merge(rs1, rs2)
+    assert_equal 'red;', merged['color']
+  end
+
+  def test_merging_backgrounds
+    rs1 = RuleSet.new(nil, 'background-color: black;')
+    rs2 = RuleSet.new(nil, 'background-image: none;')
+    merged = CssParser.merge(rs1, rs2)
+    assert_equal 'black none;', merged['background']
+  end
+
+  def test_merging_dimensions
+    rs1 = RuleSet.new(nil, 'margin: 3em;')
+    rs2 = RuleSet.new(nil, 'margin-left: 1em;')
+    merged = CssParser.merge(rs1, rs2)
+    assert_equal '3em 3em 3em 1em;', merged['margin']
+  end
+
+  def test_merging_fonts
+    rs1 = RuleSet.new(nil, 'font: 11px Arial;')
+    rs2 = RuleSet.new(nil, 'font-weight: bold;')
+    merged = CssParser.merge(rs1, rs2)
+    assert_equal 'bold 11px Arial;', merged['font']
+  end
+
+  def test_raising_error_on_bad_type
+    assert_raise ArgumentError do
+      CssParser.merge([1,2,3])
+    end
+  end
+
+  def test_returning_early_with_only_one_params
+    rs = RuleSet.new(nil, 'font-weight: bold;')
+    merged = CssParser.merge(rs)
+    assert_equal rs.object_id, merged.object_id
+  end
+  
+  def test_merging_important
+    rs1 = RuleSet.new(nil, 'color: black !important;')
+    rs2 = RuleSet.new(nil, 'color: red;')
+    merged = CssParser.merge(rs1, rs2)
+    assert_equal 'black !important;', merged['color']    
+  end
+
+  def test_merging_shorthand_important
+    rs1 = RuleSet.new(nil, 'background: black none !important;')
+    rs2 = RuleSet.new(nil, 'background-color: red;')
+    merged = CssParser.merge(rs1, rs2)
+    assert_equal 'black !important;', merged['background-color']
+  end
+
+end

data/test/test_rule_set.rb

@@ -0,0 +1,90 @@
+require File.expand_path(File.dirname(__FILE__) + '/test_helper')
+require "set"
+
+# Test cases for parsing CSS blocks
+class RuleSetTests < Test::Unit::TestCase
+  include CssParser
+
+  def setup
+    @cp = Parser.new
+  end
+
+  def test_setting_property_values
+    rs = RuleSet.new(nil, nil)
+    
+    rs['background-color'] = 'red'
+    assert_equal('red;', rs['background-color'])
+
+    rs['background-color'] = 'blue !important;'
+    assert_equal('blue !important;', rs['background-color'])
+  end
+
+  def test_getting_property_values
+    rs = RuleSet.new('#content p, a', 'color: #fff;')
+    assert_equal('#fff;', rs['color'])
+  end
+
+  def test_getting_property_value_ignoring_case
+    rs = RuleSet.new('#content p, a', 'color: #fff;')
+    assert_equal('#fff;', rs['  ColoR '])
+  end
+
+  def test_each_selector
+    expected = [
+       {:selector => "#content p", :declarations => "color: #fff;", :specificity => 101},
+       {:selector => "a", :declarations => "color: #fff;", :specificity => 1}
+    ]
+    
+    actual = []
+    rs = RuleSet.new('#content p, a', 'color: #fff;')
+    rs.each_selector do |sel, decs, spec|
+      actual << {:selector => sel, :declarations => decs, :specificity => spec}
+    end
+    
+    assert_equal(expected, actual)
+  end
+
+  def test_each_declaration
+    expected = Set.new([
+       {:property => 'margin', :value => '1px -0.25em', :is_important => false},
+       {:property => 'background', :value => 'white none no-repeat', :is_important => true},
+       {:property => 'color', :value => '#fff', :is_important => false}
+    ])
+    
+    actual = Set.new
+    rs = RuleSet.new(nil, 'color: #fff; Background: white none no-repeat !important; margin: 1px -0.25em;')
+    rs.each_declaration do |prop, val, imp|
+      actual << {:property => prop, :value => val, :is_important => imp}
+    end
+    
+    assert_equal(expected, actual)
+  end
+
+  def test_each_declaration_respects_order
+    css_fragment = "margin: 0; padding: 20px; margin-bottom: 28px;"
+    rs           = RuleSet.new(nil, css_fragment)
+    expected     = %w(margin padding margin-bottom)
+    actual       = []
+    rs.each_declaration { |prop, val, imp| actual << prop }
+    assert_equal(expected, actual)
+  end
+
+  def test_declarations_to_s
+    declarations = 'color: #fff; font-weight: bold;'
+    rs = RuleSet.new('#content p, a', declarations)
+    assert_equal(declarations.split(' ').sort, rs.declarations_to_s.split(' ').sort)
+  end
+
+  def test_important_declarations_to_s
+    declarations = 'color: #fff; font-weight: bold !important;'
+    rs = RuleSet.new('#content p, a', declarations)
+    assert_equal(declarations.split(' ').sort, rs.declarations_to_s.split(' ').sort)
+  end
+
+  def test_overriding_specificity
+    rs = RuleSet.new('#content p, a', 'color: white', 1000)
+    rs.each_selector do |sel, decs, spec|
+      assert_equal 1000, spec
+    end
+  end
+end

data/test/test_rule_set_creating_shorthand.rb

@@ -0,0 +1,119 @@
+require File.expand_path(File.dirname(__FILE__) + '/test_helper')
+
+# Test cases for reading and generating CSS shorthand properties
+class RuleSetCreatingShorthandTests < Test::Unit::TestCase
+  include CssParser
+
+  def setup
+    @cp = CssParser::Parser.new
+  end
+
+# ==== Border shorthand
+  def test_combining_borders_into_shorthand
+    properties = {'border-top-width' => 'auto', 'border-right-width' => 'thin', 'border-bottom-width' => 'auto', 'border-left-width' => '0px'}
+
+    combined = create_shorthand(properties)
+
+    assert_equal('auto thin auto 0px;', combined['border-width'])
+
+    # after creating shorthand, all long-hand properties should be deleted
+    assert_properties_are_deleted(combined, properties)
+
+    # should not combine if any properties are missing
+    properties.delete('border-top-width')
+
+    combined = create_shorthand(properties)
+
+    assert_equal '', combined['border-width']
+    
+    properties = {'border-width' => '22%', 'border-color' => 'black'}
+    combined = create_shorthand(properties)
+        
+    assert_equal '22% black;', combined['border']
+    assert_equal '', combined['border-width']
+    
+    properties = {'border-top-style' => 'none', 'border-right-style' => 'none', 'border-bottom-style' => 'none', 'border-left-style' => 'none'}
+    combined = create_shorthand(properties)
+    assert_equal 'none;', combined['border']
+  end
+
+# ==== Dimensions shorthand
+  def test_combining_dimensions_into_shorthand
+    properties = {'margin-right' => 'auto', 'margin-bottom' => '0px', 'margin-left' => 'auto', 'margin-top' => '0px', 
+                  'padding-right' => '1.25em', 'padding-bottom' => '11%', 'padding-left' => '3pc', 'padding-top' => '11.25ex'}
+    
+    combined = create_shorthand(properties)
+    
+    assert_equal('0px auto;', combined['margin'])
+    assert_equal('11.25ex 1.25em 11% 3pc;', combined['padding'])
+
+    # after creating shorthand, all long-hand properties should be deleted
+    assert_properties_are_deleted(combined, properties)
+
+    # should not combine if any properties are missing
+    properties.delete('margin-right')
+    properties.delete('padding-right')
+
+    combined = create_shorthand(properties)
+
+    assert_equal '', combined['margin']
+    assert_equal '', combined['padding']
+  end
+
+# ==== Font shorthand
+  def test_combining_font_into_shorthand
+    # should combine if all font properties are present
+    properties = {"font-weight" => "300", "font-size" => "12pt", 
+                   "font-family" => "sans-serif", "line-height" => "18px",
+                   "font-style" => "oblique", "font-variant" => "small-caps"}
+    
+    combined = create_shorthand(properties)
+    assert_equal('oblique small-caps 300 12pt/18px sans-serif;', combined['font'])
+
+    # after creating shorthand, all long-hand properties should be deleted
+    assert_properties_are_deleted(combined, properties)
+
+    # should not combine if any properties are missing
+    properties.delete('font-weight')
+    combined = create_shorthand(properties)
+    assert_equal '', combined['font']
+  end
+
+# ==== Background shorthand
+  def test_combining_background_into_shorthand
+    properties = {'background-image' => 'url(\'chess.png\')', 'background-color' => 'gray', 
+                  'background-position' => 'center -10.2%', 'background-attachment' => 'fixed',
+                  'background-repeat' => 'no-repeat'}
+    
+    combined = create_shorthand(properties)
+    
+    assert_equal('gray url(\'chess.png\') no-repeat center -10.2% fixed;', combined['background'])
+    
+    # after creating shorthand, all long-hand properties should be deleted
+    assert_properties_are_deleted(combined, properties)
+  end
+
+  def test_property_values_in_url
+    rs = RuleSet.new('#header', "background:url(http://example.com/1528/www/top-logo.jpg) no-repeat top right; padding: 79px 0 10px 0;  text-align:left;")
+    rs.expand_shorthand!
+    assert_equal('top right;', rs['background-position'])
+    rs.create_shorthand!
+    assert_equal('url(http://example.com/1528/www/top-logo.jpg) no-repeat top right;', rs['background'])
+end
+
+protected
+  def assert_properties_are_deleted(ruleset, properties)
+    properties.each do |property, value|
+      assert_equal '', ruleset[property]
+    end
+  end
+
+  def create_shorthand(properties)
+    ruleset = RuleSet.new(nil, nil)
+    properties.each do |property, value|
+      ruleset[property] = value
+    end
+    ruleset.create_shorthand!
+    ruleset
+  end
+end

data/test/test_rule_set_expanding_shorthand.rb

@@ -0,0 +1,198 @@
+require File.expand_path(File.dirname(__FILE__) + '/test_helper')
+
+class RuleSetExpandingShorthandTests < Test::Unit::TestCase
+  include CssParser
+
+  def setup
+    @cp = CssParser::Parser.new
+  end
+
+# ==== Dimensions shorthand
+  def test_expanding_border_shorthand
+    declarations = expand_declarations('border: none')
+    assert_equal 'none', declarations['border-right-style']
+
+    declarations = expand_declarations('border: 1px solid red')
+    assert_equal '1px', declarations['border-top-width']
+    assert_equal 'solid', declarations['border-bottom-style']  
+    
+    declarations = expand_declarations('border-color: red hsla(255, 0, 0, 5) rgb(2% ,2%,2%)')
+    assert_equal 'red', declarations['border-top-color']
+    assert_equal 'rgb(2%,2%,2%)', declarations['border-bottom-color']
+    assert_equal 'hsla(255,0,0,5)', declarations['border-left-color']
+
+    declarations = expand_declarations('border: thin dot-dot-dash')
+    assert_equal 'dot-dot-dash', declarations['border-left-style']
+    assert_equal 'thin', declarations['border-left-width']
+    assert_nil declarations['border-left-color']
+  end
+
+# ==== Dimensions shorthand
+  def test_getting_dimensions_from_shorthand
+    # test various shorthand forms
+    ['margin: 0px auto', 'margin: 0px auto 0px', 'margin: 0px auto 0px'].each do |shorthand|
+      declarations = expand_declarations(shorthand)
+      assert_equal({"margin-right" => "auto", "margin-bottom" => "0px", "margin-left" => "auto", "margin-top" => "0px"}, declarations)
+    end
+
+    # test various units
+    ['em', 'ex', 'in', 'px', 'pt', 'pc', '%'].each do |unit|
+      shorthand = "margin: 0% -0.123#{unit} 9px -.9pc"
+      declarations = expand_declarations(shorthand)
+      assert_equal({"margin-right" => "-0.123#{unit}", "margin-bottom" => "9px", "margin-left" => "-.9pc", "margin-top" => "0%"}, declarations)    
+    end
+  end
+
+
+# ==== Font shorthand
+  def test_getting_font_size_from_shorthand
+    ['em', 'ex', 'in', 'px', 'pt', 'pc', '%'].each do |unit|
+      shorthand = "font: 300 italic 11.25#{unit}/14px verdana, helvetica, sans-serif;"
+      declarations = expand_declarations(shorthand)
+      assert_equal("11.25#{unit}", declarations['font-size'])
+    end
+    
+    ['smaller', 'small', 'medium', 'large', 'x-large', 'auto'].each do |unit|
+      shorthand = "font: 300 italic #{unit}/14px verdana, helvetica, sans-serif;"
+      declarations = expand_declarations(shorthand)
+      assert_equal(unit, declarations['font-size'])
+    end
+  end
+
+  def test_getting_font_families_from_shorthand
+    shorthand = "font: 300 italic 12px/14px \"Helvetica-Neue-Light 45\", 'verdana', helvetica, sans-serif;"
+    declarations = expand_declarations(shorthand)
+    assert_equal("\"Helvetica-Neue-Light 45\", 'verdana', helvetica, sans-serif", declarations['font-family'])
+  end
+
+  def test_getting_font_weight_from_shorthand
+    ['300', 'bold', 'bolder', 'lighter', 'normal'].each do |unit|
+      shorthand = "font: #{unit} italic 12px sans-serif;"
+      declarations = expand_declarations(shorthand)
+      assert_equal(unit, declarations['font-weight'])
+    end
+
+    # ensure normal is the default state
+    ['font: normal italic 12px sans-serif;', 'font: italic 12px sans-serif;',
+     'font: small-caps normal 12px sans-serif;', 'font: 12px/16px sans-serif;'].each do |shorthand|
+      declarations = expand_declarations(shorthand)
+      assert_equal('normal', declarations['font-weight'], shorthand)
+    end
+  end
+
+  def test_getting_font_variant_from_shorthand
+    shorthand = "font: small-caps italic 12px sans-serif;"
+    declarations = expand_declarations(shorthand)
+    assert_equal('small-caps', declarations['font-variant'])
+
+    # ensure normal is the default state
+    ['font: normal italic 12px sans-serif;', 'font: italic 12px sans-serif;',
+     'font: normal 12px sans-serif;', 'font: 12px/16px sans-serif;'].each do |shorthand|
+      declarations = expand_declarations(shorthand)
+      assert_equal('normal', declarations['font-variant'], shorthand)
+    end
+  end
+
+  def test_getting_font_style_from_shorthand
+    ['italic', 'oblique'].each do |unit|
+      shorthand = "font: normal #{unit} bold 12px sans-serif;"
+      declarations = expand_declarations(shorthand)
+      assert_equal(unit, declarations['font-style'])
+    end
+
+    # ensure normal is the default state
+    ['font: normal bold 12px sans-serif;', 'font: small-caps 12px sans-serif;',
+     'font: normal 12px sans-serif;', 'font: 12px/16px sans-serif;'].each do |shorthand|
+      declarations = expand_declarations(shorthand)
+      assert_equal('normal', declarations['font-style'], shorthand)
+    end
+  end
+
+  def test_getting_line_height_from_shorthand
+    ['em', 'ex', 'in', 'px', 'pt', 'pc', '%'].each do |unit|
+      shorthand = "font: 300 italic 12px/0.25#{unit} verdana, helvetica, sans-serif;"
+      declarations = expand_declarations(shorthand)
+      assert_equal("0.25#{unit}", declarations['line-height'])
+    end
+
+    # ensure normal is the default state
+    ['font: normal bold 12px sans-serif;', 'font: small-caps 12px sans-serif;',
+     'font: normal 12px sans-serif;', 'font: 12px sans-serif;'].each do |shorthand|
+      declarations = expand_declarations(shorthand)
+      assert_equal('normal', declarations['line-height'], shorthand)
+    end
+  end
+
+
+# ==== Background shorthand
+  def test_getting_background_properties_from_shorthand
+    expected = {"background-image" => "url('chess.png')", "background-color" => "gray", "background-repeat" => "repeat", 
+              "background-attachment" => "fixed", "background-position" => "50%"}
+
+    shorthand = "background: url('chess.png') gray 50% repeat fixed;"
+    declarations = expand_declarations(shorthand)
+    assert_equal expected, declarations
+  end
+
+  def test_getting_background_position_from_shorthand
+    ['em', 'ex', 'in', 'px', 'pt', 'pc', '%'].each do |unit|
+      shorthand = "background: url('chess.png') gray 30% -0.15#{unit} repeat fixed;"
+      declarations = expand_declarations(shorthand)
+      assert_equal("30% -0.15#{unit}", declarations['background-position'])
+    end
+
+    ['left', 'center', 'right', 'top', 'bottom', 'inherit'].each do |position|
+      shorthand = "background: url('chess.png') #000fff #{position} no-repeat fixed;"
+      declarations = expand_declarations(shorthand)
+      assert_equal(position, declarations['background-position'])
+    end
+  end
+
+  def test_getting_background_colour_from_shorthand
+    ['blue', 'lime', 'rgb(10,10,10)', 'rgb (  -10%, 99, 300)', '#ffa0a0', '#03c', 'trAnsparEnt', 'inherit'].each do |colour|
+      shorthand = "background:#{colour} url('chess.png') center repeat fixed ;"
+      declarations = expand_declarations(shorthand)
+      assert_equal(colour, declarations['background-color'])
+    end
+  end
+
+  def test_getting_background_attachment_from_shorthand
+    ['scroll', 'fixed', 'inherit'].each do |attachment|
+      shorthand = "background:#0f0f0f url('chess.png') center repeat #{attachment};"
+      declarations = expand_declarations(shorthand)
+      assert_equal(attachment, declarations['background-attachment'])
+    end
+  end
+
+  def test_getting_background_repeat_from_shorthand
+    ['repeat-x', 'repeat-y', 'no-repeat', 'inherit'].each do |repeat|
+      shorthand = "background:#0f0f0f none #{repeat};"
+      declarations = expand_declarations(shorthand)
+      assert_equal(repeat, declarations['background-repeat'])
+    end
+  end
+
+  def test_getting_background_image_from_shorthand
+    ['url("chess.png")', 'url("https://example.org:80/~files/chess.png?123=abc&test#5")', 
+     'url(https://example.org:80/~files/chess.png?123=abc&test#5)',
+     "url('https://example.org:80/~files/chess.png?123=abc&test#5')", 'none', 'inherit'].each do |image|
+      
+      shorthand = "background: #0f0f0f #{image} ;"
+      declarations = expand_declarations(shorthand)
+      assert_equal(image, declarations['background-image'])
+    end
+  end
+
+
+protected
+  def expand_declarations(declarations)
+    ruleset = RuleSet.new(nil, declarations)
+    ruleset.expand_shorthand!
+
+    collected = {}
+    ruleset.each_declaration do |prop, val, imp|
+      collected[prop.to_s] = val.to_s
+    end
+    collected  
+  end
+end