rollup-plugin-license

Rollup plugin that can be used to:

• Prepend a banner from a file.
• Create a file containing all third-parties used in the bundle (and display the license of each dependency).

How to use

Install the plugin with NPM:

npm install --save-dev rollup-plugin-license

Then add it to your rollup configuration:

const path = require('path');
const license = require('rollup-plugin-license');

module.exports = {
  plugins: [
    license({
      sourcemap: true,
      cwd: '.', // Default is process.cwd()

      banner: {
        commentStyle: 'regular', // The default

        content: {
          file: path.join(__dirname, 'LICENSE'),
          encoding: 'utf-8', // Default is utf-8
        },

        // Optional, may be an object or a function returning an object.
        data() {
          return {
            foo: 'foo',
          };
        },
      },

      thirdParty: {
        output: path.join(__dirname, 'dist', 'dependencies.txt'),
        includePrivate: true, // Default is false.
        encoding: 'utf-8', // Default is utf-8.
      },
    }),
  ],
}

Banner

Banner file

The banner file can be a text file and it will be converted to a block comment automatically if needed.

Note that the content will be translated to a lodash template with the following data model:

• pkg: The content of the project package.json.
• dependencies: An array of all the dependencies included in the bundle.
• moment: The moment object.
• _: The lodash object.
• data A custom data object, defined in banner options.

Here is a valid banner:

Bundle of <%= pkg.name %>
Generated: <%= moment().format('YYYY-MM-DD') %>
Version: <%= pkg.version %>
Dependencies:
<% _.forEach(dependencies, function (dependency) { %>
  <%= dependency.name %> -- <%= dependency.version %>
<% }) %>

Comment style

Since version 0.10.0, it is possible to customize banner style using the commentStyle option:

license({
  banner: {
    commentStyle: 'regular', // The default
    content: {
      file: path.join(__dirname, 'LICENSE'),
    },
  },
})

Following options are available:

• regular: "classic" comment block is used (this is the default), for example:

/**
 * This is the `regular` style.
 */

• ignored: a comment block with prefix ignored by minifiers, for example:

/*!
 * This is the `ignored` style.
 */

• slash: banner is prepended using "slash" comments, for example:

//
// This is the `slash` style.
//

• none: nothing done, be careful to prepenbd a banner already "commented".

Banner as a "simple" string

Since version 0.3.0, banner can be a simple string that will be used directly:

const license = require('rollup-plugin-license');

module.exports = {
  plugins: [
    license({
      banner: `Copyright <%= moment().format('YYYY') %>`,
    }),
  ],
}

If you want to add some options to banner (such as the comment style to use), and still define it as a string (insead of pointing to a file), you can also define the banner like this (since version 0.11.0):

const license = require('rollup-plugin-license');

module.exports = {
  plugins: [
    license({
      banner: {
        content: `Copyright <%= moment().format('YYYY') %>`,
        commentStyle: 'ignored',
      },
    }),
  ],
}

Deprecated format

Until version 0.10.0, banner file was defined as:

const path = require('path');
const license = require('rollup-plugin-license');

module.exports = {
  plugins: [
    license({
      banner: {
        file: path.join(__dirname, 'LICENSE'),
        encoding: 'utf-8',
      },
    }),
  ],
};

This format has been deprecated with version 0.11.0 (still works but will be removed in a future version), and the banner file should be defined inside banner.content entry:

const path = require('path');
const license = require('rollup-plugin-license');

module.exports = {
  plugins: [
    license({
      banner: {
        content: {
          file: path.join(__dirname, 'LICENSE'),
          encoding: 'utf-8',
        },
      },
    }),
  ],
};

Dependencies output

A file containing a summary of all dependencies can be generated automatically using the following options:

license({
  thirdParty: {
    output: path.join(__dirname, 'dist', 'dependencies.txt'),
    includePrivate: true, // Default is false.
  },
})

Changelogs

• 0.11.0
  • Fail if the banner file does not exist (breaking change).
  • Deprecate banner.file / banner.encoding entries, use banner.content.file / banner.content.encoding instead (see #428).
  • Allow comment style to be defined with a "string" banner (see #308 and #428).
  • Dev dependencies updates.
• 0.10.0
  • Support different comment style for banner (see #308).
  • Do not include tree shaken dependencies (see #380)
  • Various dependency updates.
• 0.9.0
  • Fix for NULL character (see #1).
  • Various dependency updates.
• 0.8.1
  • Add rollup as a peer dependency.
• 0.8.0
  • Deprecate sourceMap option (use sourcemap option in lowercase) to keep it consistent with rollup.
  • Fix deprecate call with rollup >= 1, keep compatibility with legacy versions of rollup.
  • Upgrade dependencies.
• 0.7.0
  • Add a way to specify custom data object when rendering banner.
  • Add cwd option to specify custom working directory (optional option).
  • Upgrade dependencies.
• 0.6.0
  • Upgrade commenting dependency.
• 0.5.0
  • Feat: Sourcemap is now enable by default to ensure compatibility with other rollup plugins.
  • Fix: Add compatibility with rollup >= 0.48.0 (the new sourcemap option).
  • Fix: Ensure plugin sourcemp is used instead of the "global" one in rollup options.
  • Chore: dependency updates.
• 0.4.0
  • Dependency update (moment).
  • Dependency update (magic-string).
• 0.3.0
  • Add encoding option for banner and third-party output file.
  • Banner can be a simple string.

License

MIT License (MIT)

Contributing

If you find a bug or think about enhancement, feel free to contribute and submit an issue or a pull request.