sass-import_once 0.1.0

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    ZTEyNDNkMmE1YTQwN2QwMzk5MWViYTRhMjhmMDYxMDBlYzQ2YjY2NA==
+  data.tar.gz: !binary |-
+    YjhjMjc0NGRkNjJhMzY3M2JkNzgzMWJiMjY1YTRkMGYwYTNiMjI0Yw==
+SHA512:
+  metadata.gz: !binary |-
+    ZTliNDgwNWM1YWU2Yzk1NjIxM2NiOWRkOTM4ZDM4M2VkNTM2NjdjODBiMGRh
+    YTQ2MjUwYzY1YWQwOTFkM2ZkMmVlZDVmNTBhNTE5Mzc1NWZiZjQ5MDYxYjM2
+    YWQ4YzlmN2E4MDJjNGIyMzVjNmNhYjVkYjc5M2QyNGJmNTAxMTk=
+  data.tar.gz: !binary |-
+    YjMzMGY4MDA1ZjdmMTAyM2VkMzU4NWY3ZmNjMGEyMmJhMGQwM2QwMzMwNWM3
+    OWMyZjY3OGNjMzViYmQ3OWFhZjY0NDM5YTE2MTJkNmI2ZTAwMzBiYTNhNzdm
+    YWEyNDI3NThiNmE0ZDVmN2FlNjI4MmNiN2U4ZGJhOWQ1N2U3NmM=

data/.gitignore

@@ -0,0 +1,5 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*
+.DS_Store

data/CHANGELOG.markdown

@@ -0,0 +1,3 @@
+# 0.1.0
+
+Initial release.

data/Gemfile

@@ -0,0 +1,7 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in sass-import_once.gemspec
+gemspec
+
+gem 'rake'
+gem 'sass'

data/README.markdown

@@ -0,0 +1,22 @@
+# Sass Import Once Plugin
+
+Sass import_once changes the behaviour of the sass @import directive making never require the same file twice.
+
+## Installation
+
+    $ gem install sass-import_once
+
+## Use with the Sass command line
+
+    $ sass -r sass-import_once --watch sass_dir:css_dir
+
+## Use with compass
+
+Add the following to your compass configuration:
+
+    $ gem install 'compass-import_once'
+    require 'compass-import_once'
+
+## Stylesheet Syntax
+
+The same as always :)

data/Rakefile

@@ -0,0 +1,11 @@
+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

data/lib/sass-import_once.rb

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

data/lib/sass/import_once.rb

@@ -0,0 +1,7 @@
+module Sass
+  module ImportOnce
+  end
+end
+
+require 'sass/import_once/importer';
+require 'sass/import_once/monkey_patches';

data/lib/sass/import_once/importer.rb

@@ -0,0 +1,141 @@
+class Sass::ImportOnce::Importer < ::Sass::Importers::Filesystem
+    
+    attr_accessor :root, :staleness_check, :imported, :original_filename
+
+    @@DEBUG = false
+
+    # Creates a new filesystem importer that imports files relative to a given path.
+    #
+    # @param root [String] The root path.
+    #   This importer will import files relative to this path.
+    def initialize(root)
+        @imported = []
+        super(root)
+    end
+
+    # Same as Sass
+    COLORS = { :red => 31, :green => 32, :yellow => 33 }
+
+    def color(color, str)
+        raise "[BUG] Unrecognized color #{color}" unless COLORS[color]
+
+        # Almost any real Unix terminal will support color,
+        # so we just filter for Windows terms (which don't set TERM)
+        # and not-real terminals, which aren't ttys.
+        return str if ENV["TERM"].nil? || ENV["TERM"].empty? || !STDOUT.tty?
+        return "\e[#{COLORS[color]}m#{str}\e[0m"
+    end
+    
+    def self.DEBUG=(value)
+        @@DEBUG = value
+    end
+
+    def debug(text, level = 1)
+        if @@DEBUG
+            puts "__ DEBUG: " + text.to_s
+        end
+    end
+
+    def update_imported_list(options)
+        @original_filename ||= options[:original_filename]
+        
+        if @original_filename != options[:original_filename]
+            @imported = []
+            @original_filename = options[:original_filename]
+        end
+    end
+
+    def staleness_check?(options)
+        # as per sass/importers/filesystem.rb : 135, 148
+        # quote: "If options[:_line] exists, we're here due to an actual import in an import_node
+        #         Otherwise, we're here via StalenessChecker."
+        # But it's not true, place two @import's to file A inside a file B and both will have _line set.
+        # So, unfortunately, for now, we'll have to check the stack
+        
+        Kernel.caller.each {|call|
+            return true if call.include? "staleness_checker"
+        }
+
+        return false
+    end
+
+    # @see Base#find_relative
+    def find_relative(name, base, options)
+        update_imported_list options
+        debug color(:yellow, "    finding relative ") + color(:green, name)
+        just_checking = staleness_check? options
+
+        # get the real file
+        real_file, syntax = Sass::Util.destructure(find_real_file(File.dirname(base), name, options))
+        
+        if !real_file
+            raise color(:red, "Could not find a RELATIVE file '#{name}'. Imported at #{options[:original_filename]}:#{options[:_line]}")
+            return nil
+        end
+
+        unless just_checking
+
+            if @imported.include? real_file
+                debug color(:red, "        already included")
+
+                return empty(options)
+            end
+
+        else
+            debug "        Just checking"
+        end
+        
+        f = _find(File.dirname(base), name, options)
+
+        if f
+            debug color(:yellow, "        imported: ") + color(:green, real_file) unless just_checking
+            @imported << real_file unless just_checking
+        end
+
+        return f
+    end
+
+    # @see Base#find
+    def find(name, options)
+        debug color(:red, "find called")
+        update_imported_list options
+        debug "finding absolute " + color(:green, name)
+        just_checking = staleness_check? options
+
+        # get the real file
+        real_file, syntax = Sass::Util.destructure(find_real_file(@root, name, options))
+
+        if !real_file
+            raise color(:red, "Could not find file '#{name}'. Imported at #{options[:original_filename]}:#{options[:_line]}")
+            return nil
+        end
+        
+        unless just_checking
+
+            if @imported.include? real_file
+                debug color(:red, "already included")
+                return empty(options)
+            end
+
+        else
+            debug "Just checking", 2
+        end
+
+        f = _find(@root, name, options)
+        
+        if f
+            debug "    imported: " + color(:green, real_file) unless just_checking
+            @imported << real_file unless just_checking
+        else
+            debug color(:red, "NOT FOUND!")
+        end
+
+        return f
+    end
+
+    protected
+
+    def empty(options)
+        return Sass::Engine.new("", options)
+    end
+end

