compass-import-once-sass37 1.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: dc24e11223eeff68462a2a8250bd4cb8e05d73e95c36c675021ea55cf546bbc9
+  data.tar.gz: 131863be38a9cceebf21739c651f196d4dc097910a3613523eb7f69e05656d52
+SHA512:
+  metadata.gz: 0f09a8c39875f7003da7808d21313c1bade9ea8cb836ea3ea299f991bba6dd658039a2b3e0a3f6772b51323fff3a49b3ddc681facb1d77bb0c5c99d918d94d7f
+  data.tar.gz: 8f1f07066cdaa8fc286c3626b896d559f3c8386bd25ff7d815ea998328b669591378fb4cc9206417289ddc7e7e630274a65e89f3e277d401d7ea21df953d2fae

data/.gitignore

@@ -0,0 +1,18 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile*.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+.sass-cache

data/Gemfile

@@ -0,0 +1,5 @@
+source 'https://rubygems.org'
+
+gem 'test-unit', '~> 3.6.0'
+
+gemspec

data/Gemfile_sass_3_2

@@ -0,0 +1,5 @@
+source 'https://rubygems.org'
+
+gemspec
+
+gem 'sass', '~> 3.2.15'

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Chris Eppstein
+
+MIT License
+
+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,52 @@
+# Import Once
+
+This plugin changes the behavior of Sass's `@import` directive so that
+if the same sass file is imported more than once, the second import
+will be a no-op. This allows dependencies to behave how most people
+expect them to behave and provides a considerable performance improvement
+for some sass projects.
+
+**Note**: Although this plugin is maintained by compass, it can be used
+without compass in any Sass-based project.
+
+## Installation
+
+Either add this line to your application's Gemfile if you have one:
+
+    gem 'compass-import-once', :require => 'compass/import-once/activate'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install compass-import-once
+
+## Usage
+
+To use with the Sass command line:
+
+```
+sass -r 'compass/import-once/activate' ...
+```
+
+To enable in non-compass environments there's two options:
+
+    require 'compass/import-once/activate'
+
+or you can activate it conditionally:
+
+    require 'compass/import-once'
+    Compass::ImportOnce.activate!
+
+## Forcing an Import
+
+If a file must be imported a second time, you can force it by adding an
+exclamation mark to the end of the import url. E.g.
+
+
+```scss
+@import "something";
+@import "something!"; // this will be imported again.
+```

data/Rakefile

@@ -0,0 +1,9 @@
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+Rake::TestTask.new do |t|
+  t.libs << "test"
+  t.libs << "lib"
+  t.test_files = FileList['test/**/*_test.rb']
+  t.verbose = true
+end

data/VERSION

@@ -0,0 +1 @@
+1.1.0

data/compass-import-once.gemspec

