by lesscpy

lesscpy / lesscpy

Python LESS compiler

131 Stars 43 Forks Last release: Not found MIT License 413 Commits 7 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:


.. image:: https://travis-ci.org/lesscpy/lesscpy.png?branch=master :target: https://travis-ci.org/lesscpy/lesscpy

.. image:: https://coveralls.io/repos/lesscpy/lesscpy/badge.png :target: https://coveralls.io/r/lesscpy/lesscpy

.. image:: https://img.shields.io/pypi/dm/lesscpy.svg :target: https://pypi.python.org/pypi/lesscpy

.. image:: https://img.shields.io/pypi/v/lesscpy.svg :target: https://pypi.python.org/pypi/lesscpy

.. image:: https://img.shields.io/pypi/wheel/lesscpy.svg :target: https://pypi.python.org/pypi/lesscpy :alt: Wheel Status

.. image:: https://img.shields.io/pypi/l/lesscpy.svg :target: https://pypi.python.org/pypi/lesscpy :alt: License

Python LESS Compiler.

A compiler written in Python for the LESS language. For those of us not willing or able to have node.js installed in our environment. Not all features of LESS are supported (yet). Some features wil probably never be supported (JavaScript evaluation). This program uses PLY (Python Lex-Yacc) to tokenize / parse the input and is considerably slower than the NodeJS compiler. The plan is to utilize this to build in proper syntax checking and perhaps YUI compressing.

This is an early version, so you are likely to find bugs.

For more information on LESS: http://lesscss.org/ or https://github.com/cloudhead/less.js

Development files: https://github.com/lesscpy/lesscpy

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 '%(', ...)

Differences from less.js

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

Not supported

  • JavaScript evaluation


  • Python 2.7, 3.4, 3.5, 3.6 or 3.7
  • ply (Python Lex-Yacc) (check requirements.txt)
  • six


To install lesscpy from the

Python Package Index
_, simply:

.. code-block:: bash

$ pip install lesscpy

To do a local system-wide install:

.. code-block:: bash

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

.. code-block:: text

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

LessCss Compiler

positional arguments: target less file or directory output output file path

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 -C, --dont_create_dirs Creates directories when outputing files (lessc non- compatible)

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

<< [email protected] @_o >>

Python usage

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

.. code-block:: python

import lesscpy
from six import StringIO

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

The output will be:

.. code-block:: text



See the LICENSE file

.. _

Python Package Index
: https://pypi.python.org/pypi/lesscpy

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.