compass-rails 1.0.3 → 1.1.3

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    MmUwYjg0NjMwMzRhNjQ3NGUzYTQ5OThkY2VhMTU4MTc3ZjY4ODdhMg==
+  data.tar.gz: !binary |-
+    ODQ0YzAyNDIyNmI3NDU2OTJlZGJlMzg4MDdlODYyMzFkNmU4M2UzZQ==
+SHA512:
+  metadata.gz: !binary |-
+    NGQ0YjRlYTM1NTBiMWUzYzEyZGQwNmU4OThkNGJhMjc3NTRkYzgyY2JlYmI2
+    NjMyOWFiMjJmZGRiZjVhM2EyZjExNDUxMmMwZjM2ZmIwNTQxMDU0OTM2ZDg5
+    MzlmYjFhNTdiNmI1YmMwNjY0OWI3MDUyMWJkYWMxMWQyMmFkYjA=
+  data.tar.gz: !binary |-
+    YmNlMGQ2NTU2OWU3ZWYxN2FhN2M3NzNjYzAzNzEzZTkzN2Q4NmQxOTZlMTkz
+    Mjc4YWRhMGFiNzk3ODNlNTQwZmZhMzYwMjA5MDgxNWYxNmZlOWUxMDYyOGY1
+    MTUwZjQ2ZWJlMjVkNDYxMzdiN2FhZTA4YTk2ODM4MGY5ZTdhMjU=

data/.gitignore

@@ -3,6 +3,7 @@
 .bundle
 .config
 .yardoc
