Sassquatch

Sassquatch is a Python wrapper for Dart Sass, providing a convenient way to compile Sass/SCSS to CSS in your Python applications.

Installation

Install Sassquatch with your package manager of choice:

uv add sassquatch
# or, good old:
pip install sassquatch

During installation, Sassquatch will automatically download the latest version of Dart Sass for your platform.

Features

• Compile Sass/SCSS from strings, files, or directories
• Full compatibility with Dart Sass's compilation features
• Use as a command-line tool or as a Python library
• Automatic download and management of the Dart Sass binary

Usage

Command Line Interface

Sassquatch follows Dart Sass CLI semantics:

# Compile a file to stdout
sassquatch path/to/input.scss

# Compile a file to a specific output file
sassquatch path/to/input.scss:path/to/output.css

# Compile a directory
sassquatch path/to/input_dir:path/to/output_dir

# Compile from stdin
echo "body { color: red; }" | sassquatch

# Compile with options
sassquatch path/to/input.scss --style=compressed --no-charset

# update embedded sass version:
sassquatch --sass-update

# see all options:
sassquatch --help

Python API

from sassquatch import compile

# Compile a string
css = compile(string='$primary: #333; body { color: $primary; }')

# Compile a file
css = compile(path='styles.scss')

# Compile with options
css = compile(
    path='styles.scss',
    style='compressed',
    no_charset=True,
    load_path=['node_modules']
)

Configuration

Sassquatch supports all Dart Sass command-line options:

For a full list of options, refer to the Dart Sass documentation.

Implementation Details

Sassquatch is based on Dart Sass (embedded mode) and downloads the latest version of the Dart Sass binary during installation. This ensures you always have access to the most up-to-date Sass features and fixes.

License

This project is licensed under the MIT License.

Acknowledgments

• Dart Sass - The core Sass compiler