https://github.com/kaj/rsass

Sass reimplemented in rust with nom.
https://github.com/kaj/rsass

css rust sass sass-language sass-reimplemented scss web

Last synced: 1 day ago
JSON representation

Sass reimplemented in rust with nom.

• Host: GitHub
• URL: https://github.com/kaj/rsass
• Owner: kaj
• License: other
• Created: 2016-12-22T00:03:30.000Z (almost 8 years ago)
• Default Branch: main
• Last Pushed: 2024-09-17T17:32:20.000Z (about 2 months ago)
• Last Synced: 2024-09-18T02:25:01.381Z (about 2 months ago)
• Topics: css, rust, sass, sass-language, sass-reimplemented, scss, web
• Language: Rust
• Homepage: https://crates.io/crates/rsass
• Size: 6.84 MB
• Stars: 458
• Watchers: 12
• Forks: 27
• Open Issues: 13
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# rsass

Sass reimplemented in rust with nom.

The "r" in the name might stand for the Rust programming language, for

"re-implemented", or possibly for my name Rasmus.

[![Crate](https://img.shields.io/crates/v/rsass.svg)](https://crates.io/crates/rsass)

[![docs](https://docs.rs/rsass/badge.svg)](https://docs.rs/rsass)

[![Github build](https://github.com/kaj/rsass/workflows/CI/badge.svg)](https://github.com/kaj/rsass/actions)

## Commandline and library

To make compiling faster when rsass is used as a library crate (which

is probably the dominant use-case), I have made the commandline

interface a separate crate.

When building the monorepo, both the library and the cli are built by

default.

To install the cli, use:

    cargo install rsass-cli

To use the rust library, add `rsass` to your dependencies.

    cargo add rsass

## Sass language and implementation status

The sass language [is defined in its reference

doc](http://sass-lang.com/documentation/).

This implementation is incomplete but getting there, if slowly.

Progress: 5803 of 7673 tests passed.

If you need _complete_ sass support, you'll need

[dart sass](https://sass-lang.com/dart-sass).

Another alternative is [grass](https://crates.io/crates/grass)

which is another incomplete pure rust implementation.

That said, this implementation has reached a version where I find it

usable for my personal projects, and the number of working tests are

improving.

## Contributing

Welcome!

The first step in any contribution is probably to either try to use

the crate or to read some of the documentation.

When you do, you might find something broken, not yet implemented, or

just plain incomprehensible.

If so, please

[see if there is an issue](https://github.com/kaj/rsass/issues)

matching the problem or file a new one.

If you contribute code through a pull request, github will

automatically check that the code compiles and passes its tests with

all required versions of rust, and that the code is properly formatted

according to rustfmt.

Hopefully, I will then review the code, and either ask you for changes

or merge it.

This is a hobby project, so please excuse if the review is delayed.

I, the rsass maintainer, will do my best to follow both the

[Sass Community Guidelines](https://sass-lang.com/community-guidelines)

and the

[Rust Code of Conduct](https://www.rust-lang.org/policies/code-of-conduct),

and I ask you to do the same.