sprockets-less 0.5.2

data/.gitignore

@@ -0,0 +1,3 @@
+*.gem
+Gemfile.lock
+.rbenv-version

data/Gemfile

@@ -0,0 +1,5 @@
+source :rubygems
+gemspec
+
+gem "therubyracer", ">= 0.10.1", :require => nil, :platforms => :ruby
+gem "therubyrhino", ">= 1.73.2", :require => nil, :platforms => :jruby

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2012 Loic Nageleisen
+
+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.md

@@ -0,0 +1,102 @@
+# sprockets-less
+
+**Better Less integration with [Sprockets 2.x](http://github.com/sstephenson/sprockets)**
+
+When using Sprockets 2.x with Less you will eventually run into a pretty big issue. `//= require` directives will not allow Less mixins, variables, etc. to be shared between files. So you'll try to use `@import`, and that'll also blow up in your face. `sprockets-less` aims to fix this.
+
+_Note: If you use Rails 3.1, you may want to use the [less-rails gem](http://github.com/rails/less-rails). But if you want to use Sprockets and Less anywhere else, like Sinatra, use `sprockets-less`._
+
+## Installing
+
+Once you have set up Sprockets to behave on Rails 2.3 (see RAILS_UP for how to uprate your app), just bundle up less-rails in your Gemfile. This will pull in less as a runtime dependency too. This gem shall not be published at rubygems under this name, so be sure to set up both git and the branch correctly.
+
+    gem 'less-rails', :git => https://github.com/lloeki/less-rails.git, :branch => 'rails-2.3-backport'
+
+## Usage
+
+In your Rack application, setup Sprockets as you normally would, and require "sprockets-less":
+
+``` ruby
+require "sprockets"
+require "sprockets-less"
+require "less"
+
+map "/assets" do
+  environment = Sprockets::Environment.new
+  environment.append_path "assets/stylesheets"
+  run environment
+end
+
+map "/" do
+  run YourRackApp
+end
+```
+
+## Configuration
+
+If you would like to configure any of the Less options, you can do so like this:
+
+```ruby
+Sprockets::Less.options[:compress] = true
+```
+
+## Import Hooks
+
+Any `@import` to a `.less` file will automatically declare that file as a sprockets dependency to the file importing it. This means that you can edit imported framework files and see changes reflected in the parent durning development. So this:
+
+```css
+@import "frameworks/bootstrap/mixins";
+
+#leftnav { .border-radius(5px); }
+```
+
+Will end up acting as if you had done this below:
+
+```css
+/*
+ *= depend_on "frameworks/bootstrap/mixins.less"
+*/
+
+@import "frameworks/bootstrap/mixins";
+
+#leftnav { .border-radius(5px); }
+```
+
+## Helpers
+
+*Warning: this is currently non-functional*
+
+When referencing assets use the following helpers in LESS.
+
+```css
+asset-path(@relative-asset-path)  /* Returns a string to the asset. */
+asset-path("rails.png")           /* Becomes: "/assets/rails.png" */
+
+asset-url(@relative-asset-path)   /* Returns url reference to the asset. */
+asset-url("rails.png")            /* Becomes: url(/assets/rails.png) */
+```
+
+As a convenience, for each of the following asset classes there are corresponding `-path` and `-url` helpers image, font, video, audio, javascript and stylesheet. The following examples only show the `-url` variants since you get the idea of the `-path` ones above.
+
+```css
+image-url("rails.png")            /* Becomes: url(/assets/rails.png) */
+font-url("rails.ttf")             /* Becomes: url(/assets/rails.ttf) */
+video-url("rails.mp4")            /* Becomes: url(/videos/rails.mp4) */
+audio-url("rails.mp3")            /* Becomes: url(/audios/rails.mp3) */
+javascript-url("rails.js")        /* Becomes: url(/assets/rails.js) */
+stylesheet-url("rails.css")       /* Becomes: url(/assets/rails.css) */
+```
+
+Lastly, we provide a data url method for base64 encoding assets.
+
+```css
+asset-data-uri("rails.png")       /* Becomes: url(data:image/png;base64,iVBORw0K...) */
+```
+
+Please note that these helpers are only available server-side, and something like ERB templates should be used if client-side rendering is desired.
+
+
+## License
+
+Sprocket::Less is Copyright (c) 2012 Loic Nageleisen, <loic.nageleisen@gmail.com>
+

data/Rakefile

@@ -0,0 +1,5 @@
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new
+task :default => :spec

data/lib/sprockets/less/functions.rb

@@ -0,0 +1,153 @@
+require 'less'
+
+module Sprockets
+  module Less
+
+    # Sprockets-aware Less functions
+    module Functions
+      def asset_data_url(path)
+        "url(#{sprockets_context.asset_data_uri(path)})"
+      end
+      
+      def asset_path(asset)
+        public_path(asset).inspect
+      end
+      
+      def asset_url(asset)
+        "url(#{public_path(asset)})"
+      end
+      
+      def image_path(img)
+        sprockets_context.image_path(img).inspect
+      end
+
+      def asset_data_uri(source)
+        "url(#{sprockets_context.asset_data_uri(source.value)})"
+      end
+
+      def image_url(img)
+        "url(#{sprockets_context.image_path(img)})"
+      end
+
+      def video_path(video)
+        sprockets_context.video_path(video).inspect
+      end
+      
+      def video_url(video)
+        "url(#{sprockets_context.video_path(video)})"
+      end
+      
+      def audio_path(audio)
+        sprockets_context.audio_path(audio).inspect
+      end
+      
+      def audio_url(audio)
+        "url(#{context.audio_path(audio)})"
+      end
+      
+      def javascript_path(javascript)
+        context.javascript_path(javascript).inspect
+      end
+      
+      def javascript_url(javascript)
+        "url(#{context.javascript_path(javascript)})"
+      end
+      
+      def stylesheet_path(stylesheet)
+        sprockets_context.stylesheet_path(stylesheet).inspect
+      end
+      
+      def stylesheet_url(stylesheet)
+        "url(#{sprockets_context.stylesheet_path(stylesheet)})"
+      end
+      
+      protected
+      
+      def public_path(asset)
+        sprockets_context.asset_paths.compute_public_path asset, '/assets'
+      end
+      
+      def context_asset_data_uri(path)
+        
+      end
+    end
+  end
+end
+
+module Less
+
+  # Wrapper for the `tree` JavaScript module.
+  #
+  # This is not to be confused with Less::Parser::Tree, as Less uses that
+  # to wrap the AST (which is actually a tree.RuleSet) resulting from parsing
+  class Tree
+    attr_reader :sprockets_context
+
+    def initialize(options)
+      @tree = Less.instance_eval { @loader.require('less/tree') }
+      @sprockets_context = options[:importer].context
+      extend_js Sprockets::Less::Functions
+    end
+
+    private
+
+    # Transforms a css function name string to a (method) symbol
+    def css_to_sym(str)
+      str.gsub('-','_').to_sym
+    end
+
+    # Transforms a method symbol to a css function name string
+    def sym_to_css(sym)
+      sym.to_sym.to_s.gsub('_', '-')
+    end
+
+    # Removes quotes
+    def unquote(str)
+      s = str.to_s.strip
+      s =~ /^['"](.*?)['"]$/ ? $1 : s
+    end
+
+    # Creates a JavaScript anonymous function from a Ruby block
+    def anonymous_function(block)
+      lambda do |*args|
+        # args: (this, node) v8 >= 0.10, otherwise (node)
+        raise ArgumentError, "missing node" if args.empty?
+        @tree[:Anonymous].new block.call(@tree, args.last)
+      end
+    end
+
+    # Access to the Less JavaScript function object
+    def functions
+      @tree['functions']
+    end
+
+    # Injects a Ruby method into the JavaScript Less
+    def add_function(name, &block)
+      functions[name] = anonymous_function(block)
+    end
+
+    # Adds all of a module's public instance methods as Less functions
+    def extend_js(mod)
+      extend mod
+      mod.public_instance_methods.each do |method_name|
+        add_function(sym_to_css(method_name)) { |tree, cxt|
+          send method_name.to_sym, unquote(cxt.toCSS())
+        }
+      end
+    end
+
+  end
+
+  class Parser
+    
+    attr_reader :tree
+
+    # Override the parser's initialization to improve Less `tree`
+    # with sprockets awareness
+    alias_method :initialize_without_tree, :initialize
+    def initialize(options={})
+      initialize_without_tree(options)
+      @tree = Less::Tree.new(options)
+    end
+  end
+end

data/lib/sprockets/less/importer.rb

@@ -0,0 +1,95 @@
+module Sprockets  
+  module Less  
+    class Importer
+      # TODO: override `tree.Import` to inject our own import resolution
+      # logic and .push() into its `imports` argument.
+      # See less/tree/import.js
+
+      # Reference to the Sprockets context
+      attr_reader :context
+      
+      IMPORT_SCANNER = /^\s*@import\s*['"]([^'"]+)['"]\s*;/.freeze
+
+      def initialize(context)
+        @context = context
+      end
+
+      # Finds an asset from the given path. This is where
+      # we make Sprockets behave like Less, and import partial
+      # style paths.
+      def resolve(path, base_path)
+        possible_files(path, base_path).each do |file|
+          context.resolve(file) { |found| return found if context.asset_requirable?(found) }
+        end
+
+        nil
+      end
+      
+      # Returns all of the possible paths (including partial variations)
+      # to attempt to resolve with the given path.
+      def possible_files(path, base_path)
+        path      = Pathname.new(path)
+        base_path = Pathname.new(base_path).dirname
+        root_path = Pathname.new(context.root_path)
+        paths     = [ path, partialize_path(path) ]
+
+        # Add the relative path from the root, if necessary
+        if path.relative? && base_path != root_path && path.to_s !~ /\A\.\//
+          relative_path = base_path.relative_path_from(root_path).join path
+          
+          paths.unshift(relative_path, partialize_path(relative_path))
+        end
+
+        paths.compact
+      end
+      
+      # Returns the partialized version of the given path.
+      # Returns nil if the path is already to a partial.
+      def partialize_path(path)
+        if path.basename.to_s !~ /\A_/
+          Pathname.new path.to_s.sub(/([^\/]+)\Z/, '_\1')
+        end
+      end
+      
+      # Returns the syntax of the given path.
+      def syntax(path)
+        path.to_s.include?('.css') ? :css : :less
+      end
+      
+      # Returns the string to be passed to the Less engine. We use
+      # Sprockets to process the file, but we remove any Less processors
+      # because we need to let the Sass::Engine handle that.
+      def evaluate(path)
+        processors = context.environment.attributes_for(path).processors.dup
+        processors.delete_if { |processor| processor < Tilt::LessTemplate }
+        context.evaluate(path, :processors => processors)
+      end
+
+      # Tests if a path will make the import directive be passed as is.
+      def passthrough?(pathname)
+        pathname.to_s.end_with?('.css')
+      end
+      
+      # Assemble dependencies for the context
+      def process_dependencies(data)
+        import_paths = data.scan(IMPORT_SCANNER).flatten.compact.uniq
+        import_paths.each do |path|
+          pathname = begin
+                       #TODO: use resolve to partialize paths
+                       context.resolve(path)
+                     rescue Sprockets::FileNotFound
+                       nil
+                     end
+          
+          unless pathname.nil? || passthrough?(pathname)
+            # mark dependency in Sprockets context
+            context.depend_on(path)
+            # recurse for more dependencies
+            process_dependencies File.read(pathname)
+          end
+        end
+      end
+      
+    end
+  end
+end

data/lib/sprockets/less/template.rb

@@ -0,0 +1,103 @@
+require 'tilt'
+
+module Sprockets  
+  module Less  
+    class LessTemplate < Tilt::LessTemplate
+      self.default_mime_type = 'text/css'
+
+      # A reference to the current Sprockets context
+      attr_reader :context
+      
+      # Templates are initialized once the functions are added.
+      def self.engine_initialized?
+        super && (!Less.add_less_functions || defined?(Functions))
+      end
+
+      # Add the Less functions if they haven't already been added.
+      def initialize_engine
+        super unless self.class.superclass.engine_initialized?
+        
+        if Less.add_less_functions
+          require 'sprockets/less/functions'
+        end
+      end
+
+      # Define the expected syntax for the template
+      def syntax
+        :less
+      end
+
+      # See `Tilt::Template#prepare`.
+      def prepare
+        @context = nil
+        @output = nil
+      end
+      
+      # See `Tilt::Template#evaluate`.
+      def evaluate(context, locals, &block)
+        @output ||= begin
+          @context = context
+          process_dependencies less_options
+          parser = ::Less::Parser.new less_options
+          tree = parser.parse(data)
+          tree.to_css css_options
+        end
+      end
+      
+      protected
+
+      def process_dependencies options
+        options[:importer].process_dependencies data
+      end
+
+      # Returns a Sprockets-aware cache store.
+      def cache_store
+        return nil if context.environment.cache.nil?
+
+        CacheStore.new context.environment
+      end
+
+      # A reference to the custom Less importer, `Sprockets::Less::Importer`.
+      def importer
+        Importer.new context
+      end
+
+      # Assemble the options for the Less parser
+      def less_options
+        new_options = merge_less_options(global_less_options, options)
+        merge_less_options(new_options, default_less_options)
+      end
+
+      # Extract options for CSS output
+      def css_options
+        css_keys = [:compress, :optimization, :silent, :color]
+        Hash[less_options.to_enum.to_a.select{|k, _| css_keys.include? k}]
+      end
+
+      # Get global Less options
+      def global_less_options
+        Sprockets::Less.options.dup
+      end
+
+      def default_less_options
+        {
+          :filename => eval_file,
+          :line => line,
+          :paths => context.environment.paths,
+          #:syntax => syntax,
+          #:cache_store => cache_store,
+          :importer => importer
+        }
+      end
+
+      # Merges two sets of Less parser options, prepending
+      # the `:paths` instead of clobbering them.
+      def merge_less_options(options, other_options)
+        if (load_paths = options[:paths]) && (other_paths = other_options[:paths])
+          other_options[:paths] = other_paths + load_paths
+        end
+        options.merge other_options
+      end
+    end    
+  end
+end

data/lib/sprockets/less/version.rb

@@ -0,0 +1,5 @@
+module Sprockets
+  module Less
+    VERSION = '0.5.2'
+  end
+end

data/lib/sprockets/less.rb

@@ -0,0 +1,24 @@
+require 'sprockets/less/version'
+require 'sprockets/less/template'
+require 'sprockets/engines'
+
+module Sprockets
+  module Less
+    autoload :Importer,   'sprockets/less/importer'
+
+    class << self
+      # Global configuration for `Less::Parser` instances
+      attr_accessor :options
+
+      # When false, the asset path helper provided by
+      # `sprockets-helpers` will not be added as Less functions.
+      # `true` by default.
+      attr_accessor :add_less_functions
+    end
+
+    @options = {}
+    @add_less_functions = true
+  end
+
+  register_engine '.less', Less::LessTemplate
+end

data/lib/sprockets-less.rb

@@ -0,0 +1 @@
+require 'sprockets/less'

data/spec/spec_helper.rb

@@ -0,0 +1,12 @@
+require 'sprockets'
+require 'sprockets-less'
+require 'sprockets-helpers'
+require 'construct'
+
+# Requires supporting files with custom matchers and macros, etc,
+# in ./support/ and its subdirectories.
+Dir["#{File.dirname(__FILE__)}/support/**/*.rb"].each { |f| require f }
+
+RSpec.configure do |config|
+  config.include Construct::Helpers
+end

data/spec/sprockets-less_spec.rb

@@ -0,0 +1,260 @@
+require 'spec_helper'
+
+RSpec.configure do |c|
+  c.filter_run_excluding :broken => true
+  c.filter_run_excluding :todo => true
+end
+
+describe Sprockets::Less do
+  before :each do
+    @root   = create_construct
+    @assets = @root.directory 'assets'
+    @env    = Sprockets::Environment.new @root.to_s
+    @env.append_path @assets.to_s
+  end
+  
+  after :each do
+    @root.destroy!
+  end
+  
+  it 'processes less files normally' do
+    @assets.file 'main.css.less', '//= require dep'
+    @assets.file 'dep.less', %(body { color: blue; })
+    asset = @env['main.css']
+    asset.to_s.should == "body {\n  color: blue;\n}\n"
+  end
+  
+  it 'imports standard files' do
+    @assets.file 'main.css.less', %(@import "dep";\nbody { color: @color; })
+    @assets.file 'dep.less', '@color: blue;'
+    asset = @env['main.css']
+    asset.to_s.should == "body {\n  color: #0000ff;\n}\n"
+  end
+    
+  it 'imports partials' do
+    @assets.file 'main.css.less', %(@import "_dep";\nbody { color: @color; })
+    @assets.file '_dep.less', '@color: blue;'
+    asset = @env['main.css']
+    asset.to_s.should == "body {\n  color: #0000ff;\n}\n"
+  end
+  
+  it 'imports files with the correct content type', :broken => true do
+    @assets.file 'main.css.less', %(@import "dep";\nbody { color: @color; })
+    @assets.file 'dep.js', 'var app = {};'
+    @assets.file '_dep.less', '@color: blue;'
+    asset = @env['main.css']
+    asset.to_s.should == "body {\n  color: #0000ff;\n}\n"
+  end
+  
+  it 'imports files with directives', :todo => true do
+    @assets.file 'main.css.less', %(@import "dep";)
+    @assets.file 'dep.css', "/*\n *= require subdep\n */"
+    @assets.file 'subdep.css.less', "@color: blue;\nbody { color: @color; }"
+    asset = @env['main.css']
+    asset.to_s.should include("body {\n  color: #0000ff; }\n")
+  end
+  
+  it 'imports files with additional processors', :todo => true do
+    @assets.file 'main.css.less', %(@import "dep";\nbody { color: @color; })
+    @assets.file 'dep.css.less.erb', "@color: <%= 'blue' %>;"
+    asset = @env['main.css']
+    asset.to_s.should == "body {\n  color: blue; }\n"
+  end
+  
+  it 'imports relative files', :todo => true do
+    @assets.file 'folder/main.css.less', %(@import "./dep-1";\n@import "./subfolder/dep-2";\nbody { background-color: @background-color; color: @color; })
+    @assets.file 'folder/dep-1.less', '@background-color: red;'
+    @assets.file 'folder/subfolder/dep-2.less', '@color: blue;'
+    asset = @env['folder/main.css']
+    asset.to_s.should == "body {\n  background-color: #ff0000;\n  color: #0000ff; }\n"
+  end
+  
+  it 'imports relative partials', :todo => true do
+    @assets.file 'folder/main.css.less', %(@import "./dep-1";\n@import "./subfolder/dep-2";\nbody { background-color: @background-color; color: @color; })
+    @assets.file 'folder/_dep-1.less', '@background-color: red;'
+    @assets.file 'folder/subfolder/_dep-2.less', '@color: blue;'
+    asset = @env['folder/main.css']
+    asset.to_s.should == "body {\n  background-color: #ff0000;\n  color: blue; }\n"
+  end
+  
+  it 'imports relative files without preceding ./', :todo => true do
+    @assets.file 'folder/main.css.less', %(@import "dep-1";\n@import "subfolder/dep-2";\nbody { background-color: @background-color; color: @color; })
+    @assets.file 'folder/dep-1.less', '@background-color: red;'
+    @assets.file 'folder/subfolder/dep-2.less', '@color: blue;'
+    asset = @env['folder/main.css']
+    asset.to_s.should == "body {\n  background-color: red;\n  color: blue; }\n"
+  end
+  
+  it 'imports relative partials without preceding ./', :todo => true do
+    @assets.file 'folder/main.css.less', %(@import "dep-1";\n@import "subfolder/dep-2";\nbody { background-color: @background-color; color: @color; })
+    @assets.file 'folder/_dep-1.less', '@background-color: red;'
+    @assets.file 'folder/subfolder/_dep-2.less', '@color: blue;'
+    asset = @env['folder/main.css']
+    asset.to_s.should == "body {\n  background-color: red;\n  color: blue; }\n"
+  end
+  
+  it 'imports files relative to root' do
+    @assets.file 'folder/main.css.less', %(@import "dep";\nbody { color: @color; })
+    @assets.file 'dep.less', '@color: blue;'
+    asset = @env['folder/main.css']
+    asset.to_s.should == "body {\n  color: #0000ff;\n}\n"
+  end
+  
+  it 'imports partials relative to root', :broken => true do
+    @assets.file 'folder/main.css.less', %(@import "dep";\nbody { color: @color; })
+    @assets.file '_dep.less', '@color: blue;'
+    asset = @env['folder/main.css']
+    asset.to_s.should == "body {\n  color: #0000ff;\n}\n"
+  end
+  
+  it 'shares Less environment with other imports' do
+    @assets.file 'main.css.less', %(@import "dep-1";\n@import "dep-2";)
+    @assets.file 'dep-1.less', '@color: blue;'
+    @assets.file 'dep-2.less', 'body { color: @color; }'
+    asset = @env['main.css']
+    asset.to_s.should == "body {\n  color: #0000ff;\n}\n"
+  end
+  
+  it 'imports files from the assets load path' do
+    vendor = @root.directory 'vendor'
+    @env.append_path vendor.to_s
+    
+    @assets.file 'main.css.less', %(@import "dep";\nbody { color: @color; })
+    vendor.file 'dep.less', '@color: blue;'
+    asset = @env['main.css']
+    asset.to_s.should == "body {\n  color: #0000ff;\n}\n"
+  end
+  
+  it 'allows global Less configuration' do
+    Sprockets::Less.options[:compress] = true
+    @assets.file 'main.css.less', "body {\n  color: blue;\n}"
+    
+    asset = @env['main.css']
+    asset.to_s.should == "body{color:blue;}\n"
+    Sprockets::Less.options.delete(:compress)
+  end
+  
+  it 'imports files from the Less load path' do
+    vendor = @root.directory 'vendor'
+    Sprockets::Less.options[:paths] = [ vendor.to_s ]
+    
+    @assets.file 'main.css.less', %(@import "dep";\nbody { color: @color; })
+    vendor.file 'dep.less', '@color: blue;'
+    asset = @env['main.css']
+    asset.to_s.should == "body {\n  color: #0000ff;\n}\n"
+    Sprockets::Less.options.delete(:paths)
+  end
+
+  it 'adds dependencies when imported' do
+    @assets.file 'main.css.less', %(@import "dep";\nbody { color: @color; })
+    dep = @assets.file 'dep.less', '@color: blue;'
+    
+    asset = @env['main.css']
+    asset.should be_fresh(@env)
+    
+    mtime = Time.now + 1
+    dep.open('w') { |f| f.write '@color: red;' }
+    dep.utime mtime, mtime
+    
+    asset.should_not be_fresh(@env)
+  end
+
+  it 'adds dependencies from assets when imported' do
+    @assets.file 'main.css.less', %(@import "dep-1";\nbody { color: @color; })
+    @assets.file 'dep-1.less', %(@import "dep-2";\n)
+    dep = @assets.file 'dep-2.less', '@color: blue;'
+    
+    asset = @env['main.css']
+    asset.should be_fresh(@env)
+    
+    mtime = Time.now + 1
+    dep.open('w') { |f| f.write '@color: red;' }
+    dep.utime mtime, mtime
+    
+    asset.should_not be_fresh(@env)
+  end
+  
+  it "uses the environment's cache", :todo => true do
+    cache = {}
+    @env.cache = cache
+    
+    @assets.file 'main.css.less', %(@color: blue;\nbody { color: @color; })
+    
+    @env['main.css'].to_s
+    less_cache = cache.keys.detect { |key| key =~ /main\.css\.less/ }
+    less_cache.should_not be_nil
+  end
+  
+  it 'adds the #asset_path helper', :broken => true do
+    @assets.file 'asset_path.css.less', %(body { background: url(asset-path("image.jpg")); })
+    @assets.file 'asset_url.css.less', %(body { background: asset-url("image.jpg"); })
+    @assets.file 'asset_path_options.css.less', %(body { background: url(asset-path("image.jpg", $digest: true, $prefix: "/themes")); })
+    @assets.file 'asset_url_options.css.less', %(body { background: asset-url("image.jpg", $digest: true, $prefix: "/themes"); })
+    @assets.file 'image.jpg'
+    
+    @env['asset_path.css'].to_s.should == %(body {\n  background: url("/assets/image.jpg"); }\n)
+    @env['asset_url.css'].to_s.should == %(body {\n  background: url("/assets/image.jpg"); }\n)
+    @env['asset_path_options.css'].to_s.should =~ %r(body \{\n  background: url\("/themes/image-[0-9a-f]+.jpg"\); \}\n)
+    @env['asset_url_options.css'].to_s.should =~ %r(body \{\n  background: url\("/themes/image-[0-9a-f]+.jpg"\); \}\n)
+  end
+  
+  it 'adds the #image_path helper', :broken => true do
+    @assets.file 'image_path.css.less', %(body { background: url(image-path("image.jpg")); })
+    @assets.file 'image_url.css.less', %(body { background: image-url("image.jpg"); })
+    @assets.file 'image_path_options.css.less', %(body { background: url(image-path("image.jpg", $digest: true, $prefix: "/themes")); })
+    @assets.file 'image_url_options.css.less', %(body { background: image-url("image.jpg", $digest: true, $prefix: "/themes"); })
+    @assets.file 'image.jpg'
+    
+    @env['image_path.css'].to_s.should == %(body {\n  background: url("/assets/image.jpg"); }\n)
+    @env['image_url.css'].to_s.should == %(body {\n  background: url("/assets/image.jpg"); }\n)
+    @env['image_path_options.css'].to_s.should =~ %r(body \{\n  background: url\("/themes/image-[0-9a-f]+.jpg"\); \}\n)
+    @env['image_url_options.css'].to_s.should =~ %r(body \{\n  background: url\("/themes/image-[0-9a-f]+.jpg"\); \}\n)
+  end
+
+  it 'adds the #font_path helper', :broken => true do
+    @assets.file 'font_path.css.less', %(@font-face { src: url(font-path("font.ttf")); })
+    @assets.file 'font_url.css.less', %(@font-face { src: font-url("font.ttf"); })
+    @assets.file 'font_path_options.css.less', %(@font-face { src: url(font-path("font.ttf", $digest: true, $prefix: "/themes")); })
+    @assets.file 'font_url_options.css.less', %(@font-face { src: font-url("font.ttf", $digest: true, $prefix: "/themes"); })
+    @assets.file 'font.ttf'
+    
+    @env['font_path.css'].to_s.should == %(@font-face {\n  src: url("/assets/font.ttf"); }\n)
+    @env['font_url.css'].to_s.should == %(@font-face {\n  src: url("/assets/font.ttf"); }\n)
+    @env['font_path_options.css'].to_s.should =~ %r(@font-face \{\n  src: url\("/themes/font-[0-9a-f]+.ttf"\); \}\n)
+    @env['font_url_options.css'].to_s.should =~ %r(@font-face \{\n  src: url\("/themes/font-[0-9a-f]+.ttf"\); \}\n)
+  end
+  
+  it 'adds the #asset_data_uri helper', :broken => true do
+    @assets.file 'asset_data_uri.css.less', %(body { background: asset-data-uri("image.jpg"); })
+    @assets.file 'image.jpg', File.read('spec/fixtures/image.jpg')
+    
+    @env['asset_data_uri.css'].to_s.should == %(body {\n  background: url(data:image/jpeg;base64,%2F9j%2F4AAQSkZJRgABAgAAZABkAAD%2F7AARRHVja3kAAQAEAAAAPAAA%2F%2B4ADkFkb2JlAGTAAAAAAf%2FbAIQABgQEBAUEBgUFBgkGBQYJCwgGBggLDAoKCwoKDBAMDAwMDAwQDA4PEA8ODBMTFBQTExwbGxscHx8fHx8fHx8fHwEHBwcNDA0YEBAYGhURFRofHx8fHx8fHx8fHx8fHx8fHx8fHx8fHx8fHx8fHx8fHx8fHx8fHx8fHx8fHx8fHx8f%2F8AAEQgAAQABAwERAAIRAQMRAf%2FEAEoAAQAAAAAAAAAAAAAAAAAAAAgBAQAAAAAAAAAAAAAAAAAAAAAQAQAAAAAAAAAAAAAAAAAAAAARAQAAAAAAAAAAAAAAAAAAAAD%2F2gAMAwEAAhEDEQA%2FACoD%2F9k%3D); }\n)
+  end
+  
+  it "mirrors Less::Rails's #asset_path helpers", :broken => true do
+    @assets.file 'asset_path.css.less', %(body { background: url(asset-path("image.jpg", image)); })
+    @assets.file 'asset_url.css.less', %(body { background: asset-url("icon.jpg", image); })
+    @assets.file 'image.jpg'
+    
+    @env['asset_path.css'].to_s.should == %(body {\n  background: url("/assets/image.jpg"); }\n)
+    @env['asset_url.css'].to_s.should == %(body {\n  background: url("/images/icon.jpg"); }\n)
+  end
+
+  describe Sprockets::Less::LessTemplate do
+    describe 'initialize_engine' do
+      it 'initializes super if super is uninitialized' do
+        Tilt::LessTemplate.stub(:engine_initialized?).and_return false
+        template = Sprockets::Less::LessTemplate.new {}
+        template.should_receive(:require_template_library) # called from Tilt::LessTemplate.initialize
+        template.initialize_engine
+      end
+
+      it "does not initializes super if super is initialized to silence warnings" do
+        Tilt::LessTemplate.stub(:engine_initialized?).and_return true
+        template = Sprockets::Less::LessTemplate.new {}
+        template.should_not_receive(:require_template_library) # called from Tilt::LessTemplate.initialize
+        template.initialize_engine
+      end
+    end
+  end
+end

data/spec/support/be_fresh_matcher.rb

@@ -0,0 +1,17 @@
+RSpec::Matchers.define :be_fresh do |env|
+  match do |actual|
+    if actual.method(:fresh?).arity == 1
+      actual.fresh?(env)
+    else
+      actual.fresh?
+    end
+  end
+  
+  failure_message_for_should do |env|
+    'expected asset to be fresh'
+  end
+  
+  failure_message_for_should_not do |env|
+    'expected asset to be stale'
+  end
+end

data/sprockets-less.gemspec

@@ -0,0 +1,23 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "sprockets/less/version"
+
+Gem::Specification.new do |s|
+  s.name        = "sprockets-less"
+  s.version     = Sprockets::Less::VERSION
+  s.authors     = ["Loic Nageleisen"]
+  s.email       = ["loic.nageleisen@gmail.com"]
+  s.homepage    = "http://github.com/lloeki/sprockets-less"
+  s.summary     = %q{The dynamic stylesheet language for the Sprockets asset pipeline.}
+  s.description = %q{The dynamic stylesheet language for the Sprockets asset pipeline.}
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+  s.add_dependency 'less', '~> 2.2.0'
+  s.add_dependency 'tilt', '~> 1.1'
+  s.add_development_dependency 'sprockets-helpers', '~> 0.6'
+  s.add_development_dependency 'rspec',             '~> 2.6'
+  s.add_development_dependency 'test-construct',    '~> 1.2'
+  s.add_development_dependency 'rake'
+end

metadata

@@ -0,0 +1,175 @@
+--- !ruby/object:Gem::Specification 
+name: sprockets-less
+version: !ruby/object:Gem::Version 
+  hash: 15
+  prerelease: 
+  segments: 
+  - 0
+  - 5
+  - 2
+  version: 0.5.2
+platform: ruby
+authors: 
+- Loic Nageleisen
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2012-08-06 00:00:00 +02:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 7
+        segments: 
+        - 2
+        - 2
+        - 0
+        version: 2.2.0
+  version_requirements: *id001
+  name: less
+  prerelease: false
+  type: :runtime
+- !ruby/object:Gem::Dependency 
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 13
+        segments: 
+        - 1
+        - 1
+        version: "1.1"
+  version_requirements: *id002
+  name: tilt
+  prerelease: false
+  type: :runtime
+- !ruby/object:Gem::Dependency 
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 7
+        segments: 
+        - 0
+        - 6
+        version: "0.6"
+  version_requirements: *id003
+  name: sprockets-helpers
+  prerelease: false
+  type: :development
+- !ruby/object:Gem::Dependency 
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 15
+        segments: 
+        - 2
+        - 6
+        version: "2.6"
+  version_requirements: *id004
+  name: rspec
+  prerelease: false
+  type: :development
+- !ruby/object:Gem::Dependency 
+  requirement: &id005 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 11
+        segments: 
+        - 1
+        - 2
+        version: "1.2"
+  version_requirements: *id005
+  name: test-construct
+  prerelease: false
+  type: :development
+- !ruby/object:Gem::Dependency 
+  requirement: &id006 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  version_requirements: *id006
+  name: rake
+  prerelease: false
+  type: :development
+description: The dynamic stylesheet language for the Sprockets asset pipeline.
+email: 
+- loic.nageleisen@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- lib/sprockets-less.rb
+- lib/sprockets/less.rb
+- lib/sprockets/less/functions.rb
+- lib/sprockets/less/importer.rb
+- lib/sprockets/less/template.rb
+- lib/sprockets/less/version.rb
+- spec/fixtures/image.jpg
+- spec/spec_helper.rb
+- spec/sprockets-less_spec.rb
+- spec/support/be_fresh_matcher.rb
+- sprockets-less.gemspec
+has_rdoc: true
+homepage: http://github.com/lloeki/sprockets-less
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.6.2
+signing_key: 
+specification_version: 3
+summary: The dynamic stylesheet language for the Sprockets asset pipeline.
+test_files: 
+- spec/fixtures/image.jpg
+- spec/spec_helper.rb
+- spec/sprockets-less_spec.rb
+- spec/support/be_fresh_matcher.rb