less-rails 2.0.2 → 2.0.3

data/.travis.yml

@@ -0,0 +1,5 @@
+rvm:
+  - 1.8.7
+  - 1.9.2
+  - 1.9.3
+  - ree

data/CHANGELOG.md

@@ -1,6 +1,12 @@
 CHANGELOG
 =========
 
+2.0.3 - 11/13/2011
+------------------
+* Add generator support. Fixes #8.
+* Add a Less::Rails::CssCompressor if config.assets.compress is true. Fixes #7.
+
+
 2.0.2 - 10/09/2011
 ------------------
 * Extend LESS with Rails asset pipeline helpers.

data/README.md

@@ -3,6 +3,7 @@
 This gem provides integration for Rails projects using the Less stylesheet language in the asset pipeline.
 
 
+
 ## Installing
 
 Just bundle up less-rails in your Gemfile. This will pull in less as a runtime dependency too.
@@ -10,6 +11,7 @@ Just bundle up less-rails in your Gemfile. This will pull in less as a runtime d
     gem 'less-rails'
 
 
+
 ## Configuration
 
 This gem was made for other gems to properly hook into one place to provide paths to the Less::Parser. For example, the less-rails-bootstrap project at http://github.com/metaskills/less-rails-bootstrap and each project should do the path configuration for you. If you need to, you can configure less-rails with additional paths. These paths have higher priority than those from your applications assets load paths.
