feat(tasks): add copy feature

Author: jpatovh

docs/features/copy.md

@@ -0,0 +1,24 @@
+Copy any files to a destination folder (usefull for node_modules vendoring).
+
+## Usage
+
+You simply put the files (input) that you want to copy to output (dist).
+```yml
+copy:
+  enabled: true
+  files:
+    - src: "node_modules/lodash/dist/lodash.js"
+      dest: "dist/vendors/"
+    - src: "node_modules/underscore/dist/*.js"
+      dest: "dist/vendors/"
+      concat: true                  # (optional) enable concat
+      destName: "underscore.js"     # (optional) concatened file name
+    [...]
+```
+
+## Commands
+
+- `gulp copy` - Launch copy task
+- `gulp watch:copy` - Watch and copy
+
+---

docs/features/js.md

@@ -1,7 +1,7 @@
 Compiles JS files using Babel. You can optionaly concat, uglify, and add sourcemaps.
 
 !!! note ""
-    We recommand to use [webpack](features/webpack.md) instead.
+    We recommand to use [webpack](features/webpack.md) for big SPA.
 
 ## Commands
 

gulpfile.default.yml

@@ -168,3 +168,10 @@ drupal:
     - templates/**
   command: drush cr
   dir: './'
+copy:
+  enabled: false
+  # files:
+  #   - src: "node_modules/lodash/dist/*.js"
+  #     dest: "dist/"
+  #     concat: true
+  #     destName: "lodash.js"

index.js

@@ -39,6 +39,10 @@ module.exports = (gulp, userConfig, tasks) => {
     require('./lib/webpack')(gulp, config, tasks);
   }
 
+  if (config.copy.enabled) {
+    require('./lib/copy')(gulp, config, tasks);
+  }
+
   /* eslint-enable global-require */
 
   // This is a fix fo Gulp, because series and paparallel needs at least one task

lib/copy.js

@@ -0,0 +1,28 @@
+'use strict';
+
+const concat = require('gulp-concat');
+const gulpif = require('gulp-if');
+
+module.exports = (gulp, config, tasks) => {
+  function copyCurrentFiles(files) {
+    return gulp.src(files.src)
+      .pipe(gulpif(files.concat, concat(files.destName || 'undefined.js')))
+      .pipe(gulp.dest(files.dest));
+  }
+
+  copyCurrentFiles.description = 'Copies multiple files into a given destination (and optionally concat them).';
+
+  gulp.task('copy', gulp.parallel(config.copy.files.map(files => function copyFiles() {
+    return copyCurrentFiles(files);
+  })));
+
+  gulp.task('watch:copy', gulp.parallel(config.copy.files.map(files => function watchCopyFiles() {
+    return gulp.watch(files.src, gulp.series(function copyFiles() {
+      return copyCurrentFiles(files);
+    }));
+  })));
+
+  tasks.compile.push('copy');
+  tasks.watch.push('watch:copy');
+};
+

mkdocs.yml

@@ -11,6 +11,7 @@ pages:
     - Icons: features/icons.md
     - Drupal-Drush: features/drupal-drush.md
     - Browsersync: features/browser-sync.md
+    - Copy: features/copy.md
   - Troubleshooting: troubleshooting.md
 
 markdown_extensions:

package.json

@@ -39,6 +39,7 @@
     "gulp-babel": "^7.0.1",
     "gulp-cached": "^1.1.1",
     "gulp-concat": "^2.6.1",
+    "gulp-copy": "^1.1.0",
     "gulp-csscombx": "^4.2.1",
     "gulp-eslint": "^4.0.2",
     "gulp-flatten": "^0.4.0",