+gemfiles/*.gemfile.lock
 Gemfile.lock
 InstalledFiles
 _yardoc

data/.travis.yml

@@ -1,5 +1,4 @@
 rvm:
-  - 1.8.7
-  - 1.9.2
   - 1.9.3
+  - 2.0.0
 script: "bundle exec rake appraisal:install test"

data/Appraisals

@@ -1,7 +1,3 @@
-appraise "rails2" do
-  gem "rails", "2.3.14"
-end
-
 appraise "rails3" do
   gem "rails", "3.0.11"
 end
@@ -14,4 +10,9 @@ end
 appraise "rails32" do
   gem "rails", "~> 3.2"
   gem "sass-rails"
-end
+end
+
+appraise "rails40" do
+  gem "rails", "~> 4.0.0"
+  gem "sass-rails"
+end

data/Gemfile

@@ -4,13 +4,14 @@ source 'https://rubygems.org'
 gemspec
 
 group :assets do
-  gem 'compass'
-  gem 'compass-rails', :path => '.'
+  gem "compass", '~> 0.13.alpha.0'
+  gem "compass-rails", :path=>"."
+  gem 'compass-blueprint'
 end
 
 group :test do
   gem 'mocha'
-  gem "appraisal", :git => 'git://github.com/scottdavis/appraisal.git'
+  gem "appraisal", :git => 'https://github.com/scottdavis/appraisal.git'
   gem 'rainbow'
 end
 

data/README.md

@@ -1,13 +1,15 @@
 # CompassRails
 
+[![Build Status](https://travis-ci.org/Compass/compass-rails.png?branch=stable)](https://travis-ci.org/Compass/compass-rails)
+[![Code Climate](https://codeclimate.com/github/Compass/compass-rails.png)](https://codeclimate.com/github/Compass/compass-rails)
+
 Compass rails is an adapter for the [Compass Stylesheet Authoring
-Framework](http://compass-style.org) for [Ruby on Rails](http://http://rubyonrails.org/).
+Framework](http://compass-style.org) for [Ruby on Rails](http://rubyonrails.org/).
 
 Since Compass v0.12, this adapter is the only way to install compass
 into your rails application.
 
-This adapter supports rails versions 2.3 and greater. Rails 2.3 and 3.0 users
-please read the caveats below.
+This adapter supports Rails 3.x, 4.x releases.
 
 ## Installation
 
@@ -27,6 +29,29 @@ And then execute:
 
     $ bundle
 
+## Usage
+
+Change your `application.css` to `application.css.scss` or `application.css.sass` and use `@import` to your hearts content. Ex:
+
+```scss
+@import "project/mixins";
+@import "project/base";
+
+```
+
+*or*
+
+Use `application.css` to require files that use compass features. Ex:
+```css
+/*
+ *= require styleguide_full_of_compass_stuff
+ */
+```
+
+*Don't* use `*= require something` within your SCSS or SASS files. You're gonna have a bad time.
+
+## Optional
+
 To set up your project with starter stylesheets and a configuration
 file:
 
@@ -38,21 +63,7 @@ If using a compass-based framework (like [susy](http://susy.oddbird.net/) or [bl
 
 Note that the `compass init` step is optional if you have a project running Rails 3.0 or greater.
 
-## Upgrading existing rails projects using Compass to CompassRails
-
-First and foremost, follow the installation instructions above.
-
-CompassRails uses the rails convention for stylesheet locations even in
-older versions of rails that do not use the assets pipeline.
-If you have your stylesheets already in `app/stylesheets`, you have two choices:
-
-1. Move your stylesheets to `app/assets/stylesheets`.
-2. Configure your project to look in the **legacy location** of
-   `app/stylesheets` by setting `config.compass.sass_dir =
-   "app/stylesheets"` in your rails configuration or by setting
-   `sass_dir = "app/stylesheets"` in your compass configuration file.
-
-## Configuration
+### Configuration
 
 If you have a compass configuration file (recommended) then you can
 use the [Compass configuration 
@@ -62,12 +73,17 @@ files, then you should understand that the compass configuration
 options explained there will be methods and properties on the `config.compass`
 configuration object exposed to rails within any configuration block.
 
-## Usage
+### Notes On Sprockets Directives
+
+Sprockets, used by the rails asset pipeline, provides directives for
+doing things like requiring. These **must not** be used with Sass files.
+Instead use the sass `@import` directive. In rails projects, the
+`@import` directive is configured to work with sprockets via `sass-rails`. For more information on importing in rails 3.1 or greater see the [Sass-Rails README](https://github.com/rails/sass-rails/blob/master/README.md)
 
 ### Developing with Rails-based Compilation
 
 By default, your sass files in `app/assets/stylesheets` will be
-automatically compiled by the the [`Sass::Plugin`](http://sass-lang.com/docs/yardoc/Sass/Plugin.html) or the [Rails asset
+automatically compiled by the [`Sass::Plugin`](http://sass-lang.com/docs/yardoc/Sass/Plugin.html) or the [Rails asset
 pipeline](http://guides.rubyonrails.org/asset_pipeline.html) depending on the version of rails that you use.
 
 When using this approach you will need to reload your webpage in order
@@ -93,11 +109,7 @@ end
 To return to using the Rails-based compilation mode, simply delete
 the compiled stylesheets and remove any configuration changes.
 
-### Compiling for Production
-
-If using the Rails asset pipeline run:
-
-    $ rake assets:precompile
+### Compiling for Production without Asset Pipeline
 
 If not using the asset pipeline run:
 
@@ -109,10 +121,7 @@ stylesheets.
 
 ### Installing Compass extensions
 
-Step 1: If the extension is a rubygem, Add it to your Gemfile in the
-`:assets` group and run the `bundle` command to install it.
-If the extension is a zip file, unzip it into the
-`vendor/plugins/compass_extensions` directory of your project.
+Step 1: Add it to your Gemfile in the `:assets` group and run the `bundle` command to install it.
 
 Step 2: Install the extension's assets: `bundle exec compass install 
 <extension/template>`
@@ -140,18 +149,9 @@ config.compass.require "susy"
 
 to your application.rb configuration file.
 
-
-### Notes On Sprockets Directives
-
-Sprockets, used by the rails asset pipeline, provides directives for
-doing things like requiring. These **must not** be used with Sass files.
-Instead use the sass `@import` directive. In rails projects, the
-`@import` directive is configured to work with sprockets via `sass-rails`. For more information on importing in rails 3.1 or greater see the [Sass-Rails README](https://github.com/rails/sass-rails/blob/master/README.markdown)
-
 ## Rails 3.1 Caveats
 
-There was a bug in rails 3.1.0 -- please make sure you are running 3.1.1
-at the earliest for this version of rails.
+compass-rails requires Rails 3.1.1 and greater. Also, Rails 3.1 is out of support so consider upgrading.
 
 ## Rails 3.0 Caveats
 
@@ -168,34 +168,21 @@ to this:
 Bundler.require(:default, :assets, Rails.env) if defined?(Bundler)
 ```
 
