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().style(grass::OutputStyle::Compressed)
)?;
assert_eq!(css, "a b{color:a b}");
Ok(())
}
§Use as binary
cargo install grass
grass input.scss
Re-exports§
pub use codemap;
Modules§
Structs§
- Builtin
- A function implemented in rust that is accessible from within Sass
- Error
SassError
s can be either a structured error specific tograss
or anio::Error
.- NullFs
- A file system implementation that acts like it’s completely empty.
- Null
Logger - 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!
- Visitor
- Evaluation context of the current execution
Enums§
- Error
Kind - Input
Syntax - Useful when parsing Sass from sources other than the file system
- Output
Style
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
- parse_
stylesheet