pyScss, a Scss compiler for Python
Switch branches/tags
Nothing to show
Pull request Compare This branch is 1005 commits behind Kronuz:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


pyScss, a Scss compiler for Python

Author:German M. Bravo (Kronuz) <>


pyScss compiles Scss (Sass), a superset of CSS that is more powerful, elegant and easier to maintain than plain-vanilla CSS. The library acts as a CSS source code preprocesor which allows you to use variables, nested rules, mixins, and have inheritance of rules, all with a CSS-compatible syntax which the preprocessor then compiles to standard CSS.

Scss, as an extension of CSS, helps keep large stylesheets well-organized. It borrows concepts and functionality from projects such as OOCSS and other similar frameworks like as Sass. It's build on top of the original PHP xCSS codebase structure but it's been completely rewritten, many bugs have been fixed and it has been extensively extended to support almost the full range of Sass' Scss syntax and functionality.


pyScss is fully compatible with SCSS (Sass) 3.2 has:

  • Compass: Compass 0.11 Support
  • Nested rules
  • Keyword arguments
  • Mixins: @mixin, @include
  • Functions: @function, @return
  • Inheritance: @extend
  • Conditions: @if, @else if, @else
  • Loops: @for, @each
  • Variables: $, @variables, @vars
  • Sprites: sprite-map(), sprite(), sprite-position(), sprite-url(), ...
  • Images: image-url(), image-width(), image-height(), ...
  • Embedded (inline) images: inline-image()
  • Colors handling: adjust-color(), scale-color(), opacify()/transparentize(), lighten()/darken(), mix(), ...
  • Math functions: sin(), cos(), tan(), round(), ceil(), floor(), pi(), ...
  • CSS Compression: @option compress:yes;


  • python >= 2.5


pyScss should be installed using pip or setuptools:

pip install pyScss

easy_install pyScss


Usage example:

from scss import Scss
css = Scss()
css.compile("a { color: red + green; }")

Or compile from the command line:

python < file.scss

Interactive mode:

python --interactive


  1. Nested Rules


    @option compress: no;
    .selector {
        a {
            display: block;
            strong {
            color: blue;


    .selector a {
        display: block;
    .selector strong {
        color: #00f;
  2. Variables


    @option compress: no;
    $main-color: #ce4dd6;
    $style: solid;
    $side: bottom;
    #navbar {
        border-#{$side}: {
            color: $main-color;
            style: $style;


    #navbar {
        border-bottom-color: #ce4dd6;
        border-bottom-style: solid;
  3. Mixins


    @option compress: no;
    @mixin rounded($side, $radius: 10px) {
        border-#{$side}-radius: $radius;
        -moz-border-radius-#{$side}: $radius;
        -webkit-border-#{$side}-radius: $radius;
    #navbar li { @include rounded(top); }
    #footer { @include rounded(top, 5px); }
    #sidebar { @include rounded(left, 8px); }


    #navbar li {
        border-top-radius: 10px;
        -moz-border-radius-top: 10px;
        -webkit-border-top-radius: 10px;
    #footer {
        border-top-radius: 5px;
        -moz-border-radius-top: 5px;
        -webkit-border-top-radius: 5px;
    #sidebar {
        border-left-radius: 8px;
        -moz-border-radius-left: 8px;
        -webkit-border-left-radius: 8px;
  4. Extend (using @extend)


    @option compress: no;
    .error {
        border: 1px #f00;
        background-color: #fdd;
    .error.intrusion {
        background-image: url("/image/hacked.png");
    .seriousError {
        @extend .error;
        border-width: 3px;


    .seriousError {
        border: 1px red;
        background-color: #fdd;
    .seriousError.intrusion {
        background-image: url("/image/hacked.png");
    .seriousError {
        border-width: 3px;
  5. Sprites (using sprite-map())


    @option compress: no;
    $icons: sprite-map("sociable/*.png"); // contains sociable/facebook.png among others.
    div {
        background: $icons;
    @each $icon in sprites($icons) {
        div .#{$icon} {
            width: image-width(sprite-file($icons, $icon));
            height: image-height(sprite-file($icons, $icon));
            background-position: sprite-position($icons, $icon);

    ...generates a new sprite file and produces something like:

    div {
        background: url("/static/assets/u8Y7yEQL0UffAVw5rX7yhw.png?_=1298240989") 0px 0px no-repeat;
    div .facebook {
        width: 32px;
        height: 32px;
        background-position: 0px 0px;
    div .twitter {
        width: 32px;
        height: 32px;
        background-position: 0px -32px;
  6. Interactive mode


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

Sass Sassy CSS

pyScss is a Scss (Sass) implementation for Python. Currently it implements @mixin, @include, @if, @else, @for, and @import... it also implements many of the Sass functions including color functions like hsla(), hsl(), darken(), lighten(), mix(), opacify(), transparentize(), saturate(), desaturate(), etc.) as well as sprite-map(), sprite-file(), image-width(), image-height() and the others.

In the file, by the top, you can configure the LOAD_PATHS to point to your Sass frameworks path (I have sass/frameworks/compass/*.scss and sass/framework/blueprint/*.scss files in my project directory: /usr/local/www/project/, where lives, so it defaults to use the sass/framework/ path, relative to the file) or configure using the command line --load-path option, see python --help.

I have succesfully compiled some Compass using python < myfile.css the following myfile.css:

@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";

// Stuff goes here...


pyScss has been optimized for speed. Compiling Compass 0.11.beta.2 (compass/doc-src/content/stylesheets/screen.scss)

...using Sass 3.1.0.alpha.221:

Compilation took 2.683s (w/o cache)
Compilation took 1.35s  (cached)

...using pyScss 1.0 beta:

Compilation took 0.614s

Bug tracker

If you have any suggestions, bug reports or annoyances please report them to the issue tracker at


Development of pyScss happens at github:


MIT License. See LICENSE for details.


Copyright (c) 2011 German M. Bravo (Kronuz) Bits of code in pyScss come from various projects:

(c) 2009 Christopher M. Eppstein
(c) 2006-2009 Hampton Catlin and Nathan Weizenbaum
(c) 2010 Anton Pawlik