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...