csspool 0.2.6 → 2.0.0

data/.autotest

@@ -0,0 +1,16 @@
+# -*- ruby -*-
+
+begin
+  require 'autotest/fsevent'
+rescue LoadError
+end
+
+Autotest.add_hook :run_command do |at|
+  at.unit_diff = 'cat'
+end
+
+Autotest.add_hook :ran_command do |at|
+  File.open('/tmp/autotest.txt', 'wb') { |f|
+    f.write(at.results.join)
+  }
+end

data/{CHANGELOG.txt → CHANGELOG.rdoc}

@@ -1,3 +1,13 @@
+== 2.0.0
+
+* Bugfixes
+
+  * Uh...  Many.
+
+* New Features
+
+  * Now wraps libcroco via FFI
+
 == 0.2.6
 
 * Fix comment greediness. [Seth Rasmussen]

data/Manifest.txt

@@ -1,78 +1,66 @@
-CHANGELOG.txt
+.autotest
+CHANGELOG.rdoc
 Manifest.txt
-README.txt
+README.rdoc
 Rakefile
-lib/css/sac.rb
-lib/css/sac/conditions.rb
-lib/css/sac/conditions/attribute_condition.rb
-lib/css/sac/conditions/begin_hyphen_condition.rb
-lib/css/sac/conditions/class_condition.rb
-lib/css/sac/conditions/combinator_condition.rb
-lib/css/sac/conditions/condition.rb
-lib/css/sac/conditions/id_condition.rb
-lib/css/sac/conditions/one_of_condition.rb
-lib/css/sac/conditions/pseudo_class_condition.rb
-lib/css/sac/document_handler.rb
-lib/css/sac/error_handler.rb
-lib/css/sac/generated_parser.rb
-lib/css/sac/generated_property_parser.rb
-lib/css/sac/lexeme.rb
-lib/css/sac/lexical_unit.rb
-lib/css/sac/parse_exception.rb
-lib/css/sac/parser.rb
-lib/css/sac/property_parser.rb
-lib/css/sac/selectors.rb
-lib/css/sac/selectors/child_selector.rb
-lib/css/sac/selectors/conditional_selector.rb
-lib/css/sac/selectors/descendant_selector.rb
-lib/css/sac/selectors/element_selector.rb
-lib/css/sac/selectors/selector.rb
-lib/css/sac/selectors/sibling_selector.rb
-lib/css/sac/selectors/simple_selector.rb
-lib/css/sac/token.rb
-lib/css/sac/tokenizer.rb
-lib/css/sac/visitable.rb
-lib/css/stylesheet.rb
-lib/css/stylesheet/rule.rb
-lib/css/stylesheet/stylesheet.rb
 lib/csspool.rb
-lib/parser.y
-lib/property_parser.y
-lib/property_parser.y.erb
-test/condition_test_case.rb
+lib/csspool/collection.rb
+lib/csspool/css.rb
+lib/csspool/css/charset.rb
+lib/csspool/css/declaration.rb
+lib/csspool/css/document.rb
+lib/csspool/css/document_handler.rb
+lib/csspool/css/import_rule.rb
+lib/csspool/css/media.rb
+lib/csspool/css/rule_set.rb
+lib/csspool/lib_croco.rb
+lib/csspool/lib_croco/cr_additional_sel.rb
+lib/csspool/lib_croco/cr_attr_sel.rb
+lib/csspool/lib_croco/cr_doc_handler.rb
+lib/csspool/lib_croco/cr_num.rb
+lib/csspool/lib_croco/cr_parser.rb
+lib/csspool/lib_croco/cr_parsing_location.rb
+lib/csspool/lib_croco/cr_pseudo.rb
+lib/csspool/lib_croco/cr_rgb.rb
+lib/csspool/lib_croco/cr_selector.rb
+lib/csspool/lib_croco/cr_simple_sel.rb
+lib/csspool/lib_croco/cr_term.rb
+lib/csspool/lib_croco/glist.rb
+lib/csspool/node.rb
+lib/csspool/sac.rb
+lib/csspool/sac/document.rb
+lib/csspool/sac/parser.rb
+lib/csspool/selector.rb
+lib/csspool/selectors.rb
+lib/csspool/selectors/additional.rb
+lib/csspool/selectors/attribute.rb
+lib/csspool/selectors/class.rb
+lib/csspool/selectors/id.rb
+lib/csspool/selectors/pseudo_class.rb
+lib/csspool/selectors/simple.rb
+lib/csspool/selectors/type.rb
+lib/csspool/selectors/universal.rb
+lib/csspool/terms.rb
+lib/csspool/terms/function.rb
+lib/csspool/terms/hash.rb
+lib/csspool/terms/ident.rb
+lib/csspool/terms/number.rb
+lib/csspool/terms/rgb.rb
+lib/csspool/terms/string.rb
+lib/csspool/terms/uri.rb
+lib/csspool/visitable.rb
+lib/csspool/visitors.rb
+lib/csspool/visitors/comparable.rb
+lib/csspool/visitors/to_css.rb
+lib/csspool/visitors/visitor.rb
+test/css/test_document.rb
+test/css/test_import_rule.rb
 test/helper.rb
