Add support for Dart Sass

Author: andreyfedoseev

CHANGES.md

@@ -2,7 +2,21 @@
 
 ### Dev
 
+#### Deprecation
+
+- Ruby-based Sass compiler is deprecated and will be removed in 3.0
+
+#### New
+
+- Added support for Dart Sass, see documentation on how to enable it.
+  Dart Sass will become the default Sass compiler starting from 3.0
+
+#### Bugfixes
+
 - Fix the bug with a greedy regex in the URL converter
+
+#### Misc
+
 - Ensure compatibility with the latest versions of compilers:
   - [email protected] (may break compatibility with older versions)
   - [email protected]

Dockerfile

@@ -1,4 +1,4 @@
-FROM andreyfedoseev/django-static-precompiler:18.04-1
+FROM andreyfedoseev/django-static-precompiler:18.04-2
 ARG DEBIAN_FRONTEND=noninteractive
 ENV TZ=Etc/UTC
 RUN apt update && \

Dockerfile-base

@@ -1,6 +1,6 @@
 FROM ubuntu:18.04
 MAINTAINER Andrey Fedoseev <[email protected]>
-RUN apt-get update && apt-get install -y autoconf libtool ruby-dev npm
+RUN apt-get update && apt-get install -y autoconf libtool ruby-dev npm wget
 RUN ln -s /usr/bin/nodejs /usr/local/bin/node
 RUN npm install -g [email protected]
 RUN npm install -g [email protected]
@@ -10,3 +10,6 @@ RUN npm install -g [email protected]
 RUN npm install -g [email protected]
 RUN gem install sass -v 3.4.22
 RUN gem install compass -v 1.0.1
+RUN wget -O /tmp/dart-sass.tar.gz https://github.com/sass/dart-sass/releases/download/1.56.1/dart-sass-1.56.1-linux-x64.tar.gz && \
+    tar -xzf /tmp/dart-sass.tar.gz -C /opt && \
+    rm -rf /tmp/dart-sass.tar.gz

docs/compiler-settings.rst

@@ -119,6 +119,8 @@ Example:
 SASS / SCSS
 ===========
 
+Ruby-based (legacy) SASS compiler.
+
 ``executable``
   Path to SASS compiler executable. Default: "sass".
 
@@ -159,6 +161,48 @@ Example:
     )
 
 
+Dart Sass
+=========
+
+Dart Sass is the current implementation of SASS.
+
+.. note:: Dart Sass compiler is not enabled by default. See the example below for how to enable it.
+
+Options:
+
+``sourcemap_enabled``
+  Boolean. Set to ``True`` to enable source maps. Default: ``False``.
+
+``load_paths``
+  List of additional paths to find imports. Default: ``None``.
+
+``output_style``
+  Output style. Default: ``None``.
+  Can be "expanded" or "compressed".
+
+Example:
+
+.. code-block:: python
+
+    STATIC_PRECOMPILER_COMPILERS = (
+        (
+            "static_precompiler.compilers.dart_sass.SCSS",
+            {
+                "sourcemap_enabled": True,
+                "load_paths": ["/path"],
+            },
+        ),
+        (
+            "static_precompiler.compilers.dart_sass.SASS",
+            {
+                "sourcemap_enabled": True,
+                "load_paths": ["/path"],
+                "output_style": "compressed",
+            },
+        ),
+    )
+
+
 Libsass
 =======
 
@@ -212,8 +256,6 @@ Example:
         ),
     )
 
-.. note:: Libsass compiler doesn't support Compass extension, but you can replace it with `compass-mixins <https://github.com/Igosuki/compass-mixins>`_.
-
 
 LESS
 ====

docs/conf.py

@@ -43,7 +43,7 @@
 
 # General information about the project.
 project = "django-static-precompiler"
-copyright = "2021, Andrey Fedoseev"
+copyright = "2022, Andrey Fedoseev"
 author = "Andrey Fedoseev"
 
 # The version info for the project you're documenting, acts as replacement for
@@ -60,7 +60,7 @@
 #
 # This is also used if you do content translation via gettext catalogs.
 # Usually you set "language" from the command line for these cases.
-language = None
+language = "en"
 
 # There are two options for replacing |today|: either, you set today to some
 # non-false value, then it is used: