.eslintrc.json

@@ -0,0 +1,23 @@
+{
+  "extends": ["eslint:recommended", "webpack", "prettier"],
+  "plugins": ["prettier"],
+  "parserOptions": {
+    "ecmaVersion": 2019,
+    "sourceType": "script"
+  },
+  "env": {
+    "node": true
+  },
+  "rules": {
+    "prettier/prettier": "error",
+    "no-plusplus": "off",
+    "global-require": "off",
+    "class-methods-use-this": "off",
+    "no-param-reassign": "off",
+    "no-underscore-dangle": "off",
+    "no-undefined": "off"
+  },
+  "overrides": [
+    { "files": "**/*.test.js", "parserOptions": { "sourceType": "module" } }
+  ]
+}

.gitignore

@@ -2,5 +2,5 @@
 coverage
 node_modules
 npm-debug.log
-tests/tmp
+tests/integration/tmp
 yarn-error.log

.prettierignore

@@ -0,0 +1 @@
+tests/fixtures/**/*

.prettierrc

@@ -0,0 +1,3 @@
+{
+  "trailingComma": "all"
+}

.travis.yml

@@ -1,26 +1,25 @@
 language: node_js
-sudo: false
 node_js:
-  - "8"
-  - "6"
-env:
-  - JOB=test
+  - "14"
+  - "12"
+  - "10"
 cache:
   yarn: true
-  directories:
-    - "node_modules"
-matrix:
-  fast_finish: true
+before_script: 'if [[ "$WEBPACK" != "default" ]]; then yarn add --dev webpack@${WEBPACK}; fi'
+script: yarn test
+env:
+  - WEBPACK=default
+  - WEBPACK=^5.0.0-0
+jobs:
   include:
-    - node_js: "lts/*"
-      env: JOB=lint
-    - node_js: "10"
-      env: JOB=test-coverage
-before_script:
-  - 'if [[ -n "$TRAVIS_TAG" ]] && [[ "$TRAVIS_JOB_NUMBER" == *.1 ]]; then yarn run create-github-release; fi'
-script:
-  - 'if [ "$JOB" = "lint" ]; then yarn run lint ; fi'
-  - 'if [ "$JOB" = "test" ]; then yarn run test-only ; fi'
-  - 'if [ "$JOB" = "test-coverage" ]; then yarn run test-coverage ; fi'
-after_success:
- - 'if [ "$JOB" = "test-coverage" ]; then bash <(curl -s https://codecov.io/bash) -f coverage/coverage-final.json ; fi'
+    - stage: codestyle
+      node_js: "lts/*"
+      script: yarn lint
+    - stage: release
+      node_js: lts/*
+      # Advanced: optionally overwrite your default `script` step to skip the tests
+      script: skip
+      deploy:
+        provider: script
+        skip_cleanup: true
+        script: yarn semantic-release

README.md

@@ -16,20 +16,14 @@
   <p>Use Webpack with Grunt.<p>
 </div>
 
-  **This is the readme for version 3.0.0. For the 1.0 readme visit [here](https://github.com/webpack-contrib/grunt-webpack/tree/1.0).**
-
 <h2 align="center">Install</h2>
 
 Install this grunt plugin next to your project's [Gruntfile.js](http://gruntjs.com/getting-started). You also need to install webpack yourself, this grunt plugin does not install webpack itself.
 
 ```bash
 yarn add webpack grunt-webpack --dev
-```
-
-You can still use npm
-
-```bash
-npm i webpack grunt-webpack --save-dev
+// or
+// npm i webpack grunt-webpack --save-dev
 ```
 
 If you also want to use the webpack-dev-server task you also need to install `webpack-dev-server`
@@ -41,15 +35,15 @@ yarn add webpack-dev-server --dev
 Then add this line to your project's `Gruntfile.js` gruntfile:
 
 ```javascript
+const webpackConfig = require('./webpack.config.js');
+
 module.exports = function(grunt) {
 
   // Project configuration.
-  grunt.initConfig({ 
+  grunt.initConfig({
     ...,
     webpack: {
-      myConfig: {
-        // your webpack config
-      },
+      myConfig: webpackConfig,
     },
     ...
   });
@@ -123,11 +117,13 @@ The webpack-dev-server options [`host`][5], [`hotOnly`][6], [`inline`][1], [`por
 
 ### Webpack
 
+#### imported config
+
 This is a simple example that requires the webpack config from the config file.
 It also disables stats in non 'development' environments and enables watch in development.
 
 ``` javascript
-const webpackConfig = require('./webpack.config');
+const webpackConfig = require('./webpack.config.js');
 
 module.exports = function(grunt) {
   grunt.initConfig({
@@ -161,25 +157,107 @@ On the command line you can then do the following.
 
 > For more examples and information have a look at the [webpack documentation][9] which mostly also applies here besides the noted differences above.
 
+#### Lazy config loading
+
+In some cases you might want to load the webpack config lazy. This can be done by specifying a function as the config value. The first paramter to this function will be the complete grunt config, which can be used in cases where grunt templates do not work (see below).
+
+```js
+const webpackConfig = require('./webpack.config.js');
+
+module.exports = function(grunt) {
+  grunt.initConfig({
+    webpack: {
+      myconfig: () => ({
+        entry: path.join(__dirname, "entry"),
+        output: {
+          path: __dirname,
+          filename: "output.js",
+        },
+      }),
+    },
+  });
+
+  grunt.loadNpmTasks('grunt-webpack');
+};
+```
+
+#### Grunt templates
+
+grunt-webpack supports grunt templates in all string values in it's configuration.
+
+In the next example we use a template for `output.filename`.
+
+```js
+const webpackConfig = require('./webpack.config.js');
+
+module.exports = function(grunt) {
+  grunt.initConfig({
+    outputFileName: "output.js",
+    webpack: {
+      myconfig: {
+        entry: path.join(__dirname, "entry"),
+        output: {
+          path: __dirname,
+          filename: "<%= outputFileName %>",
+        },
+      },
+    },
+  });
+
+  grunt.loadNpmTasks('grunt-webpack');
+};
+```
+
+For plugins we cannot support grunt template interpolation, as plugins are class instances which we cannot modify during runtime without breaking them. If you need to use template in a string option to a plugin, you can use lazy config loading and use the supplied config. You can also use grunt inside directly to access utility methods:
+
+```js
+const webpackConfig = require('./webpack.config.js');
+
+module.exports = function(grunt) {
+  grunt.initConfig({
+    name: "Webpack",
+    pkg: {
+      copyright: '<%= name %>',
+      version: '6.55.345',
+    },
+    webpack: {
+      myconfig: (config) => ({
+        entry: path.join(__dirname, "entry"),
+        output: {
+          path: __dirname,
+          filename: "output.js",
+        },
+        plugins: [
+          new webpack.BannerPlugin({
+            banner: `/*! ${config.pkg.copyright} - Version ${config.pkg.version} dated ${grunt.template.today()} */`,
+            raw: true,
+          }),
+        ],
+      }),
+    },
+  });
+
+  grunt.loadNpmTasks('grunt-webpack');
+};
+```
+
 <h2 align="center">Troubleshooting</h2>
 
 ### Circular reference detected (.plugins)
 
 If you encounter this message it means that one of the plugins which are present in your config have circular references.
