compass-import-once 1.0.0

data/.gitignore

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

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec

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,30 @@
+# 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 be
+
+## Installation
+
+Or 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 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!

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/VERSION

@@ -0,0 +1 @@
+1.0.0

data/compass-import-once.gemspec

@@ -0,0 +1,23 @@
+# 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"
+  spec.version       = Compass::ImportOnce::VERSION
+  spec.authors       = ["Chris Eppstein"]
+  spec.email         = ["chris@eppsteins.net"]
+  spec.description   = %q{Changes the behavior of Sass's @import directive to only import a file once.}
+  spec.summary       = %q{Speed up your Sass compilation by making @import only import each file once.}
+  spec.homepage      = "https://github.com/chriseppstein/compass/tree/master/import-once"
+  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_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rake"
+end

data/lib/compass-import-once.rb

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

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/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_war "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,68 @@
+module Compass
+  module ImportOnce
+    # Any importer object that is extended with this module will get the import once behavior.
+    module Importer
+      DUMMY_FILENAME = "import_once_dummy_engine".freeze
+
+      def find_relative(uri, base, options)
+        uri, force_import = handle_force_import(uri)
+        maybe_replace_with_dummy_engine(super(uri, base, options), options, force_import)
+      end
+
+      def find(uri, options)
+        uri, force_import = handle_force_import(uri)
+        maybe_replace_with_dummy_engine(super(uri, options), options, force_import)
+      end
+
+      # ensure that all dummy engines share the same sass cache entry.
+      def key(uri, options)
+        if uri == DUMMY_FILENAME
+          ["(import-once)", "dummy_engine"]
+        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
+
+      def import_tracker_key(engine, options)
+        key(engine.options[:filename], options).join("|").freeze
+      end
+
+      def dummy_engine(engine, options)
+        new_options = engine.options.merge(:filename => DUMMY_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

metadata

@@ -0,0 +1,107 @@
+--- !ruby/object:Gem::Specification 
+name: compass-import-once
+version: !ruby/object:Gem::Version 
+  hash: 23
+  prerelease: 
+  segments: 
+  - 1
+  - 0
+  - 0
+  version: 1.0.0
+platform: ruby
+authors: 
+- Chris Eppstein
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2013-12-06 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: bundler
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 9
+        segments: 
+        - 1
+        - 3
+        version: "1.3"
+  type: :development
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: rake
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id002
+description: Changes the behavior of Sass's @import directive to only import a file once.
+email: 
+- chris@eppsteins.net
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- 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
+homepage: https://github.com/chriseppstein/compass/tree/master/import-once
+licenses: 
+- MIT
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.8.15
+signing_key: 
+specification_version: 3
+summary: Speed up your Sass compilation by making @import only import each file once.
+test_files: []
+
+has_rdoc: