You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
206 lines
5.8 KiB
206 lines
5.8 KiB
Metadata-Version: 2.1
|
|
Name: lesscpy
|
|
Version: 0.14.0
|
|
Summary: Python LESS compiler
|
|
Home-page: https://github.com/lesscpy/lesscpy
|
|
Author: Jóhann T Maríusson
|
|
Author-email: jtm@robot.is
|
|
License: MIT
|
|
Platform: UNKNOWN
|
|
Classifier: Development Status :: 5 - Production/Stable
|
|
Classifier: Environment :: Console
|
|
Classifier: Intended Audience :: End Users/Desktop
|
|
Classifier: Intended Audience :: Developers
|
|
Classifier: Intended Audience :: System Administrators
|
|
Classifier: License :: OSI Approved :: MIT License
|
|
Classifier: Operating System :: OS Independent
|
|
Classifier: Programming Language :: Python
|
|
Classifier: Programming Language :: Python :: 2
|
|
Classifier: Programming Language :: Python :: 2.7
|
|
Classifier: Programming Language :: Python :: 3
|
|
Classifier: Programming Language :: Python :: 3.4
|
|
Classifier: Programming Language :: Python :: 3.5
|
|
Classifier: Programming Language :: Python :: 3.6
|
|
Classifier: Programming Language :: Python :: 3.7
|
|
Classifier: Programming Language :: Python :: Implementation :: CPython
|
|
Classifier: Programming Language :: Python :: Implementation :: PyPy
|
|
Classifier: Topic :: Software Development :: Code Generators
|
|
Classifier: Topic :: Software Development :: Pre-processors
|
|
Requires-Dist: ply
|
|
Requires-Dist: six
|
|
|
|
LESSCPY
|
|
=======
|
|
|
|
.. 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
|
|
|
|
|
|
Requirements
|
|
------------
|
|
|
|
- Python 2.7, 3.4, 3.5, 3.6 or 3.7
|
|
- ply (Python Lex-Yacc) (check requirements.txt)
|
|
- six
|
|
|
|
Installation
|
|
------------
|
|
|
|
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
|
|
|
|
<< jtm@robot.is @_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
|
|
|
|
a{border-width:6px;}
|
|
|
|
License
|
|
-------
|
|
|
|
See the LICENSE file
|
|
|
|
|
|
.. _`Python Package Index`: https://pypi.python.org/pypi/lesscpy
|
|
|
|
|