Sass/SCSS for Python — libsass 0.23.0 documentation (original) (raw)

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.txtfile.

It currently supports CPython 3.7+ and PyPy 3!

Features

Install

It’s available on PyPI, so you can install it using pip:

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.

Examples

Compile a String of Sass to CSS

import sass sass.compile(string='a { b { color: blue; } }') 'a b {\n color: blue; }\n'

Compile a Directory of Sass Files to CSS

import sass import os os.mkdir('css') os.mkdir('sass') scss = """
... $theme_color: #cc0000; ... body { ... background-color: $theme_color; ... } ... """ with open('sass/example.scss', 'w') as example_scss: ... example_scss.write(scss) ... sass.compile(dirname=('sass', 'css'), output_style='compressed') with open('css/example.css') as example_css: ... print(example_css.read()) ... body{background-color:#c00}

User’s Guide

References

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.

Open source

GitHub (Git repository + issues)

https://github.com/sass/libsass-python

GitHub Actions (linux + macos + windows)

Build Status

PyPI

https://pypi.org/pypi/libsass/

PyPI

Changelog

Changelog

Indices and tables