sass-rails3 4.0.1

data/.gitignore

@@ -0,0 +1,7 @@
+.DS_Store
+.idea/*
+*.gem
+.bundle
+*.lock
+pkg/*
+.sass-cache

data/.travis.yml

@@ -0,0 +1,22 @@
+language: ruby
+rvm:
+ - 1.9.3
+ - 2.0.0
+ - 2.1.0
+gemfile:
+  - test/gemfiles/Gemfile-master
+  - Gemfile
+before_install: gem install bundler
+script: bundle exec rake test
+notifications:
+  email: false
+  irc:
+    on_success: change
+    on_failure: always
+    channels:
+      - "irc.freenode.org#rails-contrib"
+  campfire:
+    on_success: change
+    on_failure: always
+    rooms:
+      - secure: "CGWvthGkBKNnTnk9YSmf9AXKoiRI33fCl5D3jU4nx3cOPu6kv2R9nMjt9EAo\nOuS4Q85qNSf4VNQ2cUPNiNYSWQ+XiTfivKvDUw/QW9r1FejYyeWarMsSBWA+\n0fADjF1M2dkDIVLgYPfwoXEv7l+j654F1KLKB69F0F/netwP9CQ="

data/CHANGELOG.md

@@ -0,0 +1,40 @@
+# CHANGELOG
+
+## 4.0.1 (Oct 15, 2013)
+
+* Remove Post Processors from asset evaluation.
+
+## 4.0.0 (Jun 25, 2013)
+
+* Add support for importing ERB files.
+* Remove `Sass::Rails::Compressor`. Use `Sprockets::SassCompressor` (`:sass` option) instead.
+* Remove `tilt` dependency.
+* Bump `sprockets-rails` to `2.0.0.rc4`.
+
+## 4.0.0.rc1 (Apr 18, 2013)
+
+* No changes.
+
+## 4.0.0.beta1 (Feb 25, 2013)
+
+* Remove `compress` option from `config.assets`. Instead, turn on
+  compression for all environments except development.
+* Deprecate `asset_path` and `asset_url` with two arguments.
+* Add Rails 4 support.
+* Drop Ruby 1.8 support.
+
+## 3.1.5.rc.1 (Oct 16, 2011)
+
+* Several bug fixes.
+* Performance and bug fixes when compressing stylesheets.
+* Update dependency to latest sass stable release to fix caching issues.
+
+## 3.1.2 (Sept 15, 2011)
+
+* Add `asset-data-url` helper for base-64 encoding of assets within stylesheets.
+* Add explicit dependency on sprockets.
+
+## 3.1.1 (Sept 13, 2011)
+
+* Add explicit version dependency on tilt.
+* Add MIT License.

data/Gemfile

@@ -0,0 +1,8 @@
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in sass-rails3.gemspec
+gemspec
+
+gem "rails"
+
+gem "sqlite3"

data/MIT-LICENSE

@@ -0,0 +1,21 @@
+Copyright (c) 2011 Christopher Eppstein
+
+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,98 @@
+# Official Ruby-on-Rails Integration with Sass
+
+This gem provides official integration for Ruby on Rails projects with the Sass stylesheet language.
+
+## Installing
+
+Since Rails 3.1, new Rails projects will be already configured to use Sass. If you are upgrading to Rails 3.1 you will need to add the following to your Gemfile:
+
+    gem 'sass-rails3'
+
+## Configuration
+
+To configure Sass via Rails set use `config.sass` in your
+application and/or environment files to set configuration
+properties that will be passed to Sass.
+
+### Options
+
+The [list of supported options](http://sass-lang.com/docs/yardoc/file.SASS_REFERENCE.html#options)
+can be found on the Sass Website with the following caveats:
+
+1. `:style` - This option is not supported. This is determined by the Rails environment. It's `:expanded` only on development, otherwise it's `:compressed`.
+2. `:never_update` - This option is not supported. Instead set `config.assets.enabled = false`
+3. `:always_update` - This option is not supported. Sprockets uses a controller to access stylesheets in development mode instead of a full scan for changed files.
+4. `:always_check` - This option is not supported. Sprockets always checks in development.
+5. `:syntax` - This is determined by the file's extensions.
+6. `:filename` - This is determined by the file's name.
+7. `:line` - This is provided by the template handler.
+
+### Example
+
+    MyProject::Application.configure do
+      config.sass.line_comments = false
+      config.sass.cache = false
+    end
+
+## Important Note
+
+Sprockets provides some directives that are placed inside of comments called `require`, `require_tree`, and
+`require_self`. **<span style="color:#c00">DO NOT USE THEM IN YOUR SASS/SCSS FILES.</span>** They are very
+primitive and do not work well with Sass files. Instead, use Sass's native `@import` directive which
+`sass-rails3` has customized to integrate with the conventions of your Rails projects.
+
+## Features
+
+### Glob Imports
+
+When in Rails, there is a special import syntax that allows you to
+glob imports relative to the folder of the stylesheet that is doing the importing.
+
+* `@import "mixins/*"` will import all the files in the mixins folder
+* `@import "mixins/**/*"` will import all the files in the mixins tree
+
+Any valid ruby glob may be used. The imports are sorted alphabetically.
+
+**NOTE:** It is recommended that you only use this when importing pure library
+files (containing mixins and variables) because it is difficult to control the
+cascade ordering for imports that contain styles using this approach.
+
+### Asset Helpers
+When using the asset pipeline, paths to assets must be rewritten.
+When referencing assets use the following asset helpers (underscored in Ruby, hyphenated
+in Sass):
+
+#### `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 a 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, stylesheet.
+
+* `image-path("rails.png")` becomes `"/assets/rails.png"`
+* `image-url("rails.png")` becomes `url(/assets/rails.png)`
+
+#### `asset-data-url($relative-asset-path)`
+Returns a url reference to the Base64-encoded asset at the specified path.
+
+* `asset-data-url("rails.png")` becomes `url(data:image/png;base64,iVBORw0K...)`
+
+## Running Tests
+
+    $ bundle install
+    $ bundle exec rake test
+
+If you need to test against local gems, use Bundler's gem :path option in the Gemfile and also edit `test/support/test_helper.rb` and tell the tests where the gem is checked out.
+
+## Code Status
+
+* [![Travis CI](https://api.travis-ci.org/rails/sass-rails.png)](http://travis-ci.org/rails/sass-rails3)
+* [![Gem Version](https://badge.fury.io/rb/sass-rails.png)](http://badge.fury.io/rb/sass-rails3)
+* [![Dependencies](https://gemnasium.com/rails/sass-rails.png)](https://gemnasium.com/rails/sass-rails3)

data/Rakefile

@@ -0,0 +1,29 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+require 'rake/testtask'
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'lib'
+  t.libs << 'test'
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = false
+end
+
+desc 'Default: run unit tests.'
+task default: :test
+
+specname = "sass-rails3.gemspec"
+deps = `git ls-files`.split("\n") - [specname]
+
+file specname => deps do
+  files       = `git ls-files`.split("\n")
+  test_files  = `git ls-files -- {test,spec,features}/*`.split("\n")
+  executables = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+
+  require 'erb'
+
+  File.open specname, 'w:utf-8' do |f|
+    f.write ERB.new(File.read("#{specname}.erb")).result(binding)
+  end
+end

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

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

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

@@ -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 Sass here: http://sass-lang.com/

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

@@ -0,0 +1,9 @@
+require "rails/generators/sass_scaffold"
+
+module Sass
+  module Generators
+    class ScaffoldGenerator < ::Sass::Generators::ScaffoldBase
+      def syntax() :sass end
+    end
+  end
+end

data/lib/rails/generators/sass_scaffold.rb

@@ -0,0 +1,16 @@
+require "sass/css"
+require "rails/generators/named_base"
+
+module Sass
+  module Generators
+    class ScaffoldBase < ::Rails::Generators::NamedBase
+      def copy_stylesheet
+        dir = ::Rails::Generators::ScaffoldGenerator.source_root
+        file = File.join(dir, "scaffold.css")
+        converted_contents = ::Sass::CSS.new(File.read(file)).render(syntax)
+        create_file "app/assets/stylesheets/scaffolds.css.#{syntax}", converted_contents
+      end
+    end
+  end
+end
+

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

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

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

@@ -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 Sass (SCSS) here: http://sass-lang.com/

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

@@ -0,0 +1,10 @@
+require "rails/generators/sass_scaffold"
+
+module Scss
+  module Generators
+    class ScaffoldGenerator < ::Sass::Generators::ScaffoldBase
+      def syntax() :scss end
+    end
+  end
+end
+

data/lib/sass-rails3.rb

@@ -0,0 +1 @@
+require 'sass/rails'

data/lib/sass/rails.rb

@@ -0,0 +1,10 @@
+module Sass
+  module Rails
+    autoload :Logger, 'sass/rails/logger'
+  end
+end
+
+require 'sass/rails/version'
+require 'sass/rails/helpers'
+require 'sass/rails/importer'
+require 'sass/rails/railtie'

data/lib/sass/rails/helpers.rb

@@ -0,0 +1,30 @@
+require 'sprockets/sass_functions'
+require 'active_support/deprecation'
+
+module Sprockets
+  module SassFunctions
+    if instance_methods.map(&:to_sym).include?(:asset_path)
+      undef_method :asset_path
+    end
+
+    def asset_path(path, kind = nil)
+      ActiveSupport::Deprecation.warn "asset_path with two arguments is deprecated. Use asset_path(#{path}) instead." if kind
+
+      Sass::Script::String.new(sprockets_context.asset_path(path.value), :string)
+    end
+
+    if instance_methods.map(&:to_sym).include?(:asset_url)
+      undef_method :asset_url
+    end
+
+    def asset_url(path, kind = nil)
+      ActiveSupport::Deprecation.warn "asset_url with two arguments is deprecated. Use asset_url(#{path}) instead." if kind
+
+      Sass::Script::String.new("url(" + sprockets_context.asset_path(path.value) + ")")
+    end
+
+    def asset_data_url(path)
+      Sass::Script::String.new("url(" + sprockets_context.asset_data_uri(path.value) + ")")
+    end
+  end
+end

data/lib/sass/rails/importer.rb

@@ -0,0 +1,91 @@
+require 'sprockets/sass_importer'
+
+module Sprockets
+  class SassImporter < Sass::Importers::Filesystem
+    GLOB = /\*|\[.+\]/
+
+    attr_reader :context
+    private :context
+
+    def extensions
+      {
+        'css'          => :scss,
+        'css.scss'     => :scss,
+        'css.sass'     => :sass,
+        'css.erb'      => :scss,
+        'scss.erb'     => :scss,
+        'sass.erb'     => :sass,
+        'css.scss.erb' => :scss,
+        'css.sass.erb' => :sass
+      }.merge!(super)
+    end
+
+    def find_relative(name, base, options)
+      if name =~ GLOB
+        glob_imports(name, Pathname.new(base), options)
+      else
+        engine_from_path(name, File.dirname(base), options)
+      end
+    end
+
+    def find(name, options)
+      if name =~ GLOB
+        nil # globs must be relative
+      else
+        engine_from_path(name, root, options)
+      end
+    end
+
+    def each_globbed_file(glob, base_pathname, options)
+      Dir["#{base_pathname}/#{glob}"].sort.each do |filename|
+        next if filename == options[:filename]
+        yield filename if File.directory?(filename) || context.asset_requirable?(filename)
+      end
+    end
+
+    def glob_imports(glob, base_pathname, options)
+      contents = ""
+      each_globbed_file(glob, base_pathname.dirname, options) do |filename|
+        if File.directory?(filename)
+          context.depend_on(filename)
+        elsif context.asset_requirable?(filename)
+          context.depend_on(filename)
+          contents << "@import #{Pathname.new(filename).relative_path_from(base_pathname.dirname).to_s.inspect};\n"
+        end
+      end
+      return nil if contents.empty?
+      Sass::Engine.new(contents, options.merge(
+        :filename => base_pathname.to_s,
+        :importer => self,
+        :syntax => :scss
+      ))
+    end
+
+    private
+
+      def engine_from_path(name, dir, options)
+        full_filename, syntax = Sass::Util.destructure(find_real_file(dir, name, options))
+        return unless full_filename && File.readable?(full_filename)
+
+        engine = Sass::Engine.new(evaluate(full_filename), options.merge(
+          syntax: syntax,
+          filename: full_filename,
+          importer: self
+        ))
+
+        if engine && (filename = engine.options[:filename])
+          @context.depend_on(filename)
+        end
+
+        engine
+      end
+
+      def evaluate(filename)
+        attributes = context.environment.attributes_for(filename)
+        processors = context.environment.preprocessors(attributes.content_type) +
+          attributes.engines.reverse - [Sprockets::ScssTemplate, Sprockets::SassTemplate]
+
+        context.evaluate(filename, processors: processors)
+      end
+  end
+end