# sass 0.4.0

Sass-transformer for pub-serve and pub-build.





## Installing
```
export PUB_HOSTED_URL=https://pub.mirror.p-hatan.ir
flutter pub add 'sass:0.4.0'
```
Published: 2014-09-22T13:20:16.339350Z
Expected archive SHA-256: ab6e880147a4da7962d4088f4706e0819db49a5a9afcfc5ed4e72907e61a6209

Available in cache; verification: upstream_checksum
## Direct dependencies
- barback: >=0.15.0 <0.16.0
- utf: >=0.9.0 <0.9.1

## Package README (untrusted upstream documentation)
[![Build Status](https://drone.io/bitbucket.org/evidentsolutions/dart-sass/status.png)](https://drone.io/bitbucket.org/evidentsolutions/dart-sass/latest)

## Sass integration for pub

[Sass](http://sass-lang.com/)-transformer for [pub-serve](http://pub.dartlang.org/doc/pub-serve.html) and
[pub-build](http://pub.dartlang.org/doc/pub-build.html).

## Usage

Simply add the following lines to your `pubspec.yaml`:

    :::yaml
    dependencies:
      sass: any
    transformers:
      - sass

After adding the transformer your `.sass` and `.scss` files will be automatically transformed to
corresponding `.css` files.

You need to have [Sass](http://sass-lang.com/) installed and available on the path.

## Configuration

You can also pass options to Sass if necessary:

    :::yaml
    transformers:
      - sass:
          executable: /path/to/sass     # Sass executable to use
          compass: true                 # Include compass
          line-numbers: true            # Include line numbers in output
          style: compact                # Style of generated CSS
          copy-sources: true            # Copy original .scss/.sass files to output directory

## Using SassC

You can use [SassC](https://github.com/hcatlin/sassc) instead of normal Sass by specifying executable
as 'sassc' (or any path ending with 'sassc'):

    :::yaml
    transformers:
      - sass:
          executable: sassc  # or /path/to/sassc

SassC only supports `.scss`-files and does not support Compass.

## Inlined transformer

Normally the transformer simply asks Sass to process the primary input files and Sass will then
read the dependent inputs from file system. However, if the input files for Sass are themselves
produced by other transformers, they might not exist on the file system at all. The normal
transformer will not work in those cases.

To work around this problem, you can use `inlined_sass_transformer`. It will use Barback's APIs
to read and inline all imports into one big Sass file which it will then pass to Sass. 
The downside  is that line numbers on error messages and source maps might be incorrect. (See 
[Issue #4](https://bitbucket.org/evidentsolutions/dart-sass/issue/4/support-transformations-to-imported-sass) 
for details.)

To enable the use of inlined transformer, use `sass/inlined_sass_transformer` as your transformer:

    ::yaml
    transformers:
      - sass/inlined_sass_transformer
          <possible configuration settings>

## Current limitations

- UTF8-encoding is assumed for all input files.

## Changelog
# v0.4.0 (2014-09-22)

- Support for new `inlined_sass_transformer`. ([#4](https://bitbucket.org/evidentsolutions/dart-sass/issue/4/support-transformations-to-imported-sass)) (Thanks to Dan Schultz.) 
- Require Barback 0.15.x.

# v0.3.2 (2014-09-17)

- Support Barback 0.15.x. 

# v0.3.1 (2014-06-24)

- Use `sass.bat` as default executable on Windows. ([#10](https://bitbucket.org/evidentsolutions/dart-sass/issue/10/add-windows-default-executable-support)) (Thanks to Nicholas Tuck.)

# v0.3.0 (2014-05-25)

- **Breaking change:** don't copy source .scss/.sass files to build directory by default.
  Use `copy-sources: true` to keep the old behavior. ([#7](https://bitbucket.org/evidentsolutions/dart-sass/issue/7/option-to-not-copy-the-scss-source-to))
- Support imports with directory names. ([#8](https://bitbucket.org/evidentsolutions/dart-sass/issue/8/build-fails-when-import-references-a-file]))

# v0.2.2 (2014-05-23)

- Require Barback 0.13.x.
- Fixed `DeclaringTransformer` on Barback 0.13.x.  

# v0.2.1 (2014-05-15)

- Implemented `DeclaringTransformer` interface so Barback can optimize the asset graph.
- Compatibility with Barback 0.13.x.

# v0.2.0 (2014-05-15)

- Exclude URL-imports when parsing imports. (Thanks to Vikraman Choudhury.)

# v0.1.1 (2014-04-24)

- Ignore Compass imports when reading the dependencies of a module. (Thanks to Dan Schultz.)

# v0.1.0 (2014-04-19)

- Support using [SassC](https://github.com/hcatlin/sassc) instead of vanilla Sass.