Crate grass

source ·
Expand description

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.
  • Options
    Configuration for Sass compilation
  • StdFs
    Use std::fs to read any files from disk.

Enums§

Traits§

  • Fs
    A trait to allow replacing the file system lookup mechanisms.

Functions§

Type Aliases§