csspool 0.1.0

data/CHANGELOG.txt

@@ -0,0 +1,4 @@
+== 0.1.0
+
+* Birthday!
+

data/Manifest.txt

@@ -0,0 +1,32 @@
+CHANGELOG.txt
+Manifest.txt
+README.txt
+Rakefile
+lib/css/sac.rb
+lib/css/sac/attribute_condition.rb
+lib/css/sac/condition.rb
+lib/css/sac/document_handler.rb
+lib/css/sac/error_handler.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/token.rb
+lib/css/sac/tokenizer.rb
+lib/parser.y
+lib/property_parser.y
+lib/property_parser.y.erb
+test/helper.rb
+test/test_all.rb
+test/test_lexeme.rb
+test/test_lexical_unit.rb
+test/test_parse_error.rb
+test/test_parser.rb
+test/test_property_parser.rb
+test/test_selector_as_string.rb
+test/test_selector_parser.rb
+test/test_token.rb
+test/test_tokenizer.rb

data/README.txt

@@ -0,0 +1,71 @@
+= CSSpool
+
+  http://csspool.rubyforge.org/
+
+== Description
+
+CSSpool (pronounced "cesspool") is a validating SAC parser for CSS.  The parser
+calls methods on a document handler depending on what it has found. CSSPool
+currently only supports CSS 2.1.  CSSPool will not yield invalid properties or
+selectors.
+
+== Dependencies
+
+Building CSSpool requires:
+
+  - RACC (not just the runtime)
+    (http://i.loveruby.net/en/projects/racc)
+
+  - rubygems, hoe, flexmock
+
+== Example
+
+This example prints out all properties from a particular CSS file.
+
+  class DH < CSS::SAC::DocumentHandler
+    def start_selector(selectors)
+      puts selectors.map { |x| x.to_css }.join(', ')
+    end
+
+    def property(name, value, important)
+      puts "#{name} #{value.join(', ')} #{important}"
+    end
+  end
+  
+  token = CSS::SAC::Parser.new(DH.new)
+  token.parse(File.read(ARGV[0]))
+
+See CSS::SAC::DocumentHandler for callbacks to implement.
+
+See SAC[http://www.w3.org/Style/CSS/SAC/] for more information on SAC.
+
+== Authors
+
+* Aaron Patterson[http://tenderlovemaking.com/] <aaronp@rubyforge.com>
+* John Barnette
+
+== LICENSE
+
+(The MIT License)
+
+Copyright (c) 2007 Aaron Patterson, John Barnette
+
+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

@@ -0,0 +1,56 @@
+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.1.0') 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..2).join("\n\n")
+  p.clean_globs     = [GENERATED_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
+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

data/lib/css/sac/attribute_condition.rb

@@ -0,0 +1,78 @@
+module CSS
+  module SAC
+    class AttributeCondition < Condition
+      attr_accessor :local_name, :value, :specified
+      alias :specified? :specified
+
+      class << self
+        def pseudo_class_condition(pseudo_class)
+          self.new do |condition|
+            condition.condition_type = :SAC_PSEUDO_CLASS_CONDITION
+            condition.value     = pseudo_class
+          end
+        end
+
+        def attribute_id(id_value)
+          self.new do |condition|
+            condition.condition_type = :SAC_ID_CONDITION
+            condition.specified = true
+            condition.value     = id_value
+          end
+        end
+
+        def class_condition(class_name)
+          self.new do |condition|
+            condition.condition_type = :SAC_CLASS_CONDITION
+            condition.specified = true
+            condition.value     = class_name
+          end
+        end
+
+        def attribute_condition(attribute, conditions)
+          self.new do |condition|
+            if attribute
+              condition.condition_type = :SAC_ATTRIBUTE_CONDITION
+              condition.local_name = attribute
+            end
+
+            if conditions
+              condition.condition_type =
+                case conditions.first
+                when '~='
+                  :SAC_ONE_OF_ATTRIBUTE_CONDITION
+                when '|='
+                  :SAC_BEGIN_HYPHEN_ATTRIBUTE_CONDITION
+                when '='
+                  :SAC_ATTRIBUTE_CONDITION
+                end
+              condition.value = conditions.last
+              condition.specified = true
+            end
+          end
+        end
+      end
+
+      def initialize(attribute = nil, conditions = nil)
+        @specified  = false
+        @local_name = nil
+        @value      = nil
+        yield self if block_given?
+      end
+
+      def to_css
+        case condition_type
+        when :SAC_ONE_OF_ATTRIBUTE_CONDITION
+          "[#{local_name}~=#{value}]"
+        when :SAC_BEGIN_HYPHEN_ATTRIBUTE_CONDITION
+          "[#{local_name}|=#{value}]"
+        when :SAC_ATTRIBUTE_CONDITION
+          "[#{local_name}=#{value}]"
+        when :SAC_CLASS_CONDITION
+          ".#{value}"
+        when :SAC_ID_CONDITION
+          "#{value}"
+        end
+      end
+    end
+  end
+end

data/lib/css/sac/condition.rb

@@ -0,0 +1,21 @@
+module CSS
+  module SAC
+    class Condition
+      attr_accessor :condition_type
+    end
+
+    class CombinatorCondition < Condition
+      attr_accessor :first_condition, :second_condition
+
+      def initialize(first, second, type = :SAC_AND_CONDITION)
+        @first_condition = first
+        @second_condition = second
+        @condition_type = type
+      end
+
+      def to_css
+        "#{first_condition.to_css}#{second_condition.to_css}"
+      end
+    end
+  end
+end

data/lib/css/sac/document_handler.rb

@@ -0,0 +1,67 @@
+module CSS
+  module SAC
+    class CSS::SAC::DocumentHandler
+      def initialize
+      end
+
+      # Receive notification of the beginning of a style sheet.
+      def start_document(input_source)
+      end
+
+      # Receive notification of the end of a style sheet.
+      def end_document(input_source)
+      end
+
+      # Receive notification of a comment
+      def comment(text)
+      end
+
+      # Receive notification of an unknown at rule not supported by this parser.
+      def ignorable_at_rule(at_rule)
+      end
+
+      def namespace_declaration(prefix, uri)
+      end
+
+      # Called on an import statement
+      def import_style(uri, media, default_namespace_uri = nil)
+      end
+
+      # Notification of the start of a media statement
+      def start_media(media)
+      end
+
+      # Notification of the end of a media statement
+      def end_media(media)
+      end
+
+      # Notification of the start of a page statement
+      def start_page(name = nil, pseudo_page = nil)
+      end
+
+      # Notification of the end of a page statement
+      def end_page(name = nil, pseudo_page = nil)
+      end
+
+      # Notification of the beginning of a font face statement.
+      def start_font_face
+      end
+
+      # Notification of the end of a font face statement.
+      def end_font_face
+      end
+
+      # Notification of the beginning of a rule statement.
+      def start_selector(selectors)
+      end
+
+      # Notification of the end of a rule statement.
+      def end_selector(selectors)
+      end
+
+      # Notification of a declaration.
+      def property(name, value, important)
+      end
+    end
+  end
+end

data/lib/css/sac/error_handler.rb

@@ -0,0 +1,14 @@
+module CSS
+  module SAC
+    class ErrorHandler
+      def error(exception)
+      end
+
+      def fatal_error(exception)
+      end
+
+      def warning_error(exception)
+      end
+    end
+  end
+end