-test/selector_test_case.rb
-test/test_all.rb
-test/test_attribute_condition.rb
-test/test_begin_hyphen_condition.rb
-test/test_child_selector.rb
-test/test_class_condition.rb
-test/test_combinator_condition.rb
-test/test_condition.rb
-test/test_conditional_selector.rb
-test/test_descendant_selector.rb
-test/test_element_selector.rb
-test/test_error_recovery.rb
-test/test_id_condition.rb
-test/test_lexeme.rb
-test/test_lexical_color.rb
-test/test_lexical_function.rb
-test/test_lexical_ident.rb
-test/test_lexical_number.rb
-test/test_lexical_string.rb
-test/test_lexical_unit.rb
-test/test_lexical_uri.rb
-test/test_one_of_condition.rb
-test/test_parse_error.rb
+test/sac/test_parser.rb
+test/sac/test_properties.rb
+test/sac/test_terms.rb
+test/test_collection.rb
 test/test_parser.rb
-test/test_property_parser.rb
 test/test_selector.rb
-test/test_selector_as_string.rb
-test/test_selector_parser.rb
-test/test_sibling_selector.rb
-test/test_simple_selector.rb
-test/test_specificity.rb
-test/test_stylesheet.rb
-test/test_token.rb
-test/test_tokenizer.rb
-test/test_xpath.rb
+test/visitors/test_comparable.rb
+test/visitors/test_to_css.rb

data/README.rdoc

