css_parser_master 1.2.4

data/lib/css_parser_master/selector.rb

@@ -0,0 +1,33 @@
+require 'css_parser_master/declaration_api'
+
+module CssParserMaster
+  class Selector
+    include CssParserMaster::DeclarationAPI
+
+    attr_accessor :selector, :declarations, :specificity
+    
+    def initialize(selector, declarations, specificity)
+      @selector = selector
+      @order = 0     
+      @declarations = {}
+      parse_declarations!(declarations)  
+      # puts "init @declarations: #{@declarations}"
+      @specificity = specificity 
+    end
+
+    def declarations_to_s(options = {})
+      # puts "declarations_to_s: #{declarations.inspect}"
+      s = declarations.map do |decl| 
+        decl[1].to_text
+      end.join('')
+      # puts "res: #{s}"
+      s
+    end
+
+    
+    def to_text
+      "#{selector}\n{\n#{declarations_to_s}\n} \n"
+    end
+
+  end
+end

data/lib/css_parser_master/selectors.rb

@@ -0,0 +1,27 @@
+module CssParserMaster
+  class Selectors
+    include Enumerable
+
+    attr_reader :selectors
+
+    def << selector
+      selectors << selector      
+    end
+
+    def all
+      map{|sel| sel.split(',') } 
+    end
+
+    def each
+      selectors.each { |sel| yield sel }
+    end
+
+    def empty?
+      selectors.empty?
+    end      
+
+    def initialize(selectors = []) 
+      @selectors = selectors
+    end  
+  end
+end

data/test/fixtures/import-circular-reference.css

@@ -0,0 +1,4 @@
+@import "import-circular-reference.css";
+
+body { color: black; background: white; }
+p { margin: 0px; }

data/test/fixtures/import-with-media-types.css

@@ -0,0 +1,3 @@
+@import "simple.css" print, tv, screen;
+
+div { color: lime; }

data/test/fixtures/import1.css

@@ -0,0 +1,3 @@
+@import 'subdir/import2.css';
+
+div { color: lime; }

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,84 @@
+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)
+    # @cp.selector_declarations do |sel, decl|
+    #   puts "sel: #{sel.inspect}"
+    #   puts "decl: #{decl.inspect}"      
+    # end        
+    
+    assert_equal 'margin: 0px;', @cp.find_by_selector('body').join
+  end
+
+  def test_adding_a_rule
+    @cp.add_rule!('div', 'color: blue;')
+
+    # @cp.selector_declarations do |sel, decl|
+    #   puts "sel: #{sel.inspect}"
+    #   puts "decl: #{decl.inspect}"      
+    # end    
+    
+    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_selector_declarations
+    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;')
+    @cp.add_rule_set!(rs)    
+    @cp.selector_declarations do |sel, decl|
+      # puts "sel: #{sel.to_text}"
+      # puts "decl: #{decl[1].to_text}"      
+    end    
+    # assert_equal(expected, actual)
+  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,151 @@
+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 a b{color: green;}
+      /*********/
+      .five a {color: green;}
+      /* a comment **/
+      .six {color: green;}
+    EOT
+
+    @cp.add_block!(css)
+    @cp.each_selector_sorted(:all, :order => :asc) do |sel|
+      # puts sel.inspect
+      assert_equal 'color: green;', sel.declarations_to_s
+    end
+
+    puts "DESCENDING specificity ORDER"
+    @cp.each_selector_sorted(:all, :order => :desc) do |sel|
+      # puts sel.inspect
+      assert_equal 'color: green;', sel.declarations_to_s
+    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|
+      assert_equal 'color: red;', sel.declarations_to_s
+    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|
+  #     assert_equal 'color: green;', sel.declarations
+  #   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