Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/c9s/c6
Compile SASS Faster ! C6 is a SASS-compatible compiler
https://github.com/c9s/c6
Last synced: about 2 months ago
JSON representation
Compile SASS Faster ! C6 is a SASS-compatible compiler
- Host: GitHub
- URL: https://github.com/c9s/c6
- Owner: c9s
- License: other
- Created: 2015-04-28T16:22:44.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2017-08-07T00:08:16.000Z (about 7 years ago)
- Last Synced: 2024-05-21T19:15:22.886Z (4 months ago)
- Language: Go
- Homepage:
- Size: 890 KB
- Stars: 431
- Watchers: 18
- Forks: 35
- Open Issues: 47
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-tw-foss - C6 - Compile SASS Faster ! C6 is a SASS-compatible compiler written in Go. (Lib/Framework/API/Dev Tool)
README
C6
===========================
Hate waiting for SASS compiling your stylesheets with Compass over 10 seconds
everytime? C6 helps you write style sheets with efficiency.
C6 is a SASS 3.2 compatible implementation written in Go. But wait! this is not
only to implement SASS, but also to create a new language for better
consistency, syntax and performance. And yes, this means we're free to accept
new language feature requests.
[](https://travis-ci.org/c9s/c6)
[](https://coveralls.io/r/c9s/c6)
[](https://godoc.org/github.com/c9s/c6)
[](https://app.wercker.com/project/bykey/13aa03443c40dedeeabda923e1a95180)
## Installation
```
go get github.com/c9s/c6/cmd/c6
```
## Working in progress
- [ ] Lexing
- [x] `@import`
- [x] simple selector.
- [x] type selector.
- [x] child selector.
- [x] attribute selector.
- [x] adjacent selector.
- [x] descendant selector.
- [x] class selector.
- [x] ID selector.
- [x] Ruleset
- [x] Sub-ruleset
- [x] Interpolation
- [x] Property name
- [x] Property value list
- [x] Nested properties.
- [x] Comma-separated list
- [x] Space-separated list
- [x] `@if` , `@else` , `@else if`
- [x] `@for`, `from`, `through` statement
- [x] `@while`
- [x] `@mixin`
- [x] `@mixin` with arguments
- [x] `@include`
- [x] Flags: `!default`, `!important`, `!optional`, `!global`
- [x] Hex color
- [x] Functions
- [x] Vendor prefix properties
- [x] MS filter. `progid:DXImageTransform.Microsoft....`
- [x] Variable names
- [x] Variable assignment
- [x] Time unit support. `s` second, `ms` ... etc
- [x] Angle unit support.
- [x] Resolution unit support.
- [x] Unicode Range support:
- [x] Media Query
- [ ] Built-in Functions
- .... to be listed
- [ ] Parser
- [x] Parse `@import`
- [x] Parse Expr
- [x] Parse Space-Sep List
- [x] Parse Comma-Sep List
- [x] Parse Map (tests required)
- [x] Parse Selector
- [ ] Parse Selector with interpolation
- [x] Parse RuleSet
- [x] Parse DeclBlock
- [x] Parse Variable Assignment Stmt
- [x] Parse PropertyName
- [x] Parse PropertyName with interpolation
- [x] Parse PropertyValue
- [x] Parse PropertyValue with interpolation
- [x] Parse conditions
- [x] Parse `@media` statement
- [x] Parse Nested RuleSet
- [x] Parse Nested Properties
- [x] Parse options: `!default`, `!global`, `!optional`
- [ ] Parse CSS Hack for different browser (support more syntax sugar for this)
- [x] Parse `@font-face` block
- [x] Parse `@if` statement
- [x] Parse `@for` statement
- [x] Parse `@while` statement
- [x] Parse `@mixin` statement
- [x] Parse `@include` statement
- [x] Parse `@function` statement
- [x] Parse `@return` statement
- [x] Parse `@extend` statement
- [x] Parse keyword arguments for `@function`
- [ ] Parse `@switch` statement
- [ ] Parse `@case` statement
- [ ] Parse `@use` statement
- [ ] Building AST
- [x] RuleSet
- [x] DeclBlock
- [x] PropertyName
- [x] PropertyValue
- [x] Comma-Separated List
- [x] Space-Separated List
- [x] Basic Exprs
- [x] FunctionCall
- [x] Expr with interpolation
- [x] Variable statements
- [x] Built-in color keyword table
- [x] Hex Color computation
- [x] Number operation: add, sub, mul, div
- [x] Length operation: number operation for px, pt, em, rem, cm ...etc
- [x] Expr evaluation
- [x] Boolean expression evaluation
- [x] Media Query conditions
- [x] `@if` If Condition
- [x] `@else if` If Else If
- [x] `@else` else condition
- [x] `@while` statement node
- [x] `@function` statement node
- [x] `@mixin` statement node
- [x] `@include` statement node
- [x] `@return` statement node
- [ ] `@each` statement node
- [ ] Runtime
- [ ] HSL Color computation
- [ ] Function Call Invoke mech
- [ ] Mixin Include
- [ ] Import
- [ ] SASS Built-in Functions
- [ ] RGB functions
- [ ] `rgb($red, $green, $blue)`
- [ ] `rgba($red, $green, $blue, $alpha)`
- [ ] `red($color)`
- [ ] `green($color)`
- [ ] `blue($color)`
- [ ] `mix($color1, $color2, [$weight])`
- [ ] HSL Functions
- [ ] `hsl($hue, $saturation, $lightness)`
- [ ] `hsla($hue, $saturation, $lightness, $alpha)`
- [ ] `hue($color)`
- [ ] `saturation($color)`
- [ ] `lightness($color)`
- [ ] `adjust-hue($color, $degrees)`
- [ ] `lighten($color, $amount)`
- [ ] `darken($color, $amount)`
- [ ] `saturate($color, $amount)`
- [ ] `desaturate($color, $amount)`
- [ ] `grayscale($color)`
- [ ] `complement($color)`
- [ ] `invert($color)`
- [ ] Opacity Functions
- [ ] `alpha($color) / opacity($color)`
- [ ] `rgba($color, $alpha)`
- [ ] `opacify($color, $amount) / fade-in($color, $amount)`
- [ ] `transparentize($color, $amount) / fade-out($color, $amount)`
- [ ] Other Color Functions
- [ ] `adjust-color($color, [$red], [$green], [$blue], [$hue], [$saturation], [$lightness], [$alpha])`
- [ ] `scale-color($color, [$red], [$green], [$blue], [$saturation], [$lightness], [$alpha])`
- [ ] `change-color($color, [$red], [$green], [$blue], [$hue], [$saturation], [$lightness], [$alpha])`
- [ ] `ie-hex-str($color)`
- [ ] String Functions
- [ ] `unquote($string)`
- [ ] `quote($string)`
- [ ] `str-length($string)`
- [ ] `str-insert($string, $insert, $index)`
- [ ] `str-index($string, $substring)`
- [ ] `str-slice($string, $start-at, [$end-at])`
- [ ] `to-upper-case($string)`
- [ ] `to-lower-case($string)`
- [ ] Number Functions
- [ ] `percentage($number)`
- [ ] `round($number)`
- [ ] `ceil($number)`
- [ ] `floor($number)`
- [ ] `abs($number)`
- [ ] `min($numbers…)`
- [ ] `max($numbers…)`
- [ ] `random([$limit])`
- [ ] List Functions
- [ ] `length($list)`
- [ ] `nth($list, $n)`
- [ ] `set-nth($list, $n, $value)`
- [ ] `join($list1, $list2, [$separator])`
- [ ] `append($list1, $val, [$separator])`
- [ ] `zip($lists…)`
- [ ] `index($list, $value)`
- [ ] `list-separator(#list)`
- [ ] Map Functions
- [ ] `map-get($map, $key)`
- [ ] `map-merge($map1, $map2)`
- [ ] `map-remove($map, $keys…)`
- [ ] `map-keys($map)`
- [ ] `map-values($map)`
- [ ] `map-has-key($map, $key)`
- [ ] `keywords($args)`
- [ ] Selector Functions
- .... to be expanded ...
- [ ] CodeGen
- [ ] CompactCompiler
- [ ] CompileCssImportStmt: `@import url(...);`
- [ ] CompileRuleSet
- [ ] CompileSelectors
- [ ] CoimpileParentSelector
- [ ] CompileSubRuleSet
- [ ] CompileCommentBlock
- [ ] CompileDeclBlock
- [ ] CompileMediaQuery: `@media`
- [ ] CompileSupportrQuery: `@support`
- [ ] CompileFontFace: `@support`
- [ ] CompileForStmt
- [ ] CompileIfStmt
- [ ] CompileElseIfStmt
- [ ] CompileWhileStmt
- [ ] CompileEachStmt
- [ ] ... list more ast nodes here ...
- [ ] Syntax
- [ ] built-in `@import-once`
## Ambiguity
The original design of SASS contains a lot of grammar ambiguity.
for example, as SASS uses interpolation:
```
#{$name}:before {
}
```
Since nested properties are allowed, in the above code, we don't know if it's a
selector or a property namespace if we don't know the `$name` variable.
Where `before` might be a property value or a part of the selector.
links:
-
-
To handle this kind of interpolation, we define a type of token named template:
```
#{$name}:before a {
}
```
In the above code, `#{$name}:before a` is treated as `T_SELECTOR_TEMPLATE` token, which
type will be resolved at the runtime.
## Self Benchmarking
[](https://raw.githubusercontent.com/c9s/c6/master/benchmarks/summary.svg)
## FAQ
### Why do you want to implement another SASS compiler?
The original SASS is written in Ruby and it's really slow, we take 11 seconds
to compile the stylesheets of our application, libsass is fast but it does not
catch up the ruby sass implementation , and you can't compile them with Compass.
Since Go is simple, easy & fast, thus we implement SASS in Go to move faster.
Further, we want to design a new language (ECSS temporarily named) that is compatible with SASS 3.4 or
even SASS 4.0 with more powerful features.
## Reference
SASS Reference
A feature check list from libsass:
-
-
Standards:
- CSS Syntax Module Level 3
- CSS 3 Selector
- CSS Font
- Selectors API
- At-Page Rule
- Railroad diagram
- CSS 2.1 Grammar
SASS/CSS Frameworks, libraries:
- Bourbon
- Marx
- FormHack
- Susy
- Gumby
Articles:
- Logic in media queries -
## Contribution
Please open up an issue on GitHub before you put a lot efforts on pull request.
The code submitting to PR must be filtered with `gofmt`
## Community
- Slack: we are on Slack channel `#c6`, go invite yourself here:
- Our Official Twitter Channel:
## License
MPL License
(MPL is like LGPL but with static/dynamic linking exception, which allows you
to either dynamic/static link this library without permissions)
[](https://bitdeli.com/free "Bitdeli Badge")