css_parser_1.1.0 1.1.0

data/test/fixtures/simple.css

@@ -0,0 +1,6 @@
+body {
+	color: black;
+	background: white;
+}
+
+p { margin: 0px; }

data/test/fixtures/subdir/import2.css

@@ -0,0 +1,3 @@
+@import "../simple.css";
+
+a { text-decoration: none; }

data/test/test_css_parser_basic.rb

@@ -0,0 +1,56 @@
+require File.dirname(__FILE__) + '/test_helper'
+
+# Test cases for reading and generating CSS shorthand properties
+class CssParserBasicTests < Test::Unit::TestCase
+  include CssParser
+
+  def setup
+    @cp = CssParser::Parser.new
+    @css = <<-EOT
+      html, body, p { margin: 0px; }
+      p { padding: 0px; }
+      #content { font: 12px/normal sans-serif; }
+    EOT
+  end
+
+  def test_finding_by_selector
+    @cp.add_block!(@css)
+    assert_equal 'margin: 0px;', @cp.find_by_selector('body').join(' ')
+    assert_equal 'margin: 0px; padding: 0px;', @cp.find_by_selector('p').join(' ')
+  end
+
+  def test_adding_block
+    @cp.add_block!(@css)
+    assert_equal 'margin: 0px;', @cp.find_by_selector('body').join
+  end
+
+  def test_adding_a_rule
+    @cp.add_rule!('div', 'color: blue;')
+    assert_equal 'color: blue;', @cp.find_by_selector('div').join(' ')
+  end
+
+  def test_adding_a_rule_set
+    rs = CssParser::RuleSet.new('div', 'color: blue;')
+    @cp.add_rule_set!(rs)
+    assert_equal 'color: blue;', @cp.find_by_selector('div').join(' ')
+  end
+
+  def test_toggling_uri_conversion
+    # with conversion
+    cp_with_conversion = Parser.new(:absolute_paths => true)
+    cp_with_conversion.add_block!("body { background: url('../style/yellow.png?abc=123') };",
+                                  :base_uri => 'http://example.org/style/basic.css')
+
+    assert_equal "background: url('http://example.org/style/yellow.png?abc=123');",
+                 cp_with_conversion['body'].join(' ')
+    
+    # without conversion
+    cp_without_conversion = Parser.new(:absolute_paths => false)
+    cp_without_conversion.add_block!("body { background: url('../style/yellow.png?abc=123') };",
+                                     :base_uri => 'http://example.org/style/basic.css')
+
+    assert_equal "background: url('../style/yellow.png?abc=123');",
+                 cp_without_conversion['body'].join(' ')
+  end
+
+end

data/test/test_css_parser_loading.rb

@@ -0,0 +1,110 @@
+require File.dirname(__FILE__) + '/test_helper'
+
+# Test cases for the CssParser's loading functions.
+class CssParserLoadingTests < Test::Unit::TestCase
+  include CssParser
+  include WEBrick
+
+  def setup
+    # from http://nullref.se/blog/2006/5/17/testing-with-webrick
+    @cp = Parser.new
+
+    @uri_base = 'http://localhost:12000'
+
+    www_root = File.dirname(__FILE__) + '/fixtures/'
+
+    @server_thread = Thread.new do
+      s = WEBrick::HTTPServer.new(:Port => 12000, :DocumentRoot => www_root, :Logger => Log.new(nil, BasicLog::FATAL), :AccessLog => [])
+      @port = s.config[:Port]
+      begin
+        s.start
+      ensure
+        s.shutdown
+      end
+    end
+
+    sleep 1 # ensure the server has time to load
+  end
+
+  def teardown
+    @server_thread.kill
+    @server_thread.join(5)
+    @server_thread = nil
+  end
+
+  def test_loading_a_local_file
+    file_name = File.dirname(__FILE__) + '/fixtures/simple.css'
+    @cp.load_file!(file_name)
+    assert_equal 'margin: 0px;', @cp.find_by_selector('p').join(' ')
+  end
+
+  def test_loading_a_remote_file
+    @cp.load_uri!("#{@uri_base}/simple.css")
+    assert_equal 'margin: 0px;', @cp.find_by_selector('p').join(' ')
+  end
+
+  def test_following_at_import_rules_local
+    base_dir = File.dirname(__FILE__) + '/fixtures'
+    @cp.load_file!('import1.css', base_dir)
+
+    # from '/import1.css'
+    assert_equal 'color: lime;', @cp.find_by_selector('div').join(' ')
+
+    # from '/subdir/import2.css'
+    assert_equal 'text-decoration: none;', @cp.find_by_selector('a').join(' ')
+    
+    # from '/subdir/../simple.css'
+    assert_equal 'margin: 0px;', @cp.find_by_selector('p').join(' ')
+  end
+
+  def test_following_at_import_rules_remote
+    @cp.load_uri!("#{@uri_base}/import1.css")
+
+    # from '/import1.css'
+    assert_equal 'color: lime;', @cp.find_by_selector('div').join(' ')
+
+    # from '/subdir/import2.css'
+    assert_equal 'text-decoration: none;', @cp.find_by_selector('a').join(' ')
+    
+    # from '/subdir/../simple.css'
+    assert_equal 'margin: 0px;', @cp.find_by_selector('p').join(' ')
+  end
+
+  def test_following_at_import_rules_from_add_block
+    css_block = '@import "../simple.css";'
+ 
+    @cp.add_block!(css_block, :base_uri => "#{@uri_base}/subdir/")
+    
+    # from 'simple.css'
+    assert_equal 'margin: 0px;', @cp.find_by_selector('p').join(' ')
+  end
+
+  def test_importing_with_media_types
+    @cp.load_uri!("#{@uri_base}/import-with-media-types.css")
+    
+    # from simple.css with :screen media type
+    assert_equal 'margin: 0px;', @cp.find_by_selector('p', :screen).join(' ')
+    assert_equal '', @cp.find_by_selector('p', :tty).join(' ')
+  end
+
+  def test_throwing_circular_reference_exception
+    assert_raise CircularReferenceError do
+      @cp.load_uri!("#{@uri_base}/import-circular-reference.css")
+    end
+  end
+
+  def test_toggling_not_found_exceptions
+    cp_with_exceptions = Parser.new(:io_exceptions => true)
+
+    assert_raise RemoteFileError do
+      cp_with_exceptions.load_uri!("#{@uri_base}/no-exist.xyz")
+    end
+
+    cp_without_exceptions = Parser.new(:io_exceptions => false)
+
+    assert_nothing_raised RemoteFileError do
+      cp_without_exceptions.load_uri!("#{@uri_base}/no-exist.xyz")
+    end
+  end
+
+end

