#2035 Compare This branch is 31 commits ahead, 10 commits behind stable.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
..
Failed to load latest commit information.
lib
test
.gitignore
Gemfile
Gemfile_sass_3_2
LICENSE.txt
README.md
Rakefile
VERSION
compass-import-once.gemspec

README.md

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.

@import "something";
@import "something!"; // this will be imported again.