Supported features

• Variables

• String interpolation

• Mixins (nested, calls, closures, recursive)

• Guard expressions

• Parametered mixins (class / id)

• @arguments

• Nesting

• Escapes ~/e()

• Expressions

• Keyframe blocks

• Color functions (lighten, darken, saturate, desaturate, spin, hue, mix,

  saturation, lightness)

• Other functions (round, increment, decrement, format ‘%(‘, …)

• Keyframe blocks

Differences from less.js

• All colors are auto-formatted to #nnnnnn. eg, #f7e923
• Does not preserve CSS comments

Not supported

• JavaScript evaluation

Requirements

• Python 2.6, 2.7, or 3.3
• ply (Python Lex-Yacc) (check requirements.txt)

Installation

To install lesscpy from the Python Package Index, simply:

$ pip install lesscpy

To do a local system-wide install:

python setup.py install

Or simply place the package into your Python path. Or rather use packages provided by your distribution (openSUSE has them at least).

Compiler script Usage

usage: lesscpy [-h] [-v] [-I INCLUDE] [-V] [-x] [-X] [-t] [-s SPACES] [-o OUT]
               [-r] [-f] [-m] [-D] [-g] [-S] [-L] [-N]
               target

LessCss Compiler

positional arguments:
  target                less file or directory

optional arguments:
  -h, --help            show this help message and exit
  -v, --version         show program's version number and exit
  -I INCLUDE, --include INCLUDE
                        Included less-files (comma separated)
  -V, --verbose         Verbose mode

Formatting options:
  -x, --minify          Minify output
  -X, --xminify         Minify output, no end of block newlines
  -t, --tabs            Use tabs
  -s SPACES, --spaces SPACES
                        Number of startline spaces (default 2)

Directory options:
  Compiles all \*.less files in directory that have a newer timestamp than
  it's css file.

  -o OUT, --out OUT     Output directory
  -r, --recurse         Recursive into subdirectorys
  -f, --force           Force recompile on all files
  -m, --min-ending      Add '.min' into output filename. eg, name.min.css
  -D, --dry-run         Dry run, do not write files

Debugging:
  -g, --debug           Debugging information
  -S, --scopemap        Scopemap
  -L, --lex-only        Run lexer on target
  -N, --no-css          No css output

Python usage

If you want to use the compiler from within Python, you can do it like this:

import lesscpy
from six import StringIO

print(lesscpy.compile(StringIO(u"a { border-width: 2px * 3; }"), minify=True))

The output will be:

a{border-width:6px;}

License

See the LICENSE file