data/test/test_css_parser_media_types.rb

@@ -0,0 +1,71 @@
+require File.dirname(__FILE__) + '/test_helper'
+
+# Test cases for the handling of media types
+class CssParserMediaTypesTests < Test::Unit::TestCase
+  include CssParser
+
+  def setup
+    @cp = Parser.new
+  end
+
+  def test_finding_by_media_type
+    # from http://www.w3.org/TR/CSS21/media.html#at-media-rule
+    css = <<-EOT
+      @media print {
+        body { font-size: 10pt }
+      }
+      @media screen {
+        body { font-size: 13px }
+      }
+      @media screen, print {
+        body { line-height: 1.2 }
+      }
+    EOT
+
+    @cp.add_block!(css)
+
+    assert_equal 'font-size: 10pt; line-height: 1.2;', @cp.find_by_selector('body', :print).join(' ')
+    assert_equal 'font-size: 13px; line-height: 1.2;', @cp.find_by_selector('body', :screen).join(' ')
+  end
+
+  def atest_finding_by_multiple_media_types
+    css = <<-EOT
+      @media print {
+        body { font-size: 10pt }
+      }
+      @media handheld {
+        body { font-size: 13px }
+      }
+      @media screen, print {
+        body { line-height: 1.2 }
+      }
+    EOT
+    @cp.add_block!(css)
+
+    assert_equal 'font-size: 13px; line-height: 1.2;', @cp.find_by_selector('body', [:screen,:handheld]).join(' ')
+  end
+
+  def test_adding_block_with_media_types
+    css = <<-EOT
+      body { font-size: 10pt }
+    EOT
+
+    @cp.add_block!(css, :media_types => [:screen])
+    
+    assert_equal 'font-size: 10pt;', @cp.find_by_selector('body', :screen).join(' ')
+    assert @cp.find_by_selector('body', :handheld).empty?
+  end
+
+  def atest_adding_rule_set_with_media_type
+    @cp.add_rule!('body', 'color: black;', [:handheld,:tty])
+    @cp.add_rule!('body', 'color: blue;', :screen)
+    assert_equal 'color: black;', @cp.find_by_selector('body', :handheld).join(' ')
+  end
+
+  def atest_selecting_with_all_meda_type
+    @cp.add_rule!('body', 'color: black;', [:handheld,:tty])
+    assert_equal 'color: black;', @cp.find_by_selector('body', :all).join(' ')
+  end
+
+
+end

data/test/test_css_parser_misc.rb

