danog/dart-sass
1
0
Fork 0
mirror of https://github.com/danog/dart-sass.git synced 2024-11-30 04:39:03 +01:00
Code Issues Packages Projects Releases Wiki Activity
309 Commits 1 Branch 6 Tags 6.7 MiB
Dart 100%
8136c16cab
Go to file
Natalie Weizenbaum 8136c16cab A few more API docs.
2016-10-11 00:27:19 -07:00
benchmark/source Re-run benchmarks. 2016-09-30 16:26:02 -07:00
bin Even more API docs. 2016-10-09 20:57:28 -07:00
lib/src A few more API docs. 2016-10-11 00:27:19 -07:00
tool Print the version number. 2016-10-07 15:46:58 -07:00
.analysis_options I guess we're strong-mode clean too. 2016-08-30 15:51:15 -07:00
.gitignore Template files. 2016-08-30 15:51:06 -07:00
.test_config Template files. 2016-08-30 15:51:06 -07:00
AUTHORS Template files. 2016-08-30 15:51:06 -07:00
CHANGELOG.md Template files. 2016-08-30 15:51:06 -07:00
codereview.settings Template files. 2016-08-30 15:51:06 -07:00
CONTRIBUTING.md Template files. 2016-08-30 15:51:06 -07:00
differences.md Move behavior differences into the README. 2016-10-07 15:29:42 -07:00
LICENSE Template files. 2016-08-30 15:51:06 -07:00
perf.md Add Node to perf numbers. 2016-10-07 15:22:11 -07:00
pubspec.yaml Print the version number. 2016-10-07 15:46:58 -07:00
README.md Move behavior differences into the README. 2016-10-07 15:29:42 -07:00

README.md

A Dart implementation of Sass.

Using Dart Sass

Dart Sass isn't ready for distribution yet, but it's possible to test it out by running from source. This assumes you've already checked out this repository.

  1. Install Dart. If you download it manually, make sure the SDK's bin directory is on your PATH.

  2. In this repository, run pub get. This will install Dart Sass's dependencies.

  3. Run dart bin/sass.dart path/to/file.scss.

That's it!

Goals

Dart Sass is intended to eventually replace Ruby Sass as the canonical implementation of the Sass language. It has a number of advantages:

  • It's fast. The Dart VM is highly optimized, and getting faster all the time (for the latest performance numbers, see perf.md). It's much faster than Ruby, and not too far away from C.

  • It's portable. The Dart VM has no external dependencies and can compile applications into standalone snapshot files, so a fully-functional Dart Sass could be distributed as only three files (the VM, the snapshot, and a wrapper script). Dart can also be compiled to JavaScript, which would make it easy to distribute Sass through NPM or other JS package managers.

  • It's friendlier to contributors. Dart is substantially easier to learn than Ruby, and many Sass users in Google in particular are already familiar with it. More contributors translates to faster, more consistent development.

Behavioral Differences

There are a few intentional behavioral differences between Dart Sass and Ruby Sass. These are generally places where Ruby Sass has an undesired behavior, and it's substantially easier to implement the correct behavior than it would be to implement compatible behavior. These should all have tracking bugs against Ruby Sass to update the reference behavior.

  1. @extend only accepts simple selectors, as does the second argument of selector-extend(). See issue 1599.

  2. Subject selectors are not supported. See issue 1126.

  3. Pseudo selector arguments are parsed as <declaration-value>s rather than having a more limited custom parsing. See issue 2120.

  4. The numeric precision is set to 10. See issue 1122.

  5. The indented syntax parser is more flexible: it doesn't require consistent indentation across the whole document. This doesn't have an issue yet; I need to talk to Chris to determine if it's actually the right way forward.

  6. Colors do not support channel-by-channel arithmetic. See issue 2144.

Disclaimer: this is not an official Google product.