Sass for Python: A straightforward binding of libsass for Python.
.. image:: https://badge.fury.io/py/libsass.svg :alt: PyPI :target: https://pypi.org/pypi/libsass/
.. image:: https://dev.azure.com/asottile/asottile/_apis/build/status/sass.libsass-python?branchName=main :target: https://dev.azure.com/asottile/asottile/_build/latest?definitionId=22&branchName=main :alt: Build Status
.. image:: https://img.shields.io/azure-devops/coverage/asottile/asottile/22/main.svg :target: https://dev.azure.com/asottile/asottile/_build/latest?definitionId=22&branchName=main :alt: Coverage Status
.. image:: https://results.pre-commit.ci/badge/github/sass/libsass-python/main.svg :target: https://results.pre-commit.ci/latest/github/sass/libsass-python/main :alt: pre-commit.ci status
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.
No need for Ruby nor Node.js.
It currently supports CPython 3.6+, and PyPy 3!
.. _Sass: https://sass-lang.com/ .. _LibSass: https://github.com/sass/libsass
@import
callbacks.setuptools
/distutils
integration.
You can build all Sass/SCSS files using
setup.py build_sass
command... _wheel: https://www.python.org/dev/peps/pep-0427/
It's available on PyPI_, so you can install it using pip
(or
easy_install
):
.. code-block:: console
$ pip install libsass
.. note::
libsass requires some features introduced by the recent C++ standard. You need a C++ compiler that support those features. See also libsass project's README_ file.
.. _PyPI: https://pypi.org/pypi/libsass/ .. _README: https://github.com/sass/libsass#readme
.. _example:
.. code-block:: pycon
import sass print sass.compile(string='a { b { color: blue; } }') a b { color: blue; }
There's the user guide manual and the full API reference for libsass
:
https://sass.github.io/libsass-python/
You can build the docs by yourself:
.. code-block:: console
$ cd docs/ $ make html
The built docs will go to docs/_build/html/
directory.
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 are all distributed under MIT license
_.
.. _MIT license: https://mit-license.org/