Add source_map option to Manifest.build_one()

Author: dahlia

docs/changes.rst

@@ -8,6 +8,9 @@ To be released.
 
 - Expose source maps support:
 
+  - :meth:`Manifest.build_one() <sassutils.builder.Manifest.build_one>` method
+    has a new ``source_map`` option.  This option builds also a source map
+    file with the filename followed by :file:`.map` suffix.
   - :func:`sass.compile()` has a new optional parameter ``source_comments``.
     It can be one of :const:`sass.SOURCE_COMMENTS` keys.  It also has
     a new parameter ``source_map_filename`` which is required only when

sasstests.py

@@ -233,6 +233,35 @@ def test_normalize_manifests(self):
         assert manifests['package.name2'].sass_path == 'sass/path'
         assert manifests['package.name2'].css_path == 'css/path'
 
+    def test_build_one(self):
+        d = tempfile.mkdtemp()
+        try:
+            shutil.copytree('test', os.path.join(d, 'test'))
+            m = Manifest(sass_path='test', css_path='css')
+            m.build_one(d, 'a.sass')
+            with open(os.path.join(d, 'css', 'a.sass.css')) as f:
+                self.assertEqual(A_EXPECTED_CSS, f.read())
+            m.build_one(d, 'b.sass', source_map=True)
+            with open(os.path.join(d, 'css', 'b.sass.css')) as f:
+                self.assertEqual(
+                    B_EXPECTED_CSS +
+                    '\n/*# sourceMappingURL=b.sass.css.map */',
+                    f.read()
+                )
+            with open(os.path.join(d, 'css', 'b.sass.css.map')) as f:
+                self.assertEqual(
+                    {
+                        'version': 3,
+                        'file': 'b.sass',
+                        'sources': ['../test/b.sass'],
+                        'names': [],
+                        'mappings': 'AAAA,EACE;EACE,WAAW'
+                    },
+                    json.load(f)
+                )
+        finally:
+            shutil.rmtree(d)
+
 
 class WsgiTestCase(unittest.TestCase):
 

sassutils/builder.py

@@ -154,25 +154,47 @@ def build(self, package_dir):
         return frozenset(os.path.join(self.css_path, filename)
                          for filename in css_files)
 
-    def build_one(self, package_dir, filename):
+    def build_one(self, package_dir, filename, source_map=False):
         """Builds one SASS/SCSS file.
 
         :param package_dir: the path of package directory
         :type package_dir: :class:`str`, :class:`basestring`
         :param filename: the filename of SASS/SCSS source to compile
         :type filename: :class:`str`, :class:`basestring`
+        :param source_map: whether to use source maps.  if :const:`True`
+                           it also write a source map to a ``filename``
+                           followed by :file:`.map` suffix.
+                           default is :const:`False`
+        :type source_map: :class:`bool`
         :returns: the filename of compiled CSS
         :rtype: :class:`str`, :class:`basestring`
 
+        .. versionadded:: 0.4.0
+           Added optional ``source_map`` parameter.
+
         """
         sass_filename, css_filename = self.resolve_filename(
             package_dir, filename)
         root_path = os.path.join(package_dir, self.sass_path)
-        css = compile(filename=sass_filename, include_paths=[root_path])
         css_path = os.path.join(package_dir, self.css_path, css_filename)
+        if source_map:
+            source_map_path = css_filename + '.map'
+            css, source_map = compile(
+                filename=sass_filename,
+                include_paths=[root_path],
+                source_comments='map',
+                source_map_filename=source_map_path  # FIXME
+            )
+        else:
+            css = compile(filename=sass_filename, include_paths=[root_path])
+            source_map_path = None
+            source_map = None
         css_folder = os.path.dirname(css_path)
         if not os.path.exists(css_folder):
             os.makedirs(css_folder)
         with open(css_path, 'w') as f:
             f.write(css)
+        if source_map:
+            with open(source_map_path, 'w') as f:
+                f.write(source_map)
         return css_filename