@@ -21,6 +23,11 @@ MyProject::Application.configure do
 end
 ```
 
+#### About Compression
+
+If `config.assets.compress` is set to true, we will set the `config.assets.css_compressor` to `Less::Rails::CssCompressor.new` for you automatically. Feel free to set the `css_compressor` to something more stronger like `:yui` in your `config/environments/production.rb` file.
+
+
 
 ## Helpers
 
@@ -54,6 +61,33 @@ asset-data-url("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.
 
 
+
+## Generators
+
+Installation of the gem will set your applications stylesheet engine to use Less. It is possible to have many gems that set the stylesheet engine, for instance the sass-rails and/or stylus gems. In this case, you can resolve the ambiguity by setting the stylesheet engine in your `config/application.rb` file like so. Doing so would mean all generated assets will be in the a fresh `css.less` template.
+
+```ruby
+config.app_generators.stylesheet_engine :less
+```
+
+We have generators for both assets and scaffold in the `less` namespace. For instance the following would generate a blank `app/assets/stylesheets/posts.css.less` template.
+
+```
+$ rails generate less:assets posts
+```
+
+We also have a generator for rails scaffold CSS. Just like the Sass gem, we simply parse the scaffold.css in the default rails generator and save it as a scaffolds.css.less file. This is done automatically during other scaffold generator actions.
+
+
+
+## Testing
+
+Simply just run `bundle install` and `bundle exec rake` and the tests will will. We also use Travis CI to run our tests too. Current build status is:
+
+[![Build Status](https://secure.travis-ci.org/metaskills/less-rails.png)](http://travis-ci.org/metaskills/less-rails)
+
+
+
 ## License
 
 Less::Rails is Copyright (c) 2011 Ken Collins, <ken@metaskills.net> and is distributed under the MIT license.

data/lib/less/rails.rb

@@ -12,4 +12,5 @@ require 'sprockets/railtie'
 require 'less/rails/version'
 require 'less/rails/helpers'
 require 'less/rails/template_handlers'
+require 'less/rails/css_compressor'
 require 'less/rails/railtie'

data/lib/less/rails/css_compressor.rb

@@ -0,0 +1,11 @@
+module Less  
+  module Rails
+    class CssCompressor
+      
+      def compress(css)
+        ::Less::Parser.new.parse(css).to_css(:compress => true).strip
+      end
+      
+    end 
+  end
+end

data/lib/less/rails/railtie.rb

@@ -9,6 +9,7 @@ module Less
       config.less = ActiveSupport::OrderedOptions.new
       config.less.paths = []
       config.less.compress = false
+      config.app_generators.stylesheet_engine :less
       
       config.before_initialize do |app|
         require 'less'
@@ -26,6 +27,12 @@ module Less
         app.assets.context_class.less_config = app.config.less
       end
       
+      initializer 'less-rails.setup_compression', :group => :all do |app|
+        if app.config.assets.compress
+          app.config.assets.css_compressor = CssCompressor.new
+        end
+      end
+      
     end
   end
 end

data/lib/less/rails/version.rb

@@ -1,5 +1,5 @@
 module Less
   module Rails
-    VERSION = "2.0.2"
+    VERSION = "2.0.3"
   end
 end

data/lib/rails/generators/less/assets/assets_generator.rb

@@ -0,0 +1,15 @@
+require "rails/generators/named_base"
+
+module Less
+  module Generators
+    class AssetsGenerator < ::Rails::Generators::NamedBase
+      
+      source_root File.expand_path '../templates', __FILE__
+
+      def copy_less
+        template 'stylesheet.css.less', File.join('app/assets/stylesheets', class_path, "#{file_name}.css.less")
+      end
+      
+    end
+  end
+end

data/lib/rails/generators/less/assets/templates/stylesheet.css.less

@@ -0,0 +1,3 @@
+// Place all the styles related to the <%= name %> controller here.
+// They will automatically be included in application.css.
+// You can use Less here: http://lesscss.org/

data/lib/rails/generators/less/scaffold/scaffold_generator.rb

@@ -0,0 +1,17 @@
+require "less"
+require "rails/generators/named_base"
+require "rails/generators/rails/scaffold/scaffold_generator"
+
+module Less
+  module Generators
+    class ScaffoldGenerator < ::Rails::Generators::NamedBase
+      
+      def copy_stylesheet
+        file = File.join ::Rails::Generators::ScaffoldGenerator.source_root, 'scaffold.css'
+        css = Less::Parser.new.parse(File.read(file)).to_css
+        create_file "app/assets/stylesheets/scaffolds.css.less", css
+      end
+      
+    end
+  end
+end

data/test/cases/basics_spec.rb

@@ -12,5 +12,8 @@ class BasicsSpec < Less::Rails::Spec
     basics.must_match %r{#test-mixin span\{border:1px solid black;\}}
   end
   
+  it 'must have a CSSCompressor' do
+    Less::Rails::CssCompressor.new.compress('.class {width: 1+1}').must_equal '.class{width:2;}'
+  end
 
 end

data/test/cases/generators_spec.rb

@@ -0,0 +1,27 @@
+require 'spec_helper'
+require 'rails/generators/less/assets/assets_generator'
+require 'rails/generators/less/scaffold/scaffold_generator'
+
+class AssetsGeneratorSpec < Less::Rails::GeneratorSpec
+  
+  it 'should generate a posts.css.less file' do
+    run_generator ['posts']
+    assert_file 'app/assets/stylesheets/posts.css.less' do |contents|
+      contents.must_match %r{Place all the styles related to the posts controller here}
+      contents.must_match %r{You can use Less here}
+    end
+  end
+  
+end
+
+class ScaffoldGeneratorSpec < Less::Rails::GeneratorSpec
+  
+  it 'should parse and copy the scaffold to a less file' do
+    run_generator ['posts']
+    assert_file 'app/assets/stylesheets/scaffolds.css.less' do |contents|
+      contents.must_match %r{background-color: #fff}
+    end
+  end
+  
+end
+

data/test/spec_helper.rb

@@ -5,18 +5,20 @@ require 'less/rails'
 require 'minitest/spec'
 require 'minitest/autorun'
 require 'dummy_app/init'
+require 'rails/generators'
+require 'fileutils'
 
 module Less
   module Rails
+
     class Spec < MiniTest::Spec
-      
+            
       before do
         reset_config_options
         reset_caches
       end
       
-      
-      private
+      protected
       
       def dummy_app
         Dummy::Application
@@ -45,6 +47,75 @@ module Less
       end
       
     end
+    
+    # Heavily inspired by Rails::Generators::TestCase.
+    class GeneratorSpec < Spec
+      
+      include FileUtils
+      
+      class_attribute :destination_root, :current_path, :generator_class, :default_arguments
+      delegate        :destination_root, :current_path, :generator_class, :default_arguments, :to => :'self.class'
+      
+      self.current_path      = File.expand_path(Dir.pwd)
+      self.default_arguments = []
+      self.destination_root  = "#{Dummy::Application.root}/tmp"
+      
+      before { destination_root_is_set? ; ensure_current_path ; prepare_destination ; no_color! ; setup_generator_class }
+      after  { remove_destination ; ensure_current_path }
+      
+      protected
+      
+      def no_color!
+        Thor::Base.shell = Thor::Shell::Basic
+      end
+      
+      def destination_root_is_set?
+        raise "You need to configure your Less::Rails::GeneratorSpec destination root." unless destination_root
+      end
+      
+      def ensure_current_path
+        cd current_path
+      end
+      
+      def prepare_destination
+        remove_destination
+        mkdir_p destination_root
+      end
+      
+      def remove_destination
+        rm_rf destination_root
+      end
+      
+      def setup_generator_class
+        self.class.generator_class = Less::Generators.const_get(self.class.name.sub(/Spec$/, ''))
+      end
+      
+      def run_generator(args=default_arguments, config={})
+        capture(:stdout) { generator_class.start(args, config.reverse_merge(:destination_root => destination_root)) }
+      end
+
+      def generator(args=default_arguments, options={}, config={})
+        @generator ||= generator_class.new(args, options, config.reverse_merge(:destination_root => destination_root))
+      end
+      
+      def assert_file(relative, *contents)
+        absolute = File.expand_path(relative, destination_root)
+        assert File.exists?(absolute), "Expected file #{relative.inspect} to exist, but does not"
+        read = File.read(absolute) if block_given? || !contents.empty?
+        yield read if block_given?
+        contents.each do |content|
+          case content
+            when String
+              assert_equal content, read
+            when Regexp
+              assert_match content, read
+          end
+        end
+      end
+      alias :assert_directory :assert_file
+      
+    end
+    
   end
 end
 

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: less-rails
 version: !ruby/object:Gem::Version 
-  hash: 11
+  hash: 9
   prerelease: 
   segments: 
   - 2
   - 0
-  - 2
-  version: 2.0.2
+  - 3
+  version: 2.0.3
 platform: ruby
 authors: 
 - Ken Collins
@@ -15,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-10-09 00:00:00 -04:00
+date: 2011-11-13 00:00:00 -05:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -105,6 +105,7 @@ extra_rdoc_files: []
 
 files: 
 - .gitignore
+- .travis.yml
 - CHANGELOG.md
 - Gemfile
 - Guardfile
@@ -114,11 +115,16 @@ files:
 - less-rails.gemspec
 - lib/less-rails.rb
 - lib/less/rails.rb
+- lib/less/rails/css_compressor.rb
 - lib/less/rails/helpers.rb
 - lib/less/rails/railtie.rb
 - lib/less/rails/template_handlers.rb
 - lib/less/rails/version.rb
+- lib/rails/generators/less/assets/assets_generator.rb
+- lib/rails/generators/less/assets/templates/stylesheet.css.less
+- lib/rails/generators/less/scaffold/scaffold_generator.rb
 - test/cases/basics_spec.rb
+- test/cases/generators_spec.rb
 - test/cases/helpers_spec.rb
 - test/cases/railtie_spec.rb
 - test/dummy_app/app/assets/images/1x1.png
@@ -163,6 +169,7 @@ specification_version: 3
 summary: The dynamic stylesheet language for the Rails asset pipeline.
 test_files: 
 - test/cases/basics_spec.rb
+- test/cases/generators_spec.rb
 - test/cases/helpers_spec.rb
 - test/cases/railtie_spec.rb
 - test/dummy_app/app/assets/images/1x1.png