@@ -0,0 +1,78 @@
+= CSSPool
+
+* http://csspool.rubyforge.org
+* http://github.com/tenderlove/csspool
+
+== DESCRIPTION:
+
+CSSPool is a CSS parser.  CSSPool provides a SAC interface for parsing CSS as
+well as a document oriented interface for parsing CSS.
+
+== FEATURES/PROBLEMS:
+
+CSSPool now depends on libcroco[http://www.freespiders.org/projects/libcroco/]
+and interfaces with libcroco via FFI.  This means that if libcroco isn't
+installed in one of your default library paths, you'll need to tell CSSPool
+where to find the libcroco shared library.  This is typically the case for
+people using OS X and installing libcroco via macports.
+
+You can tell CSSPool where to find the libcroco shared library in a couple ways.
+The first way is to set LD_LIBRARY_PATH to point at the correct directory.  Just
+do this:
+
+  $ export LD_LIBRARY_PATH=/opt/local/lib
+
+Then run your script.
+
+The second way is to tell CSSPool specifically where to find the dynamic
+library.  To do that, just set the LIBCROCO environment variable.  On OS X,
+I would do this:
+
+  $ export LIBCROCO=/opt/local/lib/libcroco-0.6.dylib
+
+Then run my script.
+
+== SYNOPSIS:
+
+  doc = CSSPool.CSS open('/path/to/css.css')
+  doc.rule_sets.each do |rs|
+    puts rs.to_css
+  end
+
+  puts doc.to_css
+
+== REQUIREMENTS:
+
+* libcroco (on OS X do "sudo port install libcroco")
+
+== INSTALL:
+
+* sudo gem install csspool
+
+== LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2007-2009
+
+* {Aaron Patterson}[http://tenderlovemaking.com]
+* {John Barnette}[http://www.jbarnette.com/]
+
+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/Rakefile

@@ -1,57 +1,14 @@
+# -*- ruby -*-
+
 require 'rubygems'
-require 'erb'
 require 'hoe'
 
-$LOAD_PATH.unshift File.join(File.dirname(__FILE__), "lib")
-
-GENERATED_PARSER = "lib/css/sac/generated_parser.rb"
-GENERATED_PROPERTY_PARSER = "lib/css/sac/generated_property_parser.rb"
-
-Hoe.new('csspool', "0.2.6") do |p|
-  p.rubyforge_name  = 'csspool'
-  p.author          = 'Aaron Patterson'
-  p.email           = 'aaronp@rubyforge.org'
-  p.summary         = "Parses CSS"
-  p.description     = p.paragraphs_of('README.txt', 3).join("\n\n")
-  p.url             = p.paragraphs_of('README.txt', 1).first.strip
-  p.changes         = p.paragraphs_of('CHANGELOG.txt', 0..1).join("\n\n")
-  p.clean_globs     = [GENERATED_PARSER, GENERATED_PROPERTY_PARSER]
-end
-
-class Array
-  def permutations
-    return [self] if size < 2
-    perm = []
-    each { |e| (self - [e]).permutations.each { |p| perm << ([e] + p) } }
-    perm
-  end
-
-  def permute_all_combinations
-    list = []
-    permutations.each do |perm|
-      while perm.length > 0
-        list << perm.dup
-        perm.shift
-      end
-    end
-    list.uniq.sort_by { |x| x.length }.reverse
-  end
+Hoe.spec('csspool') do
+  developer('Aaron Patterson', 'aaronp@rubyforge.org')
+  developer('John Barnette', 'jabarnette@rubyforge.org')
+  self.readme_file   = 'README.rdoc'
+  self.history_file  = 'CHANGELOG.rdoc'
+  self.extra_deps = ['ffi']
 end
 
-file GENERATED_PARSER => "lib/parser.y" do |t|
-  sh "racc -o #{t.name} #{t.prerequisites.first}"
-end
-
-file GENERATED_PROPERTY_PARSER => "lib/property_parser.y.erb" do |t|
-  template = ERB.new(File.open(t.prerequisites.first, 'rb') { |x| x.read })
-  File.open("lib/property_parser.y", 'wb') { |f|
-    f.write template.result(binding)
-  }
-  sh "racc -o #{t.name} lib/property_parser.y"
-end
-
-task :parser => [GENERATED_PARSER, GENERATED_PROPERTY_PARSER]
-
-# make sure the parser's up-to-date when we test
-Rake::Task[:test].prerequisites << :parser
-Rake::Task[:check_manifest].prerequisites << :parser
+# vim: syntax=Ruby

data/lib/csspool/collection.rb

@@ -0,0 +1,50 @@
+module CSSPool
+  class Collection
+    include Enumerable
+
+    def initialize &block
+      @docs   = []
+      @block  = block
+    end
+
+    def << string
+      doc = CSSPool.CSS string
+
+      import_tree = [[doc]]
+
+      imported_urls = {}
+
+      until import_tree.last.all? { |x| x.import_rules.length == 0 }
+        level = import_tree.last
+        import_tree << []
+        level.each do |doc|
+          doc.import_rules.each do |ir|
+            next if imported_urls.key? ir.uri
+
+            new_doc = ir.load(&@block)
+
+            imported_urls[ir.uri] = ir.load(&@block)
+            import_tree.last << new_doc
+          end
+        end
+      end
+
+      @docs += import_tree.flatten.reverse
+      self
+    end
+
+    def length
+      @docs.length
+    end
+
+    def [] idx
+      @docs[idx]
+    end
+
+    def each &block
+      @docs.each(&block)
+    end
+
+    def last; @docs.last; end
+  end
+end

data/lib/csspool/css/charset.rb

@@ -0,0 +1,7 @@
+module CSSPool
+  module CSS
+    class Charset < Struct.new(:name, :parse_location)
+      include CSSPool::Visitable
+    end
+  end
+end

data/lib/csspool/css/declaration.rb

@@ -0,0 +1,8 @@
+module CSSPool
+  module CSS
+    class Declaration < Struct.new(:property, :expressions, :important, :rule_set)
+      include CSSPool::Visitable
+      alias :important? :important
+    end
+  end
+end

data/lib/csspool/css/document.rb

@@ -0,0 +1,34 @@
+module CSSPool
+  module CSS
+    class Document < Node
+      def self.parse string
+        unless string && string.length > 0
+          return CSSPool::CSS::Document.new
+        end
+        handler = CSSPool::CSS::DocumentHandler.new
+        parser = CSSPool::SAC::Parser.new(handler)
+        parser.parse(string)
+        handler.document
+      end
+
+      attr_accessor :rule_sets
+      attr_accessor :charsets
+      attr_accessor :import_rules
+      attr_accessor :parent
+      attr_accessor :parent_import_rule
+
+      def initialize
+        @rule_sets    = []
+        @charsets     = []
+        @import_rules = []
+        @parent       = nil
+        @parent_import_rule = nil
+      end
+
+      def [] selector
+        selectors = CSSPool.CSS("#{selector} {}").rule_sets.first.selectors
+        rule_sets.find_all { |rs| rs.selectors == selectors}
+      end
+    end
+  end
+end

data/lib/csspool/css/document_handler.rb

@@ -0,0 +1,51 @@
+module CSSPool
+  module CSS
+    class DocumentHandler < CSSPool::SAC::Document
+      attr_accessor :document
+
+      def initialize
+        @document     = nil
+        @media_stack  = []
+      end
+
+      def start_document
+        @document = CSSPool::CSS::Document.new
+      end
+
+      def charset name, location
+        @document.charsets << CSS::Charset.new(name, location)
+      end
+
+      def import_style media_list, uri, ns, loc
+        @document.import_rules << CSS::ImportRule.new(
+          uri,
+          ns,
+          media_list.map { |x| CSS::Media.new(x, loc) },
+          @document,
+          loc
+        )
+      end
+
+      def start_selector selector_list
+        @document.rule_sets << RuleSet.new(
+          selector_list,
+          [],
+          @media_stack.last || []
+        )
+      end
+
+      def property name, exp, important
+        rs = @document.rule_sets.last
+        rs.declarations << Declaration.new(name, exp, important, rs)
+      end
+
+      def start_media media_list, parse_location
+        @media_stack << media_list.map { |x| CSS::Media.new(x, parse_location) }
+      end
+
+      def end_media media_list, parse_location
+        @media_stack.pop
+      end
+    end
+  end
+end

data/lib/csspool/css/import_rule.rb

@@ -0,0 +1,15 @@
+module CSSPool
+  module CSS
+    class ImportRule < Struct.new(:uri, :namespace, :media, :document, :parse_location)
+      include CSSPool::Visitable
+
+      def load
+        new_doc = CSSPool.CSS(yield uri)
+        new_doc.parent_import_rule = self
+        new_doc.parent = document
+        new_doc.rule_sets.each { |rs| rs.media = media }
+        new_doc
+      end
+    end
+  end
+end

data/lib/csspool/css/media.rb

@@ -0,0 +1,7 @@
+module CSSPool
+  module CSS
+    class Media < Struct.new(:name, :parse_location)
+      include CSSPool::Visitable
+    end
+  end
+end

data/lib/csspool/css/rule_set.rb

@@ -0,0 +1,12 @@
+module CSSPool
+  module CSS
+    class RuleSet < Struct.new(:selectors, :declarations, :media)
+      include CSSPool::Visitable
+
+      def initialize selectors, declarations = [], media = []
+        selectors.each { |sel| sel.rule_set = self }
+        super
+      end
+    end
+  end
+end

data/lib/csspool/css.rb

@@ -0,0 +1,7 @@
+require 'csspool/css/charset'
+require 'csspool/css/import_rule'
+require 'csspool/css/media'
+require 'csspool/css/rule_set'
+require 'csspool/css/declaration'
+require 'csspool/css/document'
+require 'csspool/css/document_handler'

data/lib/csspool/lib_croco/cr_additional_sel.rb

@@ -0,0 +1,46 @@
+module CSSPool
+  module LibCroco
+    class CRAdditionalSel < FFI::Struct
+      layout(
+        :sel_type,    :int,
+        :content,     :pointer,
+        :next,        :pointer,
+        :prev,        :pointer,
+        :line,        :int,
+        :column,      :int,
+        :byte_offset, :int
+      )
+
+      def to_additional_selector
+        case self[:sel_type]
+        when 1      # CLASS_ADD_SELECTOR
+          CSSPool::Selectors::Class.new(
+            LibCroco.cr_string_peek_raw_str(self[:content]).read_string
+          )
+        when 1 << 1 # PSEUDO_CLASS_ADD_SELECTOR
+          pseudo = CRPseudo.new(self[:content])
+          CSSPool::Selectors::PseudoClass.new(
+            pseudo[:name].null? ? nil :
+              LibCroco.cr_string_peek_raw_str(pseudo[:name]).read_string,
+            pseudo[:extra].null? ? nil :
+              LibCroco.cr_string_peek_raw_str(pseudo[:extra]).read_string
+          )
+        when 1 << 3 # ID_ADD_SELECTOR
+          CSSPool::Selectors::Id.new(
+            LibCroco.cr_string_peek_raw_str(self[:content]).read_string
+          )
+        when 1 << 4 # ATTRIBUTE_ADD_SELECTOR
+          attr_sel = CRAttrSel.new(self[:content])
+          raise "FIXME: additional add selectors" unless attr_sel[:next].null?
+          CSSPool::Selectors::Attribute.new(
+            attr_sel[:name].null? ? nil :
+              LibCroco.cr_string_peek_raw_str(attr_sel[:name]).read_string,
+            attr_sel[:value].null? ? nil :
+              LibCroco.cr_string_peek_raw_str(attr_sel[:value]).read_string,
+            attr_sel[:match_way]
+          )
+        end
+      end
+    end
+  end
+end

data/lib/csspool/lib_croco/cr_attr_sel.rb

@@ -0,0 +1,16 @@
+module CSSPool
+  module LibCroco
+    class CRAttrSel < FFI::Struct
+      layout(
+        :name,        :pointer,
+        :value,       :pointer,
+        :match_way,   :int,
+        :next,        :pointer,
+        :prev,        :pointer,
+        :line,        :int,
+        :column,      :int,
+        :byte_offset, :int
+      )
+    end
+  end
+end

data/lib/csspool/lib_croco/cr_doc_handler.rb

@@ -0,0 +1,24 @@
+module CSSPool
+  module LibCroco
+    class CRDocHandler < FFI::Struct
+      layout(
+        :priv,                  :pointer,
+        :app_data,              :pointer,
+        :start_document,        :start_document,
+        :end_document,          :end_document,
+        :charset,               :charset,
+        :import_style,          :import_style,
+        :import_style_result,   :import_style_result,
+        :namespace_declaration, :namespace_declaration,
+        :comment,               :comment,
+        :start_selector,        :start_selector,
+        :end_selector,          :end_selector,
+        :property,              :property,
+        :start_font_face,       :start_font_face,
+        :end_font_face,         :end_font_face,
+        :start_media,           :start_media,
+        :end_media,             :end_media
+      )
+    end
+  end
+end

data/lib/csspool/lib_croco/cr_num.rb

@@ -0,0 +1,13 @@
+module CSSPool
+  module LibCroco
+    class CRNum < FFI::Struct
+      layout(
+        :type,  :int,
+        :value, :double,
+        :line,        :int,
+        :column,      :int,
+        :byte_offset, :int
+      )
+    end
+  end
+end

data/lib/csspool/lib_croco/cr_parser.rb

@@ -0,0 +1,11 @@
+module CSSPool
+  module LibCroco
+    class CRParser < FFI::Struct
+      layout(:priv, :pointer)
+
+      #def self.release pointer
+      #  CSSPool::LibCroco.cr_parser_destroy pointer
+      #end
+    end
+  end
+end

data/lib/csspool/lib_croco/cr_parsing_location.rb

@@ -0,0 +1,17 @@
+module CSSPool
+  module LibCroco
+    class CRParsingLocation < FFI::Struct
+      layout(
+        :line,        :uint,
+        :column,      :uint,
+        :byte_offset, :uint
+      )
+
+      def to_h
+        Hash[*[:line, :column, :byte_offset].map { |k|
+          [k, self[k]]
+        }.flatten]
+      end
+    end
+  end
+end

data/lib/csspool/lib_croco/cr_pseudo.rb

@@ -0,0 +1,14 @@
+module CSSPool
+  module LibCroco
+    class CRPseudo < FFI::Struct
+      layout(
+        :pseudo_type, :int,
+        :name,        :pointer,
+        :extra,       :pointer,
+        :line,        :int,
+        :column,      :int,
+        :byte_offset, :int
+      )
+    end
+  end
+end