data/lib/sass/import_once/monkey_patches.rb

@@ -0,0 +1,11 @@
+require 'sass/exec'
+
+class Sass::Engine
+  alias old_initialize initialize
+  
+  def initialize(template, options={})
+    options[:filesystem_importer] = Sass::ImportOnce::Importer
+
+    old_initialize(template, options)
+  end
+end

data/lib/sass/import_once/version.rb

@@ -0,0 +1,5 @@
+module Sass
+  module ImportOnce
+    VERSION = "0.1.0"
+  end
+end

data/sass-import_once.gemspec

@@ -0,0 +1,30 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path("../lib/sass/import_once/version", __FILE__)
+
+Gem::Specification.new do |s|
+  s.name        = "sass-import_once"
+  s.version     = Sass::ImportOnce::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["The Blacksmith (a.k.a. Saulo Vallory)"]
+  s.email       = ["me@saulovallory.com"]
+  s.homepage    = "http://theblacksmithhq.com/"
+  s.summary     = %q{Makes Sass @import directives only import a file once.}
+  s.description = %q{
+    Sass ImportOnce Importer
+
+    This gem will MODIFY the default behaviour of Sass.
+
+    Sass @import directive imports the file requested everytime it's called
+    this has been default behaviour, as far as I know, from the beginning of
+    Sass's life. But sometimes, or most of the time, this behaviour isn't 
+    desireable. When working with modularized sass styles and sass frameworks
+    out there we usually want a file to be imported only once.
+  }
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- test/*`.split("\n")
+  s.require_paths = ["lib"]
+
+  s.add_runtime_dependency 'sass', '>= 3.1'
+
+end

data/test/fixtures/partials/_imported.scss

@@ -0,0 +1,3 @@
+ #i.was.imported {
+ 	color: red;
+ }

data/test/fixtures/test.scss

@@ -0,0 +1,13 @@
+// Let's import a file
+@import "partials/imported";
+
+// add some rules
+$blue: #3bbfce;
+
+div.bleue {
+	background-color: $blue;
+}
+
+// And import the same file again
+// even if we change the way we reference the file, it shouldn't be imported
+@import "partials/imported.scss";

data/test/sass_import_once_test.rb

@@ -0,0 +1,25 @@
+require 'test/unit'
+require 'sass'
+require 'sass-import_once'
+
+class SassImportOnceTest < Test::Unit::TestCase
+
+  def test_will_import_file_once
+    css = render_file("test.scss")
+    assert_equal 1, css.scan(/#i\.was\.imported/).count
+  end
+
+private
+  def render_file(filename)
+    fixtures_dir = File.expand_path("fixtures", File.dirname(__FILE__))
+    full_filename = File.expand_path(filename, fixtures_dir)
+    syntax = File.extname(full_filename)[1..-1].to_sym
+    engine = Sass::Engine.new(File.read(full_filename),
+                              :syntax => syntax,
+                              :filename => full_filename,
+                              :cache => false,
+                              :read_cache => false,
+                              :load_paths => [fixtures_dir])
+    engine.render
+  end
+end

metadata

@@ -0,0 +1,79 @@
+--- !ruby/object:Gem::Specification
+name: sass-import_once
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- The Blacksmith (a.k.a. Saulo Vallory)
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-10-31 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: sass
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '3.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '3.1'
+description: ! "\n    Sass ImportOnce Importer\n\n    This gem will MODIFY the default
+  behaviour of Sass.\n\n    Sass @import directive imports the file requested everytime
+  it's called\n    this has been default behaviour, as far as I know, from the beginning
+  of\n    Sass's life. But sometimes, or most of the time, this behaviour isn't \n
+  \   desireable. When working with modularized sass styles and sass frameworks\n
+  \   out there we usually want a file to be imported only once.\n  "
+email:
+- me@saulovallory.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- CHANGELOG.markdown
+- Gemfile
+- README.markdown
+- Rakefile
+- lib/sass-import_once.rb
+- lib/sass/import_once.rb
+- lib/sass/import_once/importer.rb
+- lib/sass/import_once/monkey_patches.rb
+- lib/sass/import_once/version.rb
+- sass-import_once.gemspec
+- test/fixtures/partials/_imported.scss
+- test/fixtures/test.scss
+- test/sass_import_once_test.rb
+homepage: http://theblacksmithhq.com/
+licenses: []
+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: []
+rubyforge_project: 
+rubygems_version: 2.1.10
+signing_key: 
+specification_version: 4
+summary: Makes Sass @import directives only import a file once.
+test_files:
+- test/fixtures/partials/_imported.scss
+- test/fixtures/test.scss
+- test/sass_import_once_test.rb