1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64
|
pyScss, a Scss compiler for Python
==================================
|build-status| |coverage|
.. |build-status| image:: https://travis-ci.org/Kronuz/pyScss.svg?branch=master
:target: https://travis-ci.org/Kronuz/pyScss
.. |coverage| image:: https://coveralls.io/repos/Kronuz/pyScss/badge.png
:target: https://coveralls.io/r/Kronuz/pyScss
pyScss is a compiler for the `Sass`_ language, a superset of CSS3 that adds
programming capabilities and some other syntactic sugar.
.. _Sass: http://sass-lang.com/
Quickstart
----------
You need Python 2.6+ or 3.3+. PyPy is also supported.
Installation::
pip install pyScss
Usage::
python -mscss < style.scss
Python API::
from scss import Compiler
Compiler().compile_string("a { color: red + green; }")
Features
--------
95% of Sass 3.2 is supported. If it's not supported, it's a bug! Please file
a ticket.
Most of Compass 0.11 is also built in.
Further reading
---------------
Documentation is in Sphinx. You can build it yourself by running ``make html``
from within the ``docs`` directory, or read it on RTD:
http://pyscss.readthedocs.org/en/latest/
The canonical syntax reference is part of the Ruby Sass documentation:
http://sass-lang.com/docs/yardoc/file.SASS_REFERENCE.html
Obligatory
----------
Copyright (c) 2012 German M. Bravo (Kronuz). Additional credits in the
documentation.
Licensed under the `MIT license`_, reproduced in ``LICENSE``.
.. _MIT license: http://www.opensource.org/licenses/mit-license.php
|