# Sass Archive Importer Plugin

The Sass Archive Importer allows you to import CSS, Sass, and SCSS files
from a zip or jar file without unpacking it.

## Stylesheet Syntax

This importer works with the standard filesystem based import syntax,
allowing you to import from a folder or archive file with the same code.
This allows you to develop against an unpacked version of a library but
also compile the stylesheets against a pre-built archive file (for example,
during a build process).

## Installation

    $ gem install --pre sass-archive-importer

## Use with the Sass command line

    $ sass -r sass-archive-importer -I path/to/archive.zip --watch sass_dir:css_dir

Note: several `-r` options can be given to the sass command line if you
need to require several libraries. Several `-I` options can be passed if
you need to import more than one zip or jar file.

## Use with Compass

Add the following to your compass configuration:

    require 'sass-archive-importer'
    # Note: you can call add_import_path more than once.
    add_import_path File.expand_path("path/to/archive.zip", File.dirname(__FILE__))
    add_import_path File.expand_path("path/to/archive.jar", File.dirname(__FILE__))

# Legal Stuff

Copyright 2013 LinkedIn Corp. All rights reserved.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.