Metadata-Version: 1.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
Description: 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
        
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