@@ -0,0 +1,26 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'compass/import-once/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "compass-import-once-sass37"
+  spec.version       = Compass::ImportOnce::VERSION
+  spec.authors       = ["Vladimir Ivanin", "Chris Eppstein"]
+  spec.email         = ["ivaninww@gmail.com"]
+  spec.description   = %q{Changes the behavior of Sass's @import directive to only import a file once. Updated for Sass 3.7 compatibility.}
+  spec.summary       = %q{Speed up your Sass compilation by making @import only import each file once (Sass 3.7 compatible)}
+  spec.homepage      = "https://github.com/VladimirIvanin/compass"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files #{File.dirname(__FILE__)}`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "sass", ">= 3.7", "< 3.8"
+  spec.add_development_dependency "bundler", ">= 1.3"
+  spec.add_development_dependency "diff-lcs"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "sass-globbing"
+end

data/lib/compass/import-once/activate.rb

@@ -0,0 +1,20 @@
+require 'compass/import-once'
+module Sass
+  class Engine
+    def self.new(*args)
+      instance = super
+      instance.extend(Compass::ImportOnce::Engine)
+      if i = instance.options[:importer]
+        i.extend(Compass::ImportOnce::Importer) unless i.is_a?(Compass::ImportOnce::Importer)
+      end
+      instance.options[:load_paths].each do |path|
+        if path.is_a?(Sass::Importers::Base) && !path.is_a?(Compass::ImportOnce::Importer)
+          path.extend(Compass::ImportOnce::Importer)
+        elsif !path.is_a?(Sass::Importers::Base)
+          Sass::Util.sass_warn "WARNING: #{path.inspect} is on the load path and is not an importer."
+        end
+      end
+      instance
+    end
+  end
+end

data/lib/compass/import-once/engine.rb

@@ -0,0 +1,36 @@
+module Compass
+  # although this is part of the compass suite of gems, it doesn't depend on compass,
+  # so any sass-based project can use to to get import-once behavior for all of their
+  # importers.
+  module ImportOnce
+    # All sass engines will be extended with this module to manage the lifecycle
+    # around each
+    module Engine
+      def to_css
+        with_import_scope(options[:css_filename]) do
+          super
+        end
+      end
+
+      def render
+        with_import_scope(options[:css_filename]) do
+          super
+        end
+      end
+
+      def render_with_sourcemap(sourcemap_uri)
+        with_import_scope(options[:css_filename]) do
+          super
+        end
+      end
+
+      def with_import_scope(css_filename)
+        Compass::ImportOnce.import_tracker[css_filename] = Set.new
+        yield
+      ensure
+        Compass::ImportOnce.import_tracker.delete(css_filename)
+      end
+    end
+  end
+end
+

data/lib/compass/import-once/importer.rb

@@ -0,0 +1,81 @@
+module Compass
+  module ImportOnce
+    # Any importer object that is extended with this module will get the import once behavior.
+    module Importer
+      def find_relative(uri, base, options, *args)
+        uri, force_import = handle_force_import(uri)
+        maybe_replace_with_dummy_engine(super(uri, base, options, *args), options, force_import)
+      end
+
+      def find(uri, options, *args)
+        uri, force_import = handle_force_import(uri)
+        maybe_replace_with_dummy_engine(super(uri, options, *args), options, force_import)
+      end
+
+      def key(uri, options, *args)
+        if uri =~ /^\(NOT IMPORTED\) (.*)$/
+          ["(import-once)", $1]
+        else
+          super
+        end
+      end
+
+      def mtime(uri, options, *args)
+        if uri =~ /^\(NOT IMPORTED\) (.*)$/
+          File.mtime($1) if File.exist?($1)
+        else
+          super
+        end
+      end
+
+      protected
+
+      # any uri that ends with an exclamation mark will be forced to import
+      def handle_force_import(uri)
+        if uri.end_with?("!")
+          [uri[0...-1], true]
+        else
+          [uri, false]
+        end
+      end
+
+      def maybe_replace_with_dummy_engine(engine, options, force_import)
+        if engine && !force_import && imported?(engine, options)
+          engine = dummy_engine(engine, options)
+        elsif engine
+          imported!(engine, options)
+        end
+        engine
+      end
+
+      def tracker(options)
+         Compass::ImportOnce.import_tracker[options[:css_filename]] ||= Set.new
+      end
+
+      # Giant hack to support sass-globbing.
+      # Need to find a better fix.
+      def normalize_filesystem_importers(key)
+        key.map do |part|
+          part.sub(/Glob:/, 'Sass::Importers::Filesystem:')
+        end
+      end
+
+      def import_tracker_key(engine, options)
+        normalize_filesystem_importers(key(engine.options[:filename], options)).join("|").freeze
+      end
+
+      def dummy_engine(engine, options)
+        new_options = engine.options.merge(:filename => "(NOT IMPORTED) #{engine.options[:filename]}" )
+        Sass::Engine.new("", new_options)
+      end
+
+      def imported?(engine, options)
+        tracker(options).include?(import_tracker_key(engine, options))
+      end
+
+      def imported!(engine, options)
+        tracker(options) << import_tracker_key(engine, options)
+      end
+    end
+  end
+end

data/lib/compass/import-once/version.rb

@@ -0,0 +1,5 @@
+module Compass
+  module ImportOnce
+    VERSION = File.read(File.join(File.dirname(__FILE__), "..", "..", "..", "VERSION")).strip
+  end
+end

data/lib/compass/import-once.rb

@@ -0,0 +1,28 @@
+require "compass/import-once/version"
+require "compass/import-once/importer"
+require "compass/import-once/engine"
+require 'set'
+
+module Compass
+  # although this is part of the compass suite of gems, it doesn't depend on compass,
+  # so any sass-based project can use to to get import-once behavior for all of their
+  # importers.
+  module ImportOnce
+    class << self
+      # A map of css filenames to a set of engine cache keys that uniquely identify what has
+      # been imported. The lifecycle of each key is handled by code wrapped around Sass's
+      # render, to_css and render_with_sourcemap methods on the Sass::Engine.
+      #
+      # Ideally, Sass would provide a place in it's public API to put
+      # information that persists for only the duration of a single compile and would be accessible
+      # for all sass engines and sass functions written in ruby.
+      def import_tracker
+        Thread.current[:import_once_tracker] ||= {}
+      end
+
+      def activate!
+        require 'compass/import-once/activate'
+      end
+    end
+  end
+end

data/lib/compass-import-once.rb

@@ -0,0 +1 @@
+require 'compass/import-once'

data/test/diff_as_string.rb

@@ -0,0 +1,48 @@
+require 'diff/lcs'
+require 'diff/lcs/hunk'
+
+module DiffAsString
+  #stole this from rspec who stole this from the gem
+  def diff_as_string(data_old, data_new)
+    data_old = data_old.split(/\n/).map! { |e| e.chomp }
+    data_new = data_new.split(/\n/).map! { |e| e.chomp }
+    output = ""
+    diffs = ::Diff::LCS.diff(data_old, data_new)
+    return output if diffs.empty?
+    oldhunk = hunk = nil  
+    file_length_difference = 0
+    diffs.each do |piece|
+      begin
+        hunk = ::Diff::LCS::Hunk.new(
+          data_old, data_new, piece, context_lines, file_length_difference
+        )
+        file_length_difference = hunk.file_length_difference      
+        next unless oldhunk      
+        # Hunks may overlap, which is why we need to be careful when our
+        # diff includes lines of context. Otherwise, we might print
+        # redundant lines.
+        if (context_lines > 0) and hunk.overlaps?(oldhunk)
+          hunk.unshift(oldhunk)
+        else
+          output << oldhunk.diff(format)
+        end
+      ensure
+        oldhunk = hunk
+        output << "\n"
+      end
+    end  
+    #Handle the last remaining hunk
+    output << oldhunk.diff(format) << "\n"
+  end
+
+  protected
+
+  def format
+    :unified
+  end
+
+  def context_lines
+    3
+  end
+
+end

data/test/fixtures/_simple_partial.scss

@@ -0,0 +1,5 @@
+$simple-imported: 0 !default;
+$simple-imported: $simple-imported + 1;
+.simple {
+  times-imported: $simple-imported;
+}

data/test/fixtures/basic.css

@@ -0,0 +1,3 @@
+.simple {
+  times-imported: 1;
+}

data/test/fixtures/basic.scss

@@ -0,0 +1,2 @@
+@import "simple_partial";
+@import "simple_partial";

data/test/fixtures/force_import.css

@@ -0,0 +1,7 @@
+.simple {
+  times-imported: 1;
+}
+
+.simple {
+  times-imported: 2;
+}

data/test/fixtures/force_import.scss

@@ -0,0 +1,2 @@
+@import "simple_partial";
+@import "simple_partial!";

data/test/fixtures/with_globbing.css

@@ -0,0 +1,3 @@
+.simple {
+  times-imported: 1;
+}

data/test/fixtures/with_globbing.scss

@@ -0,0 +1,2 @@
+@import "*_partial*";
+@import "simple_partial";

data/test/import_once_test.rb

@@ -0,0 +1,54 @@
+#!/usr/bin/env ruby
+require 'test_helper'
+require 'fileutils'
+
+# These are useful in debugging.
+module Sass::Script::Functions
+  def filename
+    if @options[:filename]
+      Sass::Script::String.new(@options[:filename], true)
+    else
+      Sass::Script::Null.new
+    end
+  end
+  def importer
+    if @options[:importer]
+      Sass::Script::String.new(@options[:importer].inspect, true)
+    else
+      Sass::Script::Null.new
+    end
+  end
+  def importer_is_import_onced
+    Sass::Script::Bool.new(@options[:importer].is_a?(Compass::ImportOnce::Importer))
+  end
+end
+
+class ImportOnceTest < Test::Unit::TestCase
+  FIXTURES_DIR = File.join(File.expand_path(File.dirname(__FILE__)), "fixtures")
+  Dir.glob(File.join(FIXTURES_DIR, "**", "*.scss")).each do |scss_file|
+    if ENV["FIXTURE"]
+      next unless File.expand_path(ENV["FIXTURE"]) == scss_file
+    end
+    dir = File.dirname(scss_file)
+    basename = File.basename(scss_file, ".scss")
+    next if basename.start_with?("_")
+    define_method "test_#{basename}" do
+      assert_compilation_result(
+        File.join(dir, "#{basename}.scss"),
+        File.join(dir, "#{basename}.css"))
+    end
+  end
+
+  protected
+
+  def assert_compilation_result(sass_file, css_file, options = {})
+    options[:style] ||= :expanded
+    actual_result = Sass.compile_file(sass_file, options)
+    expected_result = File.read(css_file)
+    assert expected_result == actual_result, diff_as_string(expected_result, actual_result)
+    FileUtils.rm_f("#{css_file}.error") # cleanup from old tests now that it's passing
+  rescue Exception => e
+    open("#{css_file}.error", "w") {|f| f.write(actual_result) }
+    raise
+  end
+end

data/test/test_helper.rb

@@ -0,0 +1,9 @@
+require 'sass'
+require 'compass/import-once/activate'
+require 'sass-globbing'
+require 'test/unit'
+require 'diff_as_string'
+
+class Test::Unit::TestCase
+  include DiffAsString
+end

metadata

@@ -0,0 +1,156 @@
+--- !ruby/object:Gem::Specification
+name: compass-import-once-sass37
+version: !ruby/object:Gem::Version
+  version: 1.1.0
+platform: ruby
+authors:
+- Vladimir Ivanin
+- Chris Eppstein
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2025-10-13 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: sass
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.7'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3.8'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.7'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3.8'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: diff-lcs
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: sass-globbing
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Changes the behavior of Sass's @import directive to only import a file
+  once. Updated for Sass 3.7 compatibility.
+email:
+- ivaninww@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- Gemfile_sass_3_2
+- LICENSE.txt
+- README.md
+- Rakefile
+- VERSION
+- compass-import-once.gemspec
+- lib/compass-import-once.rb
+- lib/compass/import-once.rb
+- lib/compass/import-once/activate.rb
+- lib/compass/import-once/engine.rb
+- lib/compass/import-once/importer.rb
+- lib/compass/import-once/version.rb
+- test/diff_as_string.rb
+- test/fixtures/_simple_partial.scss
+- test/fixtures/basic.css
+- test/fixtures/basic.scss
+- test/fixtures/force_import.css
+- test/fixtures/force_import.scss
+- test/fixtures/with_globbing.css
+- test/fixtures/with_globbing.scss
+- test/import_once_test.rb
+- test/test_helper.rb
+homepage: https://github.com/VladimirIvanin/compass
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.3.7
+signing_key: 
+specification_version: 4
+summary: Speed up your Sass compilation by making @import only import each file once
+  (Sass 3.7 compatible)
+test_files:
+- test/diff_as_string.rb
+- test/fixtures/_simple_partial.scss
+- test/fixtures/basic.css
+- test/fixtures/basic.scss
+- test/fixtures/force_import.css
+- test/fixtures/force_import.scss
+- test/fixtures/with_globbing.css
+- test/fixtures/with_globbing.scss
+- test/import_once_test.rb
+- test/test_helper.rb