@@ -0,0 +1,143 @@
+require File.dirname(__FILE__) + '/test_helper'
+
+# Test cases for the CssParser.
+class CssParserTests < Test::Unit::TestCase
+  include CssParser
+
+  def setup
+    @cp = Parser.new
+  end
+
+  def test_at_page_rule
+    # from http://www.w3.org/TR/CSS21/page.html#page-selectors
+    css = <<-EOT
+      @page { margin: 2cm }
+
+      @page :first {
+        margin-top: 10cm
+      }
+    EOT
+
+    @cp.add_block!(css)
+
+    assert_equal 'margin: 2cm;', @cp.find_by_selector('@page').join(' ')
+    assert_equal 'margin-top: 10cm;', @cp.find_by_selector('@page :first').join(' ')
+  end
+
+  def test_should_ignore_comments
+    # see http://www.w3.org/Style/CSS/Test/CSS2.1/current/html4/t040109-c17-comments-00-b.htm
+    css =<<-EOT
+      /* This is a CSS comment. */
+      .one {color: green;} /* Another comment */
+      /* The following should not be used:
+      .one {color: red;} */
+      .two {color: green; /* color: yellow; */}
+      /**
+      .three {color: red;} */
+      .three {color: green;}
+      /**/
+      .four {color: green;}
+      /*********/
+      .five {color: green;}
+      /* a comment **/
+      .six {color: green;}
+    EOT
+
+    @cp.add_block!(css)
+    @cp.each_selector do |sel, decs, spec|
+      assert_equal 'color: green;', decs
+    end
+  end
+
+  def test_parsing_blocks
+    # dervived from http://www.w3.org/TR/CSS21/syndata.html#rule-sets
+    css = <<-EOT
+      div[name='test'] {
+      
+      color:
+      
+      red;
+      
+      }div:hover{coloR:red;
+         }div:first-letter{color:red;/*color:blue;}"commented out"*/}
+      
+      p[example="public class foo\
+      {\
+          private string x;\
+      \
+          foo(int x) {\
+              this.x = 'test';\
+              this.x = \"test\";\
+          }\
+      \
+      }"] { color: red }
+      
+      p { color:red}
+    EOT
+
+    @cp.add_block!(css)
+
+    @cp.each_selector do |sel, decs, spec|
+      assert_equal 'color: red;', decs
+    end
+  end
+
+  def test_ignoring_malformed_declarations
+    flunk
+    # dervived from http://www.w3.org/TR/CSS21/syndata.html#parsing-errors
+    css = <<-EOT
+      p { color:green }
+      p { color:green; color }  /* malformed declaration missing ':', value */
+      p { color:red;   color; color:green }  /* same with expected recovery */
+      p { color:green; color: } /* malformed declaration missing value */
+      p { color:red;   color:; color:green } /* same with expected recovery */
+      p { color:green; color{;color:maroon} } /* unexpected tokens { } */
+      p { color:red;   color{;color:maroon}; color:green } /* same with recovery */
+    EOT
+
+    @cp.add_block!(css)
+
+    @cp.each_selector do |sel, decs, spec|
+      assert_equal 'color: green;', decs
+    end
+  end
+
+  def test_calculating_specificity
+    # from http://www.w3.org/TR/CSS21/cascade.html#specificity
+    assert_equal 0,   CssParser.calculate_specificity('*')
+    assert_equal 1,   CssParser.calculate_specificity('li')
+    assert_equal 2,   CssParser.calculate_specificity('li:first-line')
+    assert_equal 2,   CssParser.calculate_specificity('ul li')
+    assert_equal 3,   CssParser.calculate_specificity('ul ol+li')
+    assert_equal 11,  CssParser.calculate_specificity('h1 + *[rel=up]')
+    assert_equal 13,  CssParser.calculate_specificity('ul ol li.red')
+    assert_equal 21,  CssParser.calculate_specificity('li.red.level')
+    assert_equal 100, CssParser.calculate_specificity('#x34y')
+  
+    # from http://www.hixie.ch/tests/adhoc/css/cascade/specificity/003.html
+    assert_equal CssParser.calculate_specificity('div *'), CssParser.calculate_specificity('p')
+    assert CssParser.calculate_specificity('body div *') > CssParser.calculate_specificity('div *')
+
+    # other tests
+    assert_equal 11, CssParser.calculate_specificity('h1[id|=123]')
+  end
+
+  def test_converting_uris
+    base_uri = 'http://www.example.org/style/basic.css'
+    ["body { background: url(yellow) };", "body { background: url('yellow') };", 
+     "body { background: url('/style/yellow') };", 
+     "body { background: url(\"../style/yellow\") };",
+     "body { background: url(\"lib/../../style/yellow\") };"].each do |css|
+      converted_css = CssParser.convert_uris(css, base_uri)
+      assert_equal "body { background: url('http://www.example.org/style/yellow') };", converted_css
+    end
+
+    converted_css = CssParser.convert_uris("body { background: url(../style/yellow-dot_symbol$.png?abc=123&amp;def=456&ghi=789#1011) };", base_uri)
+    assert_equal "body { background: url('http://www.example.org/style/yellow-dot_symbol$.png?abc=123&amp;def=456&ghi=789#1011') };", converted_css
+  
+    # taken from error log: 2007-10-23 04:37:41#2399
+    converted_css = CssParser.convert_uris('.specs {font-family:Helvetica;font-weight:bold;font-style:italic;color:#008CA8;font-size:1.4em;list-style-image:url("images/bullet.gif");}', 'http://www.example.org/directory/file.html')
+    assert_equal ".specs {font-family:Helvetica;font-weight:bold;font-style:italic;color:#008CA8;font-size:1.4em;list-style-image:url('http://www.example.org/directory/images/bullet.gif');}", converted_css
+  end
+
+end

data/test/test_css_parser_regexps.rb

@@ -0,0 +1,69 @@
+# coding: iso-8859-1
+require 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