less 2.0.3 → 2.0.4

data/.gitignore

@@ -2,4 +2,5 @@
 *.gem
 .bundle
 *.rbc
+.yardoc
 Gemfile.lock

data/less.gemspec

@@ -22,7 +22,7 @@ Gem::Specification.new do |s|
   s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
   s.require_paths = ["lib"]
   
-  s.add_dependency "therubyracer", "~> 0.9.0"
+  s.add_dependency "therubyracer", "~> 0.9.1"
   s.add_development_dependency "rake", "~> 0.9.1"
   s.add_development_dependency "rspec", "~> 2.0"
 end

data/lib/less.rb

@@ -2,6 +2,7 @@ $:.unshift(File.dirname(__FILE__)) unless
   $:.include?(File.dirname(__FILE__)) || $:.include?(File.expand_path(File.dirname(__FILE__)))
 
 module Less
+
   require 'v8'
   require 'pathname'
   require 'less/parser'

data/lib/less/parser.rb

@@ -1,9 +1,29 @@
 
-require 'v8'
-
 module Less
+
+  # Utility for calling into the JavaScript runtime.
+  module CallJS
+
+    # @private
+    # Wrap JavaScript invocations with uniform error handling
+    #
+    # @yield code to wrap
+    def calljs
+      yield
+    rescue V8::JSError => e
+      raise ParseError.new(e)
+    end
+  end
+
+  # Convert lesscss source into an abstract syntax Tree
   class Parser
+    include CallJS
 
+    # Construct and configure new Less::Parser
+    #
+    # @param [Hash] opts configuration options
+    # @option opts [Array] :paths a list of directories to search when handling \@import statements
+    # @option opts [String] :filename to associate with resulting parse trees (useful for generating errors)
     def initialize(options = {})
       stringy = {}
       options.each do |k,v|
@@ -12,33 +32,53 @@ module Less
       @parser = Less.Parser.new(stringy)
     end
 
+    # Convert `less` source into a abstract syntaxt tree
+    # @param [String] less the source to parse
+    # @return [Less::Tree] the parsed tree
     def parse(less)
-      error,tree = nil
-      @parser.parse(less, lambda {|e, t| error = e; tree = t})
-      return Tree.new(tree) if tree
-    rescue V8::JSError => e
-      raise ParseError.new(e)
+      calljs do
+        error,tree = nil
+        @parser.parse(less, lambda {|e, t|
+          error = e; tree = t
+        })
+        Tree.new(tree) if tree
+      end
     end
-
   end
 
+  # Abstract LessCSS syntax tree Less. Mainly used to emit CSS
   class Tree
+    include CallJS
+    # Create a tree from a native javascript object.
+    # @param [V8::Object] tree the native less.js tree
     def initialize(tree)
       @tree = tree
     end
 
+    # Serialize this tree into CSS.
+    # By default this will be in pretty-printed form.
+    # @param [Hash] opts modifications to the output
+    # @option opts [Boolean] :compress minify output instead of pretty-printing
     def to_css(options = {})
-      @tree.toCSS(options)
+      calljs do
+        @tree.toCSS(options)
+      end
     end
   end
-  
+
+  # Thrown whenever an error occurs parsing
+  # and/or serializing less source. It is intended
+  # to wrap a native V8::JSError
   class ParseError < StandardError
-    
+
+    # Copies over `error`'s message and backtrace
+    # @param [V8::JSError] error native error
     def initialize(error)
       super(error.message)
       @backtrace = error.backtrace
     end
-  
+
+    # @return [Array] the backtrace frames
     def backtrace
       @backtrace
     end

data/lib/less/version.rb

@@ -1,3 +1,3 @@
 module Less
-  VERSION = '2.0.3'
+  VERSION = '2.0.4'
 end

metadata

@@ -2,7 +2,7 @@
 name: less
 version: !ruby/object:Gem::Version 
   prerelease: 
-  version: 2.0.3
+  version: 2.0.4
 platform: ruby
 authors: 
 - Charles Lowell
@@ -10,7 +10,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-06-14 00:00:00 -05:00
+date: 2011-06-17 00:00:00 -05:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -20,7 +20,7 @@ dependencies:
     requirements: 
     - - ~>
       - !ruby/object:Gem::Version 
-        version: 0.9.0
+        version: 0.9.1
   type: :runtime
   prerelease: false
   version_requirements: *id001
@@ -181,7 +181,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
-      hash: 1131849543812792581
+      hash: -2388107400795165815
       segments: 
       - 0
       version: "0"
@@ -190,7 +190,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
-      hash: 1131849543812792581
+      hash: -2388107400795165815
       segments: 
       - 0
       version: "0"