ionfish-stylish 0.1.5 → 0.1.6

data/History.txt

@@ -1,3 +1,12 @@
+=== Version 0.1.6 (2009-06-02)
+
+API polish
+* New Stylesheet#print method to serialise a tree to a file.
+* Avoid incomprehensible stack traces by raising an explicit error if a user
+  fails to define a variable when serialising a stylesheet.
+* Add support for the background-clip property to the Background class.
+
+
 === Version 0.1.5 (2009-05-03)
 
 Improved background support

data/Rakefile

@@ -6,7 +6,7 @@ begin
     s.name = "stylish"
     s.summary = "Write CSS with Ruby"
     s.email = "benedict@eastaugh.net"
-    s.homepage = "http://github.com/ionfish/stylish"
+    s.homepage = "http://ionfish.github.com/stylish/"
     s.description = "A Ruby library for generating cascading stylesheets."
     s.authors = ["Benedict Eastaugh"]
   end

data/VERSION.yml

@@ -1,4 +1,4 @@
 --- 
 :minor: 1
-:patch: 5
+:patch: 6
 :major: 0

data/lib/stylish/core.rb

@@ -37,6 +37,17 @@ module Stylish
       return "" if @nodes.empty?
       @nodes.map {|node| node.to_s(symbols) }.join(self.class.format)
     end
+    
+    # A convenience method to print the stylesheet to a file.
+    def print(filename, symbols = {})
+      serialised = self.to_s(symbols)
+      
+      File.open(filename, "w+") do |f|
+        f.puts(serialised)
+      end
+      
+      serialised
+    end
   end
   
   # Rule objects represent CSS rules, and serialise to them. They possess one

data/lib/stylish/extended.rb

@@ -54,6 +54,7 @@ module Stylish
       [:repeat,     "background-repeat"],
       [:position,   "background-position"],
       [:attachment, "background-attachment"],
+      [:clip,       "background-clip"],
       [:origin,     "background-origin"],
       [:break,      "background-break"],
       [:compressed]]
@@ -63,6 +64,7 @@ module Stylish
     ATTACHMENT_VALUES    = ["scroll", "fixed", "local"]
     ORIGIN_VALUES        = ["border-box", "padding-box", "content-box"]
     BREAK_VALUES         = ["bounding-box", "each-box", "continuous"]
+    CLIP_VALUES          = ORIGIN_VALUES | ["no-clip"]
     
     PROPERTIES.each do |name, value|
       attr_reader name
@@ -170,10 +172,32 @@ module Stylish
       end
     end
     
+    # The background-clip property specifies the background painting area.
+    #
+    #     clipped = Background.new :clip => "no-clip"
+    #     clipped.to_s # => "background-clip:no-clip;"
+    #
+    def clip=(clip)
+      @clip = clip if CLIP_VALUES.include? clip
+    end
+    
+    # The background-clip property is a CSS3 property and can take multiple
+    # values.
+    #
+    #     clipper = Background.new :clips => ["border-box", "padding-box"]
+    #     clipper.to_s # => "background-clip:border-box, padding-box;"
+    #
+    def clips=(clips)
+      @clip = clips.inject(PropertyBundle.new) do |cs, c|
+        cs << c if CLIP_VALUES.include? c
+        cs
+      end
+    end
+    
     # The background-origin property specifies the background positioning area.
     #
     #     original = Background.new :origin => "content-box"
-    #     original.to_s # => background-origin:content-box;
+    #     original.to_s # => "background-origin:content-box;"
     #
     def origin=(origin)
       @origin = origin if ORIGIN_VALUES.include? origin
@@ -183,7 +207,7 @@ module Stylish
     # values.
     #
     #     origs = Background.new :origin => ["padding-box", "content-box"]
-    #     origs.to_s # => background-origin:padding-box, content-box;
+    #     origs.to_s # => "background-origin:padding-box, content-box;"
     #
     def origins=(origins)
       @origin = origins.inject(PropertyBundle.new) do |os, o|

data/lib/stylish/formattable.rb

@@ -36,6 +36,8 @@ module Stylish
         end
       end
       
+      private
+      
       def accept_format(pattern, default)
         @format_pattern = pattern if pattern.is_a? Regexp
         self.format = default

data/lib/stylish/generate.rb

@@ -138,7 +138,12 @@ module Stylish
         replaceable = name_or_hash || @name
         
         if replaceable.is_a? Symbol
-          symbol_table[replaceable]
+          if symbol_table[replaceable]
+            symbol_table[replaceable]
+          else
+            raise UndefinedVariable,
+              ":#{replaceable.to_s} could not be located in the symbol table."
+          end
         elsif replaceable.is_a?(Hash) || replaceable.is_a?(Array)
           replaceable.to_a.inject(replaceable.class.new) do |acc, el|
             if acc.is_a? Hash

data/lib/stylish.rb

@@ -12,4 +12,6 @@ module Stylish
   require STYLISH_PATH + 'extended'
   require STYLISH_PATH + 'color'
   require STYLISH_PATH + 'generate'
+  
+  class UndefinedVariable < ArgumentError; end
 end

data/test/background_test.rb

@@ -77,6 +77,13 @@ class BackgroundTest < Test::Unit::TestCase
     end
   end
   
+  def test_clips
+    clipper = Stylish::Background.new :clips => ["no-clip", "content-box"]
+    
+    assert_equal(2, clipper.clip.length)
+    assert_equal("background-clip:no-clip, content-box;", clipper.to_s)
+  end
+  
   def test_origins
     original = Stylish::Background.new :origins => ["border-box", "padding-box"]
     

data/test/generate_test.rb

@@ -94,4 +94,14 @@ class GenerateTest < Test::Unit::TestCase
      "background-position:left top, right top, right bottom, left bottom;}",
      style.to_s({:pos => "bottom"}))
   end
+  
+  def test_undefined_variables
+    style = Stylish.generate do
+      body :color => :super_colour
+    end
+    
+    assert_raise Stylish::UndefinedVariable do
+      style.to_s({})
+    end
+  end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: ionfish-stylish
 version: !ruby/object:Gem::Version 
-  version: 0.1.5
+  version: 0.1.6
 platform: ruby
 authors: 
 - Benedict Eastaugh
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-05-03 00:00:00 -07:00
+date: 2009-06-02 00:00:00 -07:00
 default_executable: 
 dependencies: []
 
@@ -51,7 +51,7 @@ files:
 - test/tree_test.rb
 - test/variable_test.rb
 has_rdoc: true
-homepage: http://github.com/ionfish/stylish
+homepage: http://ionfish.github.com/stylish/
 post_install_message: 
 rdoc_options: 
 - --charset=UTF-8