sass-rails 3.2.3 → 6.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: d162298f6dcc547ef3c5e3e51d6d5bca7df731e8161737f03b01b05e3c77aba3
+  data.tar.gz: 2f10eb26a35786fa327e5ede671c6e487881c6bf85cce2eea5481aec63ab99db
+SHA512:
+  metadata.gz: 4862c7852e9d3928e48ef3d8a314e8872557d94345a8a8845f6c3fc7f80e0166947c07fbf09d11505a86b3f8075d933f5576c45ef5d90eadcf0980707cbf549e
+  data.tar.gz: 75616f8708d8f20b2d32d84adf73d779c193c18d6ac7784a3d9ba10fc4309e7694dc39f09087daf6ec993357e363ebe2d2e3292160ae4e2944ed6e50f105a3da

data/MIT-LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2011 Christopher Eppstein
+Copyright (c) 2011-2019 Christopher Eppstein
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/README.md

@@ -0,0 +1,103 @@
+# 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:
+
+```ruby
+gem 'sass-rails'
+```
+
+## 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
+
+- `preferred_syntax` - This option determines the default Sass syntax and file extensions that will be used by Rails generators. Can be `:scss` (default CSS-compatible SCSS syntax) or `:sass` (indented Sass syntax).
+
+The [list of supported Sass options](http://sass-lang.com/docs/yardoc/file.SASS_REFERENCE.html#options)
+can be found on the Sass Website with the following caveats:
+
+- `:style` - This option is not supported. This is determined by the Rails environment. It's `:expanded` only on development, otherwise it's `:compressed`.
+- `:never_update` - This option is not supported. Instead set `config.assets.enabled = false`
+- `: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.
+- `:always_check` - This option is not supported. Sprockets always checks in development.
+- `:syntax` - This is determined by the file's extensions.
+- `:filename` - This is determined by the file's name.
+- `:line` - This is provided by the template handler.
+
+### Example
+```ruby
+MyProject::Application.configure do
+  config.sass.preferred_syntax = :sass
+  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-rails` 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")` returns `"/assets/rails.png"`
+
+#### `asset-url($relative-asset-path)`
+Returns a url reference to the asset.
+
+* `asset-url("rails.png")` returns `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")` returns `"/assets/rails.png"`
+* `image-url("rails.png")` returns `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")` returns `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.svg)](http://travis-ci.org/rails/sass-rails)
+* [![Gem Version](https://badge.fury.io/rb/sass-rails.svg)](http://badge.fury.io/rb/sass-rails)

data/lib/sass/rails/importer.rb

@@ -1,122 +1,5 @@
-require 'sprockets'
+# frozen_string_literal: true
 
-module Sass::Rails
-  class Importer
-    GLOB = /\*|\[.+\]/
-    PARTIAL = /^_/
-    HAS_EXTENSION = /\.css(.s[ac]ss)?$/
+require "active_support/deprecation"
 
-    SASS_EXTENSIONS = {
-      ".css.sass" => :sass,
-      ".css.scss" => :scss,
-      ".sass" => :sass,
-      ".scss" => :scss
-    }
-    attr_reader :context
-
-    def initialize(context)
-      @context = context
-      @resolver = Resolver.new(context)
-    end
-
-    def sass_file?(filename)
-      filename = filename.to_s
-      SASS_EXTENSIONS.keys.any?{|ext| filename[ext]}
-    end
-
-    def syntax(filename)
-      filename = filename.to_s
-      SASS_EXTENSIONS.each {|ext, syntax| return syntax if filename[(ext.size+2)..-1][ext]}
-      nil
-    end
-
-    def resolve(name, base_pathname = nil)
-      name = Pathname.new(name)
-      if base_pathname && base_pathname.to_s.size > 0
-        root = Pathname.new(context.root_path)
-        name = base_pathname.relative_path_from(root).join(name)
-      end
-      partial_name = name.dirname.join("_#{name.basename}")
-      @resolver.resolve(name) || @resolver.resolve(partial_name)
-    end
-
-    def find_relative(name, base, options)
-      base_pathname = Pathname.new(base)
-      if name =~ GLOB
-        glob_imports(name, base_pathname, options)
-      elsif pathname = resolve(name, base_pathname.dirname)
-        context.depend_on(pathname)
-        if sass_file?(pathname)
-          Sass::Engine.new(pathname.read, options.merge(:filename => pathname.to_s, :importer => self, :syntax => syntax(pathname)))
-        else
-          Sass::Engine.new(@resolver.process(pathname), options.merge(:filename => pathname.to_s, :importer => self, :syntax => :scss))
-        end
-      else
-        nil
-      end
-    end
-
-    def find(name, options)
-      if name =~ GLOB
-        nil # globs must be relative
-      elsif pathname = resolve(name)
-        context.depend_on(pathname)
-        if sass_file?(pathname)
-          Sass::Engine.new(pathname.read, options.merge(:filename => pathname.to_s, :importer => self, :syntax => syntax(pathname)))
-        else
-          Sass::Engine.new(@resolver.process(pathname), options.merge(:filename => pathname.to_s, :importer => self, :syntax => :scss))
-        end
-      else
-        nil
-      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
-
-    def mtime(name, options)
-      if name =~ GLOB && options[:filename]
-        mtime = nil
-        each_globbed_file(name, Pathname.new(options[:filename]).dirname, options) do |p|
-          mtime ||= File.mtime(p)
-          mtime = [mtime, File.mtime(p)].max
-        end
-        mtime
-      elsif pathname = resolve(name)
-        pathname.mtime
-      end
-    end
-
-    def key(name, options)
-      ["Sprockets:" + File.dirname(File.expand_path(name)), File.basename(name)]
-    end
-
-    def to_s
-      "Sass::Rails::Importer(#{context.pathname})"
-    end
-
-  end
-
-end
+ActiveSupport::Deprecation.warn "Sass::Rails::Importer has been removed, please use SassC::Rails::Importer instead."

data/lib/sass/rails/logger.rb

@@ -1,21 +1,5 @@
-require 'sass/logger'
+# frozen_string_literal: true
 
-module Sass
-  module Rails
-    class Logger < Sass::Logger::Base
-      def _log(level, message)
+require "active_support/deprecation"
 
-        case level
-          when :trace, :debug
-            ::Rails.logger.debug message
-          when :warn
-            ::Rails.logger.warn message
-          when :error
-            ::Rails.logger.error message
-          when :info
-            ::Rails.logger.info message
-        end
-      end
-    end
-  end
-end
+ActiveSupport::Deprecation.warn "Sass::Rails::Logger has been removed, please stop requiring sass/rails/logger."

data/lib/sass/rails/railtie.rb

@@ -1,77 +1 @@
-require 'sprockets/railtie'
-
-module Sass::Rails
-  class Railtie < ::Rails::Railtie
-    module SassContext
-      attr_accessor :sass_config
-    end
-
-    config.sass = ActiveSupport::OrderedOptions.new
-
-    # Establish static configuration defaults
-    # Emit scss files during stylesheet generation of scaffold
-    config.sass.preferred_syntax = :scss
-    # Use expanded output instead of the sass default of :nested
-    config.sass.style            = :expanded
-    # Write sass cache files for performance
-    config.sass.cache            = true
-    # Read sass cache files for performance
-    config.sass.read_cache       = true
-    # Display line comments above each selector as a debugging aid
-    config.sass.line_comments    = true
-    # Initialize the load paths to an empty array
-    config.sass.load_paths       = []
-    # Send Sass logs to Rails.logger
-    config.sass.logger           = Sass::Rails::Logger.new
-
-    # Set the default stylesheet engine
-    # It can be overridedden by passing:
-    #     --stylesheet_engine=sass
-    # to the rails generate command
-    config.app_generators.stylesheet_engine config.sass.preferred_syntax
-
-    config.before_initialize do |app|
-      require 'sass'
-
-      if app.config.assets.enabled
-        require 'sprockets'
-        Sprockets::Engines #force autoloading
-        Sprockets.register_engine '.sass', Sass::Rails::SassTemplate
-        Sprockets.register_engine '.scss', Sass::Rails::ScssTemplate
-      end
-    end
-
-    initializer :setup_sass, :group => :all do |app|
-      # Only emit one kind of syntax because though we have registered two kinds of generators
-      syntax     = app.config.sass.preferred_syntax.to_sym
-      alt_syntax = syntax == :sass ? "scss" : "sass"
-      app.config.generators.hide_namespace alt_syntax
-
-      # Override stylesheet engine to the preferred syntax
-      config.app_generators.stylesheet_engine syntax
-
-      # Set the sass cache location
-      config.sass.cache_location   = File.join(Rails.root, "tmp/cache/sass")
-
-      # Establish configuration defaults that are evironmental in nature
-      if config.sass.full_exception.nil?
-        # Display a stack trace in the css output when in development-like environments.
-        config.sass.full_exception = app.config.consider_all_requests_local
-      end
-
-      if app.assets
-        app.assets.context_class.extend(SassContext)
-        app.assets.context_class.sass_config = app.config.sass
-      end
-
-      Sass.logger = app.config.sass.logger
-    end
-
-    initializer :setup_compression, :group => :all do |app|
-      if app.config.assets.compress
-        app.config.sass.style = :compressed
-        app.config.assets.css_compressor = CssCompressor.new
-      end
-    end
-  end
-end
+require 'sassc/rails/railtie'

data/lib/sass/rails/version.rb

@@ -1,5 +1,5 @@
 module Sass
   module Rails
-    VERSION = "3.2.3"
+    VERSION = "6.0.0"
   end
 end

data/lib/sass/rails.rb

@@ -1,16 +1 @@
-module Sass
-  autoload :Script, 'sass/rails/helpers'
-
-  module Rails
-    autoload :CssCompressor, 'sass/rails/compressor'
-    autoload :Importer,      'sass/rails/importer'
-    autoload :Logger,        'sass/rails/logger'
-    autoload :Resolver,      'sass/rails/template_handlers'
-    autoload :SassTemplate,  'sass/rails/template_handlers'
-    autoload :ScssTemplate,  'sass/rails/template_handlers'
-  end
-end
-
-require 'sass/rails/version'
-require 'sass/rails/helpers'
-require 'sass/rails/railtie'
+require 'sassc/rails'

data/lib/sass-rails.rb

@@ -1 +1 @@
-require 'sass/rails'
+require 'sassc/rails'