grunt-version-copy-bower-components

This plugin copies Bower components into a staging directory with the component's versions appended to the directory name. It will also fix references to the components in HTML or other specified files. This aids in creating releases so caching layers will not serve stale libraries when there are updates and so that caches don't need to be updated with every deploy when the library version hasn't changed.

Getting Started

This plugin requires Grunt ~0.4.4

If you haven't used Grunt before, be sure to check out the Getting Started guide, as it explains how to create a Gruntfile as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:

npm install grunt-version-copy-bower-components --save-dev

Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:

grunt.loadNpmTasks('grunt-version-copy-bower-components');

This plugin may not work with every bower component. Many of the popular ones have been tested, but if the components packaging is not standard there could be problems.

The "versionCopyBowerComponents" task

Overview

In your project's Gruntfile, add a section named versionCopyBowerComponents to the data object passed into grunt.initConfig().

grunt.initConfig({
  versionCopyBowerComponents: {
    options: {
      // Task-specific options go here.
    }
  }
});

Options

options.dest

Type: String Default value: dist/libs

The location to place the versioned bower components.

options.exclude

Type: Array Default value: []

Bower libraries that you don't want versioned and copied to the destination.

options.filesReferencingComponents.files

Type: Array Default value: []

An array of files that have references to bower components. For example if you have installed bootstrap with bower and your html file is like:

<!DOCTYPE html>
<html>
<head>
  <meta charset="utf-8">
  <title>Test Page</title>
  <link rel="stylesheet" href="bower_components/bootstrap/dist/css/bootstrap.css">
  <script src="bower_components/bootstrap/dist/js/bootstrap.js">
</head>
<body>
</body>
</html>

you would list this file in the files array so that it is updated with the new bootstrap locations post versioning. All files that reference bower components should be listed here.

options.filesReferencingComponents.useComponentMin

Type: Boolean Default value: false

Change references to bower component in files to use the .min in the filename if it exists.

Example Options

grunt.initConfig({
  versionCopyBowerComponents: {
    options: {
      exclude: ['underscore'],
      dest: 'dist/libs',
      filesReferencingComponents: {
        files: ['dist/test.html', 'dist/test.css'],
        useComponentMin: true
      }
    }
  }
});

With these options all of the bower components except for underscore will be versioned and copied to 'dist/libs'.

The files 'dist/test.html' and 'dist/test.css' will be modified with the correct paths to the bower components ('lib/component-version') and will use min in the file name if a minified resource exists.

alexbartsch / grunt-version-copy-bower-components Goto Github PK