css_parser_master 1.2.4

data/.gitignore

@@ -0,0 +1,4 @@
+doc/*
+pkg/*
+css_parser-*.gem
+*.DS_Store

data/CHANGELOG

@@ -0,0 +1,34 @@
+=== Ruby CSS Parser CHANGELOG
+
+==== Version 1.1.2
+ * Extracted declarations API from RuleSet
+ * Added declarations API to both RuleSet and Selector classes
+ * Tests still work!
+
+TODO
+Use enumerables Declarations and Selectors instead of simple string arrays for much greater power and flexibility! 
+
+==== Version 1.1.1
+ * Encapsulated selector into its own class
+ * Encapsulated declaration into its own class
+ * Gem now uses Jewler (new Rakefile.rb created)
+ * All tests work with new selector and declaration iteration strategies which now returns a Selector and Declaration instance
+ 
+==== Version 1.1.0
+ * Added support for local @import
+ * Better remote @import handling
+
+==== Version 1.0.1
+ * Fallback for declartions without sort order
+
+==== Version 1.0.0
+ * Various test fixes and udpate for Ruby 1.9 (thanks to Tyler Cunnion)
+ * Allow setting CSS declarations to nil
+
+==== Version 0.9
+ * Initial version forked from Premailer project
+
+==== TODO: Future
+ * border shorthand/folding support
+ * re-implement caching on CssParser.merge
+ * correctly parse http://www.webstandards.org/files/acid2/test.html

data/LICENSE

@@ -0,0 +1,21 @@
+=== Ruby CSS Parser Master License
+
+Copyright (c) 2010-05 Kristian Mandrup
+
+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.rdoc

@@ -0,0 +1,77 @@
+= Ruby CSS Parser
+
+Load, parse and cascade CSS rule sets in Ruby.
+
+=== Setup
+
+Install the gem.
+
+   gem install css_parser
+
+Done.
+
+=== An example
+  require 'css_parser_master'
+  include CssParserMaster
+
+  parser = CssParserMaster::Parser.new
+  parser.load_uri!('http://example.com/styles/style.css')
+
+  # load a remote file, setting the base_uri and media_types
+  parser.load_uri!('../style.css', 'http://example.com/styles/inc/', [:screen, :handheld])
+  
+  # load a local file, setting the base_dir and media_types
+  parser.load_file!('print.css', '~/styles/', :print)
+
+  # lookup a rule by a selector
+  parser.find('#content')
+  #=> 'font-size: 13px; line-height: 1.2;'
+
+  # lookup a rule by a selector and media type
+  parser.find('#content', [:screen, :handheld])
+
+  # iterate through selectors by media type
+  parser.each_selector(:screen) do |sel|
+    puts sel
+    puts sel.selector
+    puts sel.declarations
+    puts sel.specificity
+    ...
+  end
+  
+  # add a block of CSS
+  css = <<-EOT
+    body { margin: 0 1em; }
+  EOT
+
+  parser.add_block!(css)
+
+  # output all CSS rules in a single stylesheet
+  parser.to_s
+  => #content { font-size: 13px; line-height: 1.2; }
+     body { margin: 0 1em; }
+
+=== Testing
+
+You can run the suite of unit tests using <tt>rake test</tt>.
+
+The download/import tests use WEBrick.  The tests set up
+a temporary server on port 12000 and pull down files from the <tt>test/fixtures/</tt> 
+directory.
+
+=== Design notes
+
+The extensions that come with CssParserMaster were created in order to generate a more 'powerful' parse model. 
+This model should provide more powerful and intuitive ways of iterating and operating on the model.
+Mainly Selector and Declaration were added as classes instead of the old version where they were simply hashes and strings. 
+
+=== Credits and code
+
+Original CssParser by Alex Dunae (dunae.ca, e-mail 'code' at the same domain), 2007-10.
+CssParserMaster was created by Kristian Mandrup as an extension of CssParser in order to allow releases of the updated gem with some improvements.
+
+Original project homepage: http://github.com/alexdunae/css_parser
+
+Thanks to {Tyler Cunnion}[http://github.com/tylercunnion] for the updates leading to 1.0.0.
+
+Made on Vancouver Island.

data/Rakefile.rb

@@ -0,0 +1,18 @@
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "css_parser_master"
+    gem.summary = %Q{Parse CSS files, access and operate on a model of the CSS rules}
+    gem.description = %Q{Parse a CSS file and access/operate on rulesets, selectors, declarations etc. Includes specificity calculated according to W3C spec.}
+    gem.email = "kmandrup@gmail.com"
+    gem.homepage = "http://github.com/kristianmandrup/load-me"
+    gem.authors = ["Kristian Mandrup", "Alex Dunae"]
+    # gem.add_development_dependency "rspec", ">= 2.0.0"
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+    
+    # add more gem options here    
+  end   
+  Jeweler::GemcutterTasks.new  
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+end

data/VERSION

@@ -0,0 +1 @@
+1.2.4

data/lib/css_parser_master.rb

@@ -0,0 +1,156 @@
+require 'uri'
+require 'digest/md5'
+require 'zlib'
+require 'iconv'
+
+module CssParserMaster
+  VERSION = '1.2.5'
+
+  # Merge multiple CSS RuleSets by cascading according to the CSS 2.1 cascading rules 
+  # (http://www.w3.org/TR/REC-CSS2/cascade.html#cascading-order).
+  #
+  # Takes one or more RuleSet objects.
+  #
+  # Returns a RuleSet.
+  #
+  # ==== Cascading
+  # If a RuleSet object has its +specificity+ defined, that specificity is 
+  # used in the cascade calculations.  
+  #
+  # If no specificity is explicitly set and the RuleSet has *one* selector, 
+  # the specificity is calculated using that selector.
+  #
+  # If no selectors or multiple selectors are present, the specificity is 
+  # treated as 0.
+  #
+  # ==== Example #1
+  #   rs1 = RuleSet.new(nil, 'color: black;')
+  #   rs2 = RuleSet.new(nil, 'margin: 0px;')
+  #
+  #   merged = CssParserMaster.merge(rs1, rs2)
+  #
+  #   puts merged
+  #   => "{ margin: 0px; color: black; }"
+  #
+  # ==== Example #2
+  #   rs1 = RuleSet.new(nil, 'background-color: black;')
+  #   rs2 = RuleSet.new(nil, 'background-image: none;')
+  #
+  #   merged = CssParserMaster.merge(rs1, rs2)
+  #
+  #   puts merged
+  #   => "{ background: none black; }"
+  #--
+  # TODO: declaration_hashes should be able to contain a RuleSet
+  #       this should be a Class method
+  def self.merge(*rule_sets)
+    @folded_declaration_cache = {}
+
+    # in case called like CssParser.merge([rule_set, rule_set])
+    rule_sets.flatten! if rule_sets[0].kind_of?(Array)
+    
+    unless rule_sets.all? {|rs| rs.kind_of?(CssParser::RuleSet)}
+      raise ArgumentError, "all parameters must be CssParser::RuleSets."
+    end
+
+    return rule_sets[0] if rule_sets.length == 1
+
+    # Internal storage of CSS properties that we will keep
+    properties = {}
+
+    rule_sets.each do |rule_set|
+      rule_set.expand_shorthand!
+      
+      specificity = rule_set.specificity
+      unless specificity
+        if rule_set.selectors.length == 1
+          specificity = calculate_specificity(rule_set.selectors[0])
+        else
+          specificity = 0
+        end
+      end
+
+      rule_set.each_declaration do |decl|
+        
+        property = decl.property
+        value = decl.value
+        is_important = decl.important
+        
+        # Add the property to the list to be folded per http://www.w3.org/TR/CSS21/cascade.html#cascading-order
+        if not properties.has_key?(decl.property) or
+               is_important or # step 2
+               properties[property][:specificity] < specificity or # step 3
+               properties[property][:specificity] == specificity # step 4    
+          properties[property] = {:value => value, :specificity => specificity, :is_important => is_important}            
+        end
+      end
+    end
+
+    merged = RuleSet.new(nil, nil)
+
+    # TODO: what about important
+    properties.each do |property, details|
+      merged[property.strip] = details[:value].strip
+    end
+
+    merged.create_shorthand!
+    merged
+  end
+
+  # Calculates the specificity of a CSS selector
+  # per http://www.w3.org/TR/CSS21/cascade.html#specificity
+  #
+  # Returns an integer.
+  #
+  # ==== Example
+  #  CssParser.calculate_specificity('#content div p:first-line a:link')
+  #  => 114
+  #--
+  # Thanks to Rafael Salazar and Nick Fitzsimons on the css-discuss list for their help.
+  #++
+  def self.calculate_specificity(selector)
+    a = 0
+    b = selector.scan(/\#/).length
+    c = selector.scan(NON_ID_ATTRIBUTES_AND_PSEUDO_CLASSES_RX).length
+    d = selector.scan(ELEMENTS_AND_PSEUDO_ELEMENTS_RX).length
+
+    (a.to_s + b.to_s + c.to_s + d.to_s).to_i
+  rescue
+    return 0
+  end
+
+  # Make <tt>url()</tt> links absolute.
+  #
+  # Takes a block of CSS and returns it with all relative URIs converted to absolute URIs.
+  #
+  # "For CSS style sheets, the base URI is that of the style sheet, not that of the source document."
+  # per http://www.w3.org/TR/CSS21/syndata.html#uri
+  #
+  # Returns a string.
+  #
+  # ==== Example
+  #  CssParser.convert_uris("body { background: url('../style/yellow.png?abc=123') };", 
+  #               "http://example.org/style/basic.css").inspect
+  #  => "body { background: url('http://example.org/style/yellow.png?abc=123') };"
+  def self.convert_uris(css, base_uri)
+    out = ''
+    base_uri = URI.parse(base_uri) unless base_uri.kind_of?(URI)
+
+    out = css.gsub(URI_RX) do |s|
+      uri = $1.to_s
+      uri.gsub!(/["']+/, '')
+      # Don't process URLs that are already absolute
+      unless uri =~ /^[a-z]+\:\/\//i
+        begin
+          uri = base_uri.merge(uri) 
+        rescue; end
+      end
+      "url('" + uri.to_s + "')"
+    end
+    out
+  end
+end
+
+require File.dirname(__FILE__) + '/css_parser_master/rule_set'
+require File.dirname(__FILE__) + '/css_parser_master/regexps'
+require File.dirname(__FILE__) + '/css_parser_master/parser'

data/lib/css_parser_master/declaration.rb

@@ -0,0 +1,31 @@
+module CssParserMaster
+  class Declaration
+    attr_accessor :property, :value, :important, :order
+    
+    def initialize(property, value, important = false, order = 0)
+      # puts "init new declaration: #{property}"
+      @property = property
+      @value = value
+      @important = important
+      @order = order            
+    end
+
+    def [] index
+      case index
+      when :value
+        value
+      when :order
+        order
+      when :is_important
+        important
+      when :property
+        property
+      end
+    end        
+    
+    def to_text(importance = nil)
+      "#{property}: #{value}#{ ' !important' if important || importance};"
+    end
+      
+  end
+end

data/lib/css_parser_master/declaration_api.rb

@@ -0,0 +1,91 @@
+module CssParserMaster
+  module DeclarationAPI
+
+    def ensure_valid_declarations! 
+      @declarations.each do |d|
+        name = d[0]
+        prop = d[1]
+        if prop.kind_of? Hash
+          value = prop[:value]
+          important = prop[:is_important]
+          @declarations[d[0]] = Declaration.new(name, value, important, @order += 1)
+        end
+      end
+    end
+          
+
+    def each_declaration # :yields: property, value, is_important      
+      ensure_valid_declarations!       
+      decs = @declarations.sort { |a,b| a[1].order <=> b[1].order }
+      # puts "decs: #{decs.inspect}"
+      decs.each do |decl|
+        yield decl[1]
+      end
+    end
+
+
+    # Return all declarations as a string.
+    #--
+    # TODO: Clean-up regexp doesn't seem to work
+    #++
+    def declarations_to_s(options = {})
+     options = {:force_important => false}.merge(options)
+     str = ''
+     importance = options[:force_important] # ? ' !important' : ''
+     self.each_declaration do |decl| 
+       str += "#{decl.to_text(importance)}"
+     end                     
+     str.gsub(/^[\s]+|[\n\r\f\t]*|[\s]+$/mx, '').strip
+    end
+
+
+    # Add a CSS declaration to the current RuleSet.
+    #
+    #  rule_set.add_declaration!('color', 'blue')
+    #
+    #  puts rule_set['color']
+    #  => 'blue;'
+    #
+    #  rule_set.add_declaration!('margin', '0px auto !important')
+    #
+    #  puts rule_set['margin']
+    #  => '0px auto !important;'
+    #
+    # If the property already exists its value will be over-written.
+    def add_declaration!(property, value)        
+      if value.nil? or value.empty?
+        @declarations.delete(property)
+        return
+      end
+    
+      value.gsub!(/;\Z/, '')
+      is_important = !value.gsub!(CssParserMaster::IMPORTANT_IN_PROPERTY_RX, '').nil?
+      property = property.downcase.strip
+                                
+      decl = CssParserMaster::Declaration.new property.downcase.strip, value.strip, is_important, @order += 1
+      # puts "new decl: #{decl.inspect}, #{decl.class}"
+      @declarations[property] = decl 
+    end
+    alias_method :[]=, :add_declaration!
+
+    def parse_declarations!(block) # :nodoc: 
+      @declarations ||= {}  
+
+      return unless block
+
+      block.gsub!(/(^[\s]*)|([\s]*$)/, '')
+
+      decs = block.split(/[\;$]+/m)
+
+      decs.each do |decs|
+        if matches = decs.match(/(.[^:]*)\:(.[^;]*)(;|\Z)/i)              
+          property, value, end_of_declaration = matches.captures
+
+          # puts "parse - property: #{property} , value: #{value}"
+          add_declaration!(property, value)          
+        end
+      end
+      
+    end  
+  end
+end

data/lib/css_parser_master/declarations.rb

@@ -0,0 +1,23 @@
+module CssParserMaster
+  class Declarations
+    include Enumerable
+
+    attr_reader :declarations
+
+    def << declaration
+      declarations << declaration      
+    end
+
+    def each
+      @declarations.each { |dec| yield dec }
+    end
+
+    def empty?
+      declarations.empty?
+    end      
+
+    def initialize(declarations)
+      @declarations = declarations
+    end  
+  end
+end