Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Python scss parser.

branch: master
Octocat-spinner-32 docs Version 0.6.0 February 23, 2011
Octocat-spinner-32 scss Query string ampersand July 04, 2013
Octocat-spinner-32 .gitignore Start work on documentation February 16, 2011
Octocat-spinner-32 ChangeLog.txt 0.8.72 December 19, 2011
Octocat-spinner-32 DESCRIPTION Version 0.6.4 Add watch mode, add @function, add @return February 27, 2011
Octocat-spinner-32 LICENSE First public release December 20, 2010
Octocat-spinner-32 MANIFEST.in First public release December 20, 2010
Octocat-spinner-32 Makefile Add docs February 16, 2011
Octocat-spinner-32 README First public release December 20, 2010
Octocat-spinner-32 README.rst Fix readme January 23, 2012
Octocat-spinner-32 setup.py Add keywords February 27, 2011
Octocat-spinner-32 todo.txt Version 0.8.4 July 26, 2011
README.rst

Python-scss

Warning:

Im not support python-scss anymore. Use pyscss by Kronus.

Python-scss is SCSS compiler for python. Documentation available at pypi or github. This is part of zeta-library.

Features

Python-scss has most of the funcitonality in Sass SCSS 3.2 and more. It supports:

  • Nested rules
  • Keyword arguments
  • Mixins: @mixin, @include
  • Functions: @function, @return
  • Inheritance: @extend
  • Conditions: @if, @else, @if else
  • Loops: @for
  • Variables: $, @variables, @vars
  • 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(), ...
  • Options: @option compress:true, sort:false;, @option comments:false;
  • Compass_ helpers: enumerate, type-of, ...
  • Sorting declarations: in Zen sorting order

Note

For @import support you can use zeta-library, python compass alternative.

Zeta-library supported @import url(path or http), but all static files css, scss.

Also zeta support js import require( '../jquery.js' );. Zeta allow you control all your static files.

Requirements

  • python >= 2.5
  • pyparsing >= 1.5.5

Installation

python-scss should be installed using pip or setuptools:

pip install scss

easy_install scss

Usage

  1. From python source code:

    from scss import parser
    
    file_path = path_to_file
    src = open( file_path ).read()
    
    # from file
    print parser.load( 'file_path' )
    
    # from string
    print parser.parse( 'src' )
    
    # Create parser object
    p = parser.Stylesheet( options=dict( compress=True ) )
    print p.loads( src )
    p.load( file_path )
    print p
    
  2. From command line:

    $ scss --help
    Usage: scss [OPTION]... [INFILE] [OUTFILE]
    
    Compile INFILE or standard input, to OUTFILE or standard output.
    
    Options:
    --version             show program's version number and exit
    -h, --help            show this help message and exit
    -c, --cache           Create and use cache file. Only for files.
    -i, --interactive     Run in interactive shell mode.
    -m, --compress        Compress css output.
    -w WATCH, --watch=WATCH
                            Watch files or directories for changes. The location
                            of the generated CSS can be set using a colon:
                            scss -w input.scss:output.css
    -S, --no-sorted       Do not sort declaration.
    -C, --no-comments     Clear css comments.
    -W, --no-warnings     Disable warnings.
    
  3. In interactive mode:

    scss -i
    
    >>> 25px + 1.5em
    

Changes

Make sure you`ve read the following document if you are upgrading from previous versions of scss:

http://packages.python.org/scss/changes.html

Examples

  1. Nested Rules

    Example:

    .selector {
        a {
            display: block;
        }
        strong {
            color: blue;
        }
    }
    

    ...produces:

    .selector a {
        display: block}
    
    .selector strong {
        color: blue}
    
  2. Variables

    Example:

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

    ...produces:

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

    Example:

    @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); }
    

    ...produces:

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

    Example:

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

    ...produces:

    .error, .seriousError {
        background-color: #fdd;
        border: 1px #f00}
    
    .error .intrusion, .seriousError .intrusion {
        background-image: url('/image/hacked.png')}
    
    .seriousError {
        border-width: 3px}
    
  5. Interactive mode

    Example:

    $ python scss.py --interactive
    >>> 25px + 1.5em
    44.5px
    >>> lighten(rgba(130,130,130,.4),10%)
    rgba(155,155,155,0.40)
    >>> .rule { test: red; }
    .rule {
        test: red }
    >>> _
    

Options

Python-scss has the following options:

  • compress: Compress output css, default is False
  • cache: Precache compile result, default is False
  • comments: Leave css comments, default is True
  • sort: Sort declaration, default is True Declaration sorted in Zen sorting order
  • warn: Enable or disable warnings: unknown mixin, declaration name, extend ruleset, default is True

Option can be defined...

  1. from command line:

    scss -m -S file.scss
    
  2. from python:

    parser = Stylesheet( options=dict( compress=True ) )
    
  3. from scss source:

    @option compress: true, sort: false;
    

Note

python-scss is still at early stages of development

Bug tracker

If you have any suggestions, bug reports or annoyances please report them to the issue tracker at https://github.com/klen/python-scss/issues

Contributing

Development of python-scss happens at github: https://github.com/klen/python-scss

  • klen (Kirill Klenov)

License

Licensed under a GNU lesser general public license.

Copyright

Copyright (c) 2011 Kirill Klenov (horneds@gmail.com)

Compass:
(c) 2009 Christopher M. Eppstein http://compass-style.org/
SCSS:
(c) 2006-2009 Hampton Catlin and Nathan Weizenbaum http://sass-lang.com/

Note

Your feedback are welcome!

Something went wrong with that request. Please try again.