Crate grass

This crate provides functionality for compiling Sass to CSS.

This crate targets compatibility with the reference implementation in Dart. If upgrading from the now deprecated libsass, one may have to modify their stylesheets. These changes will not differ from those necessary to upgrade to dart-sass, and in general such changes should be quite rare.

This crate is capable of compiling Bootstrap 4 and 5, bulma and bulma-scss, Bourbon, as well as most other large Sass libraries with complete accuracy. For the vast majority of use cases there should be no perceptible differences from the reference implementation.

Use as library

fn main() -> Result<(), Box<grass::Error>> {
    let css = grass::from_string(
        "a { b { color: &; } }".to_owned(),
        &grass::Options::default()
    )?;
    assert_eq!(css, "a b {\n  color: a b;\n}\n");
    Ok(())
}

Use as binary

cargo install grass
grass input.scss

Macros

includemacro

Include CSS in your binary at compile time from a Sass source file

Structs

Error

SassErrors can be either a structured error specific to grass or an io::Error.

NullFs

A file system implementation that acts like it’s completely empty.

NullLogger

Discards all logs

Options

Configuration for Sass compilation

StdFs

Use std::fs to read any files from disk.

StdLogger

Logs events to standard error, through eprintln!

Enums

ErrorKind

InputSyntax

Useful when parsing Sass from sources other than the file system

OutputStyle

Traits

Fs

A trait to allow replacing the file system lookup mechanisms.

Logger

A trait to allow replacing logging mechanisms

Functions

from_path

Compile CSS from a path

from_string

Compile CSS from a string

Type Aliases

Result