Development Status
- 5 - Production/Stable
Environment
- Web Environment
Intended Audience
- Developers
License
- OSI Approved :: MIT License
Operating System
- OS Independent
Programming Language
- C
- C++
- Python :: 3
- Python :: 3 :: Only
- Python :: Implementation :: CPython
- Python :: Implementation :: PyPy
- Python :: Implementation :: Stackless
Topic
- Internet :: WWW/HTTP
- Internet :: WWW/HTTP :: Dynamic Content
- Software Development :: Code Generators
- Software Development :: Compilers
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 to 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.7+, and PyPy 3!
Features
You don’t need any Ruby/Node.js stack at all, for development or deployment either.
Fast. (LibSass is written in C++.)
Simple API. See the below example code for details.
Custom functions.
@import callbacks.
Support both tabbed (Sass) and braces (SCSS) syntax.
WSGI middleware for ease of development. It automatically compiles Sass/SCSS files for each request.
setuptools/distutils integration. You can build all Sass/SCSS files using setup.py build_sass command.
Works also on PyPy.
Provides prebuilt wheel binaries for Linux, Windows, and Mac.
Install
It’s available on PyPI, so you can install it using pip (or easy_install):
$ pip install libsassExample
>>> import sass
>>> print sass.compile(string='a { b { color: blue; } }')
a b {
color: blue; }Docs
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:
$ cd docs/
$ make htmlThe built docs will go to docs/_build/html/ directory.
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 are all distributed under MIT license.
Wheel compatibility matrix
| Platform | CPython >=3.8 (abi3) |
|---|---|
| macosx_11_0_x86_64 | |
| macosx_14_0_arm64 | |
| manylinux1_x86_64 | |
| manylinux_2_5_x86_64 | |
| win32 | |
| win_amd64 |