-## Rails 2.3 Caveats
-
-Compass requires that your rails 2.3 project is using Bundler to manage
-your rubygems. If you haven't yet set up your rails 2.3 project to use Bundler,
-please do so prior to upgrading. [Bundler installation guide for rails
-2.3](http://gembundler.com/rails23.html).
+ Also, Rails 3.0 is out of support so consider upgrading.
 
-After following the instructions there, if you want rails to compile
-your stylesheets (instead of using the compass watcher) you need
-edit `config/boot.rb` and change this:
+## Upgrading Rails 3.0 and older projects to compass-rails
 
-```ruby
-Rails::Initializer.class_eval do
-  def load_gems
-    @bundler_loaded ||= Bundler.require :default, Rails.env
-  end
-end
-```
+First and foremost, follow the installation instructions above.
 
-To this:
+CompassRails uses the rails convention for stylesheet locations even in
+older versions of rails that do not use the assets pipeline.
+If you have your stylesheets already in `app/stylesheets`, you have two choices:
 
-```ruby
-Rails::Initializer.class_eval do
-  def load_gems
-    @bundler_loaded ||= Bundler.require :default, :assets, Rails.env
-  end
-end
-```
+1. Move your stylesheets to `app/assets/stylesheets`.
+2. Configure your project to look in the **legacy location** of
+   `app/stylesheets` by setting `config.compass.sass_dir =
+   "app/stylesheets"` in your rails configuration or by setting
+   `sass_dir = "app/stylesheets"` in your compass configuration file.
 
 ## Contributing
 

data/changelog.markdown

@@ -0,0 +1,11 @@
+# Compass Rails
+
+## 2.0.alpha.0
+
+* Removed rails 2.x support
+* Added Alpha support for rails 4
+
+## 1.0.3
+
+* StaticCompiler hack so sprite source files dont show up in manifest
+* Compass version bump to 0.12.2

data/compass-rails.gemspec

@@ -2,10 +2,10 @@
 require File.expand_path('../lib/compass-rails/version', __FILE__)
 
 Gem::Specification.new do |gem|
-  gem.authors       = ["Scott Davis", "Chris Eppstein"]
-  gem.email         = ["jetviper21@gmail.com", "chris@eppsteins.net"]
-  gem.description   = %q{Integrate Compass into Rails 2.3 and up.}
-  gem.summary       = %q{Integrate Compass into Rails 2.3 and up.}
+  gem.authors       = ["Scott Davis", "Chris Eppstein", "Craig McNamara"]
+  gem.email         = ["jetviper21@gmail.com", "chris@eppsteins.net", "craig.mcnamara@gmail.com"]
+  gem.description   = %q{Integrate Compass into Rails 3.0 and up.}
+  gem.summary       = %q{Integrate Compass into Rails 3.0 and up.}
   gem.homepage      = "https://github.com/Compass/compass-rails"
 
   gem.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
@@ -14,7 +14,8 @@ Gem::Specification.new do |gem|
   gem.name          = "compass-rails"
   gem.require_paths = ["lib"]
   gem.version       = CompassRails::VERSION
+  gem.license       = "MIT"
 
-  gem.add_dependency 'compass', '>= 0.12.2', '< 0.14'
+  gem.add_dependency 'compass', '>= 0.12.2'
 
 end

data/gemfiles/rails3.gemfile

@@ -9,12 +9,13 @@ gem "guard-test"
 gem "rails", "3.0.11"
 
 group :assets do
-  gem "compass"
+  gem "compass", "~> 0.13.alpha.0"
   gem "compass-rails", :path=>".."
+  gem "compass-blueprint"
 end
 group :test do
   gem "mocha"
-  gem "appraisal", :git=>"git://github.com/scottdavis/appraisal.git"
+  gem "appraisal", :git=>"https://github.com/scottdavis/appraisal.git"
   gem "rainbow"
 end
 

data/gemfiles/rails31.gemfile

@@ -10,12 +10,13 @@ gem "rails", "3.1.3"
 gem "sass-rails"
 
 group :assets do
-  gem "compass"
+  gem "compass", "~> 0.13.alpha.0"
   gem "compass-rails", :path=>".."
+  gem "compass-blueprint"
 end
 group :test do
   gem "mocha"
-  gem "appraisal", :git=>"git://github.com/scottdavis/appraisal.git"
+  gem "appraisal", :git=>"https://github.com/scottdavis/appraisal.git"
   gem "rainbow"
 end
 

data/gemfiles/rails32.gemfile

@@ -10,12 +10,13 @@ gem "rails", "~> 3.2"
 gem "sass-rails"
 
 group :assets do
-  gem "compass"
+  gem "compass", "~> 0.13.alpha.0"
   gem "compass-rails", :path=>".."
+  gem "compass-blueprint"
 end
 group :test do
   gem "mocha"
-  gem "appraisal", :git=>"git://github.com/scottdavis/appraisal.git"
+  gem "appraisal", :git=>"https://github.com/scottdavis/appraisal.git"
   gem "rainbow"
 end
 

data/gemfiles/{rails2.gemfile → rails40.gemfile}

@@ -6,15 +6,17 @@ gem "rb-fsevent", :require=>false
 gem "ruby_gntp", :require=>false
 gem "guard"
 gem "guard-test"
-gem "rails", "2.3.14"
+gem "rails", "~> 4.0.0"
+gem "sass-rails"
 
 group :assets do
-  gem "compass"
+  gem "compass", "~> 0.13.alpha.0"
   gem "compass-rails", :path=>".."
+  gem "compass-blueprint"
 end
 group :test do
   gem "mocha"
-  gem "appraisal", :git=>"git://github.com/scottdavis/appraisal.git"
+  gem "appraisal", :git=>"https://github.com/scottdavis/appraisal.git"
   gem "rainbow"
 end
 

data/lib/compass-rails/configuration/{3_1.rb → asset_pipeline.rb}

@@ -1,6 +1,6 @@
 module CompassRails
   module Configuration
-    module Rails3_1
+    module AssetPipeline
 
       def default_images_dir
         File.join("app", "assets", "images")
@@ -42,6 +42,10 @@ module CompassRails
         ::Rails.application.config.sass.preferred_syntax rescue nil
       end
 
+      def default_sprite_load_path
+        CompassRails.sprockets.paths
+      end
+
     end
   end
 end

data/lib/compass-rails/patches/3_1.rb

@@ -1,3 +1,4 @@
+require 'compass-rails/patches/compass'
 require 'compass-rails/patches/static_compiler'
 
 module Sass::Script::Functions
@@ -6,20 +7,6 @@ module Sass::Script::Functions
   end
 end
 
-
-module Compass::RailsImageFunctionPatch
-  private
-  
-  def image_path_for_size(image_file)
-    begin
-      file = ::Rails.application.assets.find_asset(image_file)
-      return file
-    rescue ::Sprockets::FileOutsidePaths
-      return super(image_file)
-    end
-  end
-end
-
 module Sass::Script::Functions
   include Compass::RailsImageFunctionPatch
 end

data/lib/compass-rails/patches/4_0.rb

@@ -0,0 +1,25 @@
+require 'compass-rails/patches/compass'
+require 'compass-rails/patches/sass_importer'
+require 'compass-rails/patches/sprite_importer'
+
+module Sass::Script::Functions
+  def generated_image_url(path, only_path = nil)
+    cachebust_generated_images
+    asset_url(path)
+  end
+
+  def cachebust_generated_images
+    generated_images_path = Rails.root.join(Compass.configuration.generated_images_dir).to_s
+    sprockets_entries = options[:sprockets][:environment].send(:trail).instance_variable_get(:@entries)
+    sprockets_entries.delete(generated_images_path) if sprockets_entries.has_key? generated_images_path
+  end
+end
+
+module Sass::Script::Functions
+  include Compass::RailsImageFunctionPatch
+end
+
+# Wierd that this has to be re-included to pick up sub-modules. Ruby bug?
+class Sass::Script::Functions::EvaluationContext
+  include Sass::Script::Functions
+end

data/lib/compass-rails/patches/compass.rb

@@ -0,0 +1,12 @@
+module Compass::RailsImageFunctionPatch
+  private
+
+  def image_path_for_size(image_file)
+    begin
+      file = ::Rails.application.assets.find_asset(image_file)
+      return file
+    rescue ::Sprockets::FileOutsidePaths
+      return super(image_file)
+    end
+  end
+end

data/lib/compass-rails/patches/sass_importer.rb

@@ -0,0 +1,31 @@
+module Sprockets
+  class SassTemplate < Tilt::Template
+    def evaluate(context, locals, &block)
+      # Use custom importer that knows about Sprockets Caching
+      cache_store = SassCacheStore.new(context.environment)
+      paths  = context.environment.paths.map { |path| CompassRails::SpriteImporter.new(context, path) }
+      paths += context.environment.paths.map { |path| SassImporter.new(context, path) }
+      paths += ::Rails.application.config.sass.load_paths
+
+
+      options = CompassRails.sass_config.merge( {
+        :filename => eval_file,
+        :line => line,
+        :syntax => syntax,
+        :cache_store => cache_store,
+        :importer => SassImporter.new(context, context.pathname),
+        :load_paths => paths,
+        :sprockets => {
+          :context => context,
+          :environment => context.environment
+        }
+      })
+
+      ::Sass::Engine.new(data, options).render
+    rescue ::Sass::SyntaxError => e
+      # Annotates exception message with parse line number
+      context.__LINE__ = e.sass_backtrace.first[:line]
+      raise e
+    end
+  end
+end

data/lib/compass-rails/patches/sprite_importer.rb

@@ -1,38 +1,30 @@
 require 'sprockets'
 require 'compass/sprite_importer'
 
-module Compass
-  class SpriteImporter < Sass::Importers::Base
+module CompassRails
+  class SpriteImporter < Compass::SpriteImporter
+    attr_reader :context, :root
 
-    alias :old_find :find
+    def initialize(context, root)
+      @context = context
+      @root = root
+    end
 
     def find(uri, options)
-
-      if old = old_find(uri, options)
-        @_options = options
+      if old = super(uri, options)
         self.class.files(uri).each do |file|
-          if pathname = resolve(file)
-            context.depend_on(pathname)
+          puts file.inspect
+          relative_path = Pathname.new(file).relative_path_from(Pathname.new(root))
+          begin
+            pathname = context.resolve(relative_path)
+            context.depend_on_asset(pathname)
+          rescue Sprockets::FileNotFound
+
           end
         end
       end
 
       old
     end
-
-  private
-
-    def resolve(uri)
-      resolver.resolve(Pathname.new(uri))
-    end
-
-    def context
-     resolver.context
-    end
-
-    def resolver
-      @_options[:custom][:resolver]
-    end
-
   end
 end

data/lib/compass-rails/patches/static_compiler.rb

@@ -1,5 +1,4 @@
 require 'sprockets/static_compiler'
-
 module Sprockets
   class StaticCompiler
     cattr_accessor :generated_sprites
@@ -10,3 +9,4 @@ module Sprockets
     alias_method_chain :write_manifest, :sprites
   end
 end
+

data/lib/compass-rails/patches.rb

@@ -1,6 +1,6 @@
 if CompassRails.rails31? || CompassRails.rails32?
-  unless CompassRails.rails_loaded? 
-    CompassRails.load_rails
-  end
+  CompassRails.load_rails
   require 'compass-rails/patches/importer'
-end
+elsif CompassRails.rails4?
+  CompassRails.load_rails
+end

data/lib/compass-rails/railties/3_1.rb

@@ -88,12 +88,16 @@ module CompassRails
   class Railtie < Rails::Railtie
 
     initializer "compass.initialize_rails", :group => :all do |app|
-      require 'compass-rails/patches/3_1'
-      # Configure compass for use within rails, and provide the project configuration
-      # that came via the rails boot process.
-      CompassRails.check_for_double_boot!
-      Compass.discover_extensions!
-      CompassRails.configure_rails!(app)
+      if CompassRails.asset_pipeline_enabled?
+        require 'compass-rails/patches/3_1'
+        # Configure compass for use within rails, and provide the project configuration
+        # that came via the rails boot process.
+        CompassRails.check_for_double_boot!
+        Compass.discover_extensions!
+        CompassRails.configure_rails!(app)
+      else
+        CompassRails.initialize!(app.config.compass)
+      end
     end
   end
 end