README updated

Author: kottenator

README.md

@@ -45,12 +45,6 @@ COMPRESS_PRECOMPILERS = (
 {% endcompress %}
 ```
 
-```scss
-/* base/static/base/variables.scss */
-
-$title-size: 30px;
-```
-
 ```scss
 /* app/static/app/layout.scss */
 
@@ -61,9 +55,15 @@ $title-size: 30px;
 }
 ```
 
+```scss
+/* base/static/base/variables.scss */
+
+$title-size: 30px;
+```
+
 #### Requisites
 
-You need `node-sass`, `postcss` and `autoprefixer` to be installed. Quick install:
+You need `node-sass`, `postcss-cli` and `autoprefixer` to be installed. Quick install:
 
 ```sh
 npm install -g node-sass postcss-cli autoprefixer
@@ -85,7 +85,6 @@ ES6 → (
 
 It also enables Django static imports in ES6, see the example below.
 
-
 #### Usage
 
 ```py
@@ -106,6 +105,15 @@ COMPRESS_PRECOMPILERS = (
 {% endcompress %}
 ```
 
+```js
+// app/static/app/scripts.js
+
+import Framework from 'base/framework';
+
+new Framework;
+new Framework('1.0.1');
+```
+
 ```js
 // base/static/base/framework.js
 
@@ -118,19 +126,61 @@ export default class {
 }
 ```
 
-```js
-// app/static/app/scripts.js
+#### Requisites
 
-import Framework from 'base/framework';
+You need `browserify`, `babelify` and `babel-preset-es2015` to be installed. Quick install:
 
-new Framework;
-new Framework('1.0.1');
+```sh
+npm install -g browserify babelify babel-preset-es2015
 ```
 
-#### Requisites
+## Django settings
 
-You need `browserify`, `babelify` and `babel-preset-es2015` to be installed. Quick install:
+### COMPRESS_NODE_MODULES
+
+Path to `node_modules` where `browserify`, `babelify`, `autoprefixer`, etc, are installed.
+
+Default: `/usr/lib/node_modules`
+
+### COMPRESS_SCSS_COMPILER_CMD
+
+Command that will be executed to transform SCSS into CSS code.
+
+Default:
 
 ```sh
-npm install -g browserify babelify babel-preset-es2015
+node-sass --output-style expanded {paths} "{infile}" "{outfile}" &&
+postcss --use "{node_modules}/autoprefixer" --autoprefixer.browsers "{autoprefixer_browsers}" -r "{outfile}"'
+```
+
+Placeholders:
+- `{infile}` - input file path
+- `{outfile}` - output file path
+- `{paths}` - specially for `node-sass`, include all Django app static folders:
+  `--include-path=/path/to/app-1/static/ --include-path=/path/to/app-2/static/ ...`
+- `{node_modules}` - see `COMPRESS_NODE_MODULES` setting
+- `{autoprefixer_browsers}` - see `COMPRESS_AUTOPREFIXER_BROWSERS` setting
+
+### COMPRESS_AUTOPREFIXER_BROWSERS
+
+Browser versions config for Autoprefixer.
+
+Default: `ie >= 9, > 5%`
+
+### COMPRESS_ES6_COMPILER_CMD
+
+Command that will be executed to transform ES6 into ES5 code.
+
+Default:
+
+```sh
+export NODE_PATH="{paths}" && browserify "{infile}" -o "{outfile}" --no-bundle-external --node
+-t [ "{node_modules}/babelify" --presets="{node_modules}/babel-preset-es2015" ]
 ```
+
+Placeholders:
+- `{infile}` - input file path
+- `{outfile}` - output file path
+- `{paths}` - specially for `browserify`, include all Django app static folders:
+  `/path/to/app-1/static/:/path/to/app-2/static/:...` (like `PATH` variable)
+- `{node_modules}` - see `COMPRESS_NODE_MODULES` setting

compressor_toolkit/apps.py

@@ -5,11 +5,24 @@
 class CompressorToolkitConfig(AppConfig):
     name = 'compressor_toolkit'
 
+    # Path to 'node_modules' where browserify, babelify, autoprefixer, etc, are installed
+    NODE_MODULES = getattr(settings, 'COMPRESS_NODE_MODULES', None) or '/usr/lib/node_modules'
+
     # Custom SCSS transpiler command
-    SCSS_COMPILER_CMD = getattr(settings, 'COMPRESS_SCSS_COMPILER_CMD', None)
+    SCSS_COMPILER_CMD = getattr(settings, 'COMPRESS_SCSS_COMPILER_CMD', None) or (
+        'node-sass --output-style expanded {paths} "{infile}" "{outfile}" && '
+        'postcss --use "{node_modules}/autoprefixer" '
+        '--autoprefixer.browsers "{autoprefixer_browsers}" -r "{outfile}"'
+    )
 
-    # Custom ES6 transpiler command
-    ES6_COMPILER_CMD = getattr(settings, 'COMPRESS_ES6_COMPILER_CMD', None)
+    # Browser versions config for Autoprefixer
+    AUTOPREFIXER_BROWSERS = getattr(settings, 'COMPRESS_AUTOPREFIXER_BROWSERS', None) or (
+        'ie >= 9, > 5%'
+    )
 
-    # Path to 'node_modules' where browserify, babelify, autoprefixer, etc, are installed
-    NODE_MODULES = getattr(settings, 'COMPRESS_NODE_MODULES', None) or '/usr/lib/node_modules'
+    # Custom ES6 transpiler command
+    ES6_COMPILER_CMD = getattr(settings, 'COMPRESS_ES6_COMPILER_CMD', None) or (
+        'export NODE_PATH="{paths}" && '
+        'browserify "{infile}" -o "{outfile}" --no-bundle-external --node '
+        '-t [ "{node_modules}/babelify" --presets="{node_modules}/babel-preset-es2015" ]'
+    )

compressor_toolkit/precompilers.py

@@ -75,14 +75,11 @@ class SCSSCompiler(BaseCompiler):
             font-size: $title-font-size;
         }
     """
-    command = app_config.SCSS_COMPILER_CMD or (
-        'node-sass --output-style expanded {paths} {infile} {outfile} && '
-        'postcss --use {node_modules}/autoprefixer '
-        '--autoprefixer.browsers "ie >= 9, > 5%" -r {outfile}'
-    )
+    command = app_config.SCSS_COMPILER_CMD
     options = (
         ('paths', ' '.join(['--include-path {}'.format(s) for s in get_all_static()])),
         ('node_modules', app_config.NODE_MODULES),
+        ('autoprefixer_browsers', app_config.AUTOPREFIXER_BROWSERS),
     )
     infile_ext = '.scss'
 
@@ -104,11 +101,7 @@ class ES6Compiler(BaseCompiler):
 
         controller.registerPages(login, signup);
     """
-    command = app_config.ES6_COMPILER_CMD or (
-        'export NODE_PATH={paths} && '
-        'browserify "{infile}" -o "{outfile}" --no-bundle-external --node '
-        '-t [ {node_modules}/babelify --presets={node_modules}/babel-preset-es2015 ]'
-    )
+    command = app_config.ES6_COMPILER_CMD
     options = (
         ('paths', os.pathsep.join(get_all_static())),
         ('node_modules', app_config.NODE_MODULES)