-This is totally fine for webpack, but sadly grunt cannot handle these.
+This is not a bug in the plugin and is totally fine for webpack, but sadly grunt cannot handle these.
 
 To workaround this problem use lazy config loading, by wrapping your config inside a function.
 
 ```js
+const webpackConfig = require('./webpack.config.js');
+
 module.exports = function(grunt) {
   grunt.initConfig({
     webpack: {
-      myconfig: function() {
-        return {
-          plugins: [...]
-        };
-      }
-    }
+      myconfig: () => webpackConfig,
+    },
   });
 
   grunt.loadNpmTasks('grunt-webpack');

babel.config.js

@@ -0,0 +1,5 @@
+"use strict";
+
+module.exports = {
+  presets: [['@babel/env', { targets: { node: "current" } }]],
+};

package.json

@@ -14,59 +14,49 @@
     "url": "https://github.com/webpack-contrib/grunt-webpack/issues"
   },
   "engines": {
-    "node": ">=4"
+    "node": ">=10.13.0"
   },
   "files": [
     "src",
     "tasks"
   ],
   "peerDependencies": {
-    "webpack": "^2.0.0 || ^3.0.0 || ^4.0.0"
+    "webpack": "^4.0.0"
   },
   "license": "MIT",
   "keywords": [
     "gruntplugin"
   ],
   "scripts": {
-    "create-github-release": "conventional-github-releaser -p angular",
     "lint": "eslint src tasks",
     "prebump": "yarn test",
-    "release": "standard-version --sign",
-    "test": "yarn run lint && yarn run test-only",
-    "test-coverage": "nyc --reporter=json --reporter=text yarn run test-only",
-    "test-only": "ava"
+    "test": "jest"
   },
   "devDependencies": {
-    "ava": "^0.25.0",
-    "babel-core": "^6.17.0",
-    "babel-loader": "^7.0.0",
-    "babel-preset-env": "^1.6.0",
-    "conventional-github-releaser": "^3.1.2",
-    "eslint": "^4.2.0",
-    "fs-extra": "^6.0.1",
-    "glob": "^7.1.3",
-    "grunt": "^1.0.3",
-    "nyc": "^11.0.3",
-    "standard-version": "^4.4.0",
+    "@babel/core": "^7.10.5",
+    "@babel/preset-env": "^7.10.4",
+    "babel-loader": "^8.1.0",
+    "eslint": "^7.5.0",
+    "eslint-config-prettier": "^6.11.0",
+    "eslint-config-webpack": "^1.2.5",
+    "eslint-plugin-import": "^2.22.0",
+    "eslint-plugin-prettier": "^3.1.4",
+    "fast-glob": "^3.2.4",
+    "fs-extra": "^9.0.1",
+    "grunt": "^1.2.1",
+    "jest": "^26.1.0",
+    "prettier": "^2.0.5",
+    "semantic-release": "^17.1.1",
     "webpack": "^4.17.1"
   },
   "dependencies": {
-    "deep-for-each": "^2.0.2",
-    "lodash": "^4.7.0"
+    "deep-for-each": "^3.0.0",
+    "lodash": "^4.17.19"
   },
-  "ava": {
-    "files": [
-      "**/tests/**/*.js",
-      "!**/utils/**/*",
-      "!**/fixtures/**/*",
-      "!**/tmp/**/*"
-    ]
-  },
-  "nyc": {
-    "all": true,
-    "include": [
-      "src/",
-      "tasks/"
+  "jest": {
+    "collectCoverageFrom": [
+      "src/**/*.js",
+      "tasks/**/*.js"
     ]
   }
 }