Citizen17.DartSass 1.1.0

Citizen17.DartSass

Library for compiling SASS using Dart Sass runtime.

Install

Install package using NuGet.

Runtime

By default package doesn't contain Dart Sass runtime. It can use installed in system Dart Sass or you can one of packages with runtime:

• DartSass.Native.win-x64
• DartSass.Native.win-x86
• DartSass.Native.linux-x64
• DartSass.Native.linux-arm64
• DartSass.Native.linux-x86
• DartSass.Native.macos-x64
• DartSass.Native.macos-arm64

Usage

Create DartSassCompiller instance.

using Citizen17.DartSass;

var compiler = new DartSassCompiller();

When instance creates it try find Dart Sass runtime. First it search in project. If not found it try search in system using environmen variable PATH.

If you have dedicated Dart Sass runtime you can pass it as parameter to constructor.

var compiler = new DartSassCompiller("/path/to/sass/executable");

Options

You can set default options that will be used on evert compile.

compiler.CompileOptions = new SassCompileOptions
{
    StyleType = StyleType.Expanded,
    EmitCharset = true,
    Update = false,
    ImportPaths = new List<string>
    {
        "/path/to/imports1",
        "/path/to/imports2"
    },

    GenerateSourceMap = true,
    SourceMapUrlType = SourceMapUrlType.Relative,
    EmbedSources = false,
    EmbedSourceMap = false,

};

Also every compile method can accept options. If options passed they override defaults.

Compile from file

Use CompileAsync method to get compiled code from file source.

var compiledCss = await compiler.CompileAsync("/path/to/source.scss");

Compile from code

Use CompileCodeAsync method to get compiled code from string source.

var sourceSassCode = ".some-class { color: red; }";
var compiledCss = await compiler.CompileCodeAsync(sourceSassCode);

Compile from file to file

Use CompileToFileAsync method to compile source SASS file to CSS.

var listOfProducedFiles = await compiler.CompileToFileAsync("/path/to/source/source.scss");

Result file: /path/to/source/source.css and /path/to/source/source.css.map if Source maps enabled.

Also you can pass custom name for output file.

var listOfProducedFiles = await compiler.CompileToFileAsync("/path/to/source/source.scss", "dest.css");

Result file: /path/to/source/dest.css and /path/to/source/dest.css.map if Source maps enabled.

var listOfProducedFiles = await compiler.CompileToFileAsync("/path/to/source/source.scss", "/path/to/dest/dest.css");

Result file: /path/to/dest/dest.css and /path/to/dest/dest.css.map if Source maps enabled.

Compile multiple files

Use CompileToFilesAsync method to compile multiple files. It has 2 overload.

First accept list of strings with source files.

var sourceFiles = new string[]
{
    "path/to/source1.sass",
    "path/to/source2.sass"
};

var listOfProducedFiles = await compiler.CompileToFilesAsync(sourceFiles);

All output files will be placed near it source file. Or you can pass additional parameter to specify output directory.

var listOfProducedFiles = await compiler.CompileToFilesAsync(sourceFiles, "/path/to/dest");

Second accept dictionary where key is source file and value is output file.

var sourceFiles = new Dictionaty<string, string>
{
    { "path/to/source.sass", "dest.css" }, // Will be placed near source file
    { "path/to/source2.sass", "path/to/dest2.css" },
    { "path/to/source3.sass", null } // Will be generated source3.css file and placed near source file
    { "path/to/source4.sass", "path/to/dest/" } // Will be generated source4.css file and placed in path/to/dest/
}

var listOfProducedFiles = await compiler.CompileToFilesAsync(sourceFiles);

Also you can pass as second parameter output directory and all files without reletive or ablsolute path will be placed in that directory

Version

Also you can get version of used Dart Sass runtime.

var version = await compiler.GetVersionAsync();