|0.13.1||Jul 17, 2023|
|0.12.4||May 12, 2023|
|0.12.3||Feb 18, 2023|
|0.12.0||Dec 29, 2022|
|0.4.0||Mar 21, 2020|
#1 in #sass
12,174 downloads per month
Used in 22 crates (15 directly)
This crate aims to provide a high level interface for compiling Sass into plain CSS. It offers a very limited API, currently exposing only 2 functions.
In addition to a library, this crate also includes a binary that is intended to act as an invisible replacement to the Sass commandline executable.
This crate aims to achieve complete feature parity with the
implementation. A deviation from the
dart-sass implementation can be considered
a bug except for in the case of error messages and error spans.
grass has reached a stage where one can be quite confident in its output. For the average user there should not be perceptible differences from
Every commit of
grass is tested against bootstrap v5.0.2, and every release is tested against the last 2,500 commits of bootstrap's
That said, there are a number of known missing features and bugs. The rough edges of
grass largely include
@forward and more complex uses of
@use. We support basic usage of these rules, but more advanced features such as
@importing modules containing
@forward with prefixes may not behave as expected.
All known missing features and bugs are tracked in #19.
grass is not a drop-in replacement for
libsass and does not intend to be. If you are upgrading to
libsass, you may have to make modifications to your stylesheets, though these changes should not differ from those you would have to make if upgrading to
grass is benchmarked against
libsass) here. In general,
grass appears to be ~2x faster than
dart-sass and ~1.7x faster than
(enabled by default): build a binary using clap
(enabled by default): enable the builtin functions
In the future this feature will be removed when it is no longer necessary to rely on
(disabled by default): enable the macro
grass::include! for compiling Sass to
CSS at compile time
(disabled by default): currently only used by
grass::include! to enable
As much as possible this library attempts to follow the same philosophy for testing as
Namely, all one should have to do is run
cargo test to run all its tests.
This library maintains a test suite distinct from the
sass-spec, though it
does include some spec tests verbatim. This has the benefit of allowing tests
to be run without ruby as well as allowing the tests more granular than they
are in the official spec.
Having said that, to run the official test suite,
# This script expects node >=v14.14.0. Check version with `node --version` git clone https://github.com/connorskees/grass --recursive cd grass && cargo b --release cd sass-spec && npm install npm run sass-spec -- --impl=dart-sass --command '../target/release/grass'
The spec runner does not work on Windows.
Using a modified version of the spec runner that ignores warnings and error spans (but does include error messages),
grass achieves the following results:
2023-07-09 PASSING: 6230 FAILING: 545 TOTAL: 6905
The majority of the failing tests are purely aesthetic, relating to whitespace around comments in expanded mode or error messages.
The minimum supported rust version (MSRV) of
1.64.0. An increase to the MSRV will correspond with a minor version bump. The current MSRV is not a hard minimum, but future bugfix
grass are not guaranteed to work on versions prior to this.
grass currently targets
1.54.3. An increase to this number will correspond to either a minor or bugfix version bump, depending on the changes.