File: usage.rst

package info (click to toggle)
python-pyscss 1.3.4-4~bpo8%2B1
  • links: PTS, VCS
  • area: main
  • in suites: jessie-backports
  • size: 6,160 kB
  • sloc: python: 12,494; ansic: 1,544; makefile: 152; sh: 24
file content (86 lines) | stat: -rw-r--r-- 1,835 bytes parent folder | download | duplicates (5)
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
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
Installation and usage
======================

Installation
------------

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


Usage
-----

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.

.. note::

    ``-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 scss.py --interactive
    >>> @import "compass/css3"
    >>> show()
    ['functions', 'mixins', 'options', 'vars']
    >>> show(mixins)
    ['apply-origin',
        'apply-transform',
        ...
        'transparent']
    >>> show(mixins, transparent)
    @mixin transparent() {
        @include opacity(0);
    }
    >>> 1px + 5px
    6px
    >>> _


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