Fetching contributors…
Cannot retrieve contributors at this time
87 lines (58 sloc) 1.79 KB

Installation and usage


pyScss requires only Python 2.6 or later, including Python 3.x. PyPy is also known to work. Install with pip:

pip install pyScss

It has a handful of pure-Python dependencies, which pip should install for you:

  • six
  • enum34 (for Python 3.3 and below)
  • pathlib (for Python 3.3 and below)

There's also an optional C speedup module, which requires having libpcre and its development headers installed, with UTF-8 support enabled (which it is by default).


Run from the command line by using -m:

python -m scss < file.scss

Specify directories to search for imports with -I. See python -mscss --help for more options.


-mscss will only work in Python 2.7 and above. In Python 2.6, -m doesn't work with packages, and you need to invoke this instead:

python -m scss.tool

Interactive mode

To get a REPL:

python -mscss --interactive

Example session:

$ python --interactive
>>> @import "compass/css3"
>>> show()
['functions', 'mixins', 'options', 'vars']
>>> show(mixins)
>>> show(mixins, transparent)
@mixin transparent() {
    @include opacity(0);
>>> 1px + 5px
>>> _

Compass example

With --load-path set to Compass and Blueprint roots, you can compile with Compass like with the following:

@option compress: no;

$blueprint-grid-columns : 24;
$blueprint-grid-width   : 30px;
$blueprint-grid-margin  : 10px;
$font-color             : #333;

@import "compass/reset";
@import "compass/utilities";
@import "blueprint";

// your code...