bin/pscss: add --sourcemap command line option

Author: robocoder

bin/pscss

@@ -20,14 +20,18 @@ include __DIR__ . '/../scss.inc.php';
 
 use Leafo\ScssPhp\Compiler;
 use Leafo\ScssPhp\Parser;
+use Leafo\ScssPhp\SourceMap;
 use Leafo\ScssPhp\Version;
 
-$style = null;
-$loadPaths = null;
 $precision = null;
+$style = null;
 $dumpTree = false;
-$inputFile = null;
+$loadPaths = null;
 $changeDir = false;
+$inputFile = null;
+$outputFile = null;
+$sourceMapFile = null;
+$sourceMap = SourceMap::NONE;
 $debugInfo = false;
 $lineNumbers = false;
 
@@ -63,18 +67,20 @@ for ($i = 1; $i < $argc; $i++) {
         $exe = $argv[0];
 
         $HELP = <<<EOT
-Usage: $exe [options] [input-file]
+Usage: $exe [options] [input-file [output-file.css [sourcemap-file.map]]]
 
 Options include:
 
-    --debug-info   Annotate selectors with CSS referring to the source file and line number
-    -h, --help     Show this message
-    -f=format      Set the output format (compact, compressed, crunched, expanded, or nested)
-    -i=path        Set import path
-    --line-numbers Annotate selectors with comments referring to the source file and line number
-    -p=precision   Set decimal number precision (default 5)
-    -T             Dump formatted parse tree
-    -v, --version  Print the version
+    --debug-info        Annotate selectors with CSS referring to the source file and line number
+    -h, --help          Show this message
+    -f=format           Set the output format (compact, compressed, crunched, expanded, or nested)
+    -i=path             Set import path
+    --line-numbers      Annotate selectors with comments referring to the source file and line number
+    -p=precision        Set decimal number precision (default 5)
+    --sourcemap         Generate sourcemap (default: auto)
+    --sourcemap=option  Set the sourcmap option (auto, file, inline, or none)
+    -T                  Dump formatted parse tree
+    -v, --version       Print the version
 
 EOT;
         exit($HELP);
@@ -99,6 +105,18 @@ EOT;
         continue;
     }
 
+    if ($argv[$i] === '--sourcemap') {
+        $sourceMap = SourceMap::AUTO;
+        continue;
+    }
+
+    $value = parseArgument($i, array('--sourcemap'));
+
+    if (isset($value)) {
+        $sourceMap = $value;
+        continue;
+    }
+
     $value = parseArgument($i, array('-f', '--style'));
 
     if (isset($value)) {
@@ -120,12 +138,35 @@ EOT;
         continue;
     }
 
-    if (file_exists($argv[$i])) {
+    if ($inputFile === null) {
         $inputFile = $argv[$i];
         continue;
     }
+
+    if ($outputFile === null) {
+        $outputFile = $argv[$i];
+        continue;
+    }
+
+    if ($sourceMapFile === null) {
+        $sourceMapFile = $argv[$i];
+        continue;
+    }
+
+    exit("{$argv[0]}: Unrecognized parameter: {$argv[$i]}\n");
+}
+
+if (! in_array($sourceMap, array(SourceMap::NONE, SourceMap::AUTO, SourceMap::FILE, SourceMap::INLINE))) {
+    exit("{$argv[0]}: Unrecognized sourcemap option: $sourceMap\n");
 }
 
+if ($inputFile) {
+    if ($inputFile === '-') {
+        $inputFile = null;
+    } elseif (! file_exists($inputFile)) {
+        exit("{$argv[0]}: Input file: $inputFile doesn't exist\n");
+    }
+}
 
 if ($inputFile) {
     $data = file_get_contents($inputFile);
@@ -154,6 +195,7 @@ if ($dumpTree) {
 }
 
 $scss = new Compiler();
+$scss->setSourceMap($sourceMap);
 
 if ($debugInfo && $inputFile) {
     $scss->setLineNumberStyle(Compiler::DEBUG_INFO);

scss.inc.php

@@ -20,6 +20,9 @@
     include_once __DIR__ . '/src/Node.php';
     include_once __DIR__ . '/src/Node/Number.php';
     include_once __DIR__ . '/src/Parser.php';
+    include_once __DIR__ . '/src/SourceMap.php';
+    include_once __DIR__ . '/src/SourceMap/Base64.php';
+    include_once __DIR__ . '/src/SourceMap/Base64VLQ.php';
     include_once __DIR__ . '/src/Type.php';
     include_once __DIR__ . '/src/Util.php';
     include_once __DIR__ . '/src/Version.php';

src/Compiler.php

@@ -19,6 +19,7 @@
 use Leafo\ScssPhp\Node;
 use Leafo\ScssPhp\Type;
 use Leafo\ScssPhp\Parser;
+use Leafo\ScssPhp\SourceMap;
 use Leafo\ScssPhp\Util;
 
 /**
@@ -117,6 +118,7 @@ class Compiler
     );
 
     protected $lineNumberStyle = null;
+    protected $sourceMap = SourceMap::NONE;
 
     protected $formatter = 'Leafo\ScssPhp\Formatter\Nested';
 
@@ -3089,6 +3091,18 @@ public function setLineNumberStyle($lineNumberStyle)
         $this->lineNumberStyle = $lineNumberStyle;
     }
 
+    /**
+     * Set source map
+     *
+     * @api
+     *
+     * @param string $sourceMap
+     */
+    public function setSourceMap($sourceMap)
+    {
+        $this->sourceMap = $sourceMap;
+    }
+
     /**
      * Register function
      *

src/SourceMap.php

@@ -0,0 +1,25 @@
+<?php
+/**
+ * SCSSPHP
+ *
+ * @copyright 2012-2015 Leaf Corcoran
+ *
+ * @license http://opensource.org/licenses/MIT MIT
+ *
+ * @link http://leafo.github.io/scssphp
+ */
+
+namespace Leafo\ScssPhp;
+
+/**
+ * SCSSPHP source map
+ *
+ * @author Anthon Pang <anthon.pang@gmail.com>
+ */
+class SourceMap
+{
+    const AUTO = 'auto';     // relative URI's where possible
+    const FILE = 'file';     // file: URIs 
+    const INLINE = 'inline'; // include full source text in the source map
+    const NONE = 'none';     // default
+}