Pug 3.0.0

[ForbesLindesay]

I'm intending to publish pug 3.0.0 within the next 24 hours. In the mean time, it would be great if as many people as possible could try out the "canary" build. You can get it by running npm install pug@canary.

I've automated the release process via Rolling Versions so it will now always be possible to install the version currently on the master branch via pug@canary, and new production-ready releases should be much more frequent.

The provisional release notes for pug@3.0.0 are as follows:

Breaking Changes

• The minify option on filters now requires you to install the relevant jstransformer (suport minify option in filter using jstransformer #3084)

  Currently we support:

  • jstransformer-uglify-js for JavaScript
  • jstransformer-clean-css for CSS

• read plugins must now return Buffer if you want to support filters that use renderBuffer (Allow filters to read non-text include files #3213)

  If you don't wish to support this advanced use case, you can continue returning string. If you did not provide a read plugin, you do not need to do anything.

• Drop support for node 6 and 8 (chore: remove lerna as yarn supports enough stuff now #3243)

Features

• Add support for replacing code gen via a plugin with generateCode (Add the possibility of replacing generateCode function #3230)

• Support each ... of ... loops (Adding 'each .. of' syntax #3179)

  each value of iterable
    li= value

  This requires an environment that supports the for (const val of iterable) syntax in JS. You can iterate over Maps, Sets etc. as well as arrays. There is also some destructuring of map keys:

  - const map = new Map([['a', 'x'], ['b', 'y']]);
  each [key, value] of map
    li
      strong= key
      = value

• Support filters that apply to Buffers (Allow filters to read non-text include files #3213)

  e.g.

  // options.js
  exports.filters = {
    png: {
      // instead of a function, specify an object with a "renderBuffer" property
      // whose value is a function that takes a Buffer instead of a string
      renderBuffer: function(buffer, options) {
        var data = Buffer.from(buffer).toString('base64');
        return '<img src="data:image/png;base64, ' + data + '"/>';
      }
    }
  };

  You can then use the filter like:

  // foo.pug
  include:png my-small-image.png

[ForbesLindesay]

Here's the official release: https://github.com/pugjs/pug/releases/tag/pug%403.0.0

[zackschuster]

@ForbesLindesay my node_modules deploys went from 6.8mb to 4.0mb entirely due to the changes for v3. thank you so much!!