Metadata-Version: 1.0
Name: libsass
Version: 0.1.1
Summary: SASS for Python: A straightforward binding of libsass for Python.
Home-page: https://github.com/dahlia/libsass-python
Author: Hong Minhee
Author-email: minhee@dahlia.kr
License: MIT License
Description: libsass: SASS_ for Python
        =========================
        
        This package provides a simple Python extension module ``sass`` which is
        binding Libsass_ (written in C/C++ by Hampton Catlin and Aaron Leung).
        It's very straightforward and there isn't any headache related Python
        distribution/deployment.  That means you can add just ``libsass`` into
        your ``setup.py``'s ``install_requires`` list or ``requirements.txt`` file.
        
        It currently supports CPython 2.5, 2.6, 2.7, and PyPy 1.9!
        
        .. _SASS: http://sass-lang.com/
        .. _Libsass: https://github.com/hcatlin/libsass
        
        
        Install
        -------
        
        Use ``easy_install`` or ``pip``::
        
            $ easy_install libsass
        
        
        Use
        ---
        
        >>> import sass
        >>> print sass.compile(string='a { b { color: blue; } }')
        'a b {\n  color: blue; }\n'
        
        
        ``sass.compile()``
        ------------------
        
        It takes a source ``string`` or a ``filename`` and returns the compiled
        CSS string.
        
        If it fails for any reason (for example the given SASS has broken syntax)
        it will raise ``sass.CompileError``.
        
        ``string`` (required)
           The string of SASS source code to compile.  It's exclusive to ``filename``
           parameter.
        
        ``filename`` (required)
           The filename of SASS source code to compile.  It's exclusive to ``string``
           parameter.
        
           If the file does not exist or cannot be read it will raises
           ``exceptions.IOError`` exception.
        
        ``output_style`` (optional)
           The coding style of the compiled result.  Choose one in:
        
           - ``'nested'`` (default)
           - ``'expanded'``
           - ``'compact'``
           - ``'compressed'``
        
        ``include_paths`` (optional)
           The list of paths to find ``@import``\ ed SASS/CSS source files.
        
        ``image_path`` (optional)
           The path to find images.
        
        
        ``sass.CompileError``
        ---------------------
        
        The exception type that is raised by ``sass.compile()``.  It is a subtype
        of ``exceptions.ValueError``.
        
        
        Credit
        ------
        
        Hong Minhee wrote this Python binding of Libsass_.
        
        Hampton Catlin and Aaron Leung wrote Libsass_, which is portable C/C++
        implementation of SASS_.
        
        Hampton Catlin originally designed SASS_ language and wrote the first
        reference implementation of it in Ruby.
        
        The above three softwares are all distributed under `MIT license`_.
        
        .. _MIT license: http://mit-license.org/
        
        
        Changelog
        ---------
        
        Version 0.1.1
        '''''''''''''
        
        Released on August 18, 2012.
        
        - Fixed segmentation fault for reading ``filename`` which does not exist.
          Now it raises a proper ``exceptions.IOError`` exception.
        
        
        Version 0.1.0
        '''''''''''''
        
        Released on August 17, 2012.  Initial version.
        
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: C
Classifier: Programming Language :: C++
Classifier: Programming Language :: Python :: 2.5
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 2 :: Only
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Software Development :: Code Generators
Classifier: Topic :: Software Development :: Compilers
