grunt-contrib-compress

grunt-contrib-compress

Compress files and folders (part of the grunt-contrib collection). Submitted by Chris Talkington.

Getting Started

Install this grunt plugin next to your project's grunt.js gruntfile with: npm install grunt-contrib-clean

Then add this line to your project's grunt.js gruntfile:

grunt.loadNpmTasks('grunt-contrib-compress');

Overview

Inside your grunt.js file, add a section named compress. This section specifies the files to compress and the options passed to either zipstream (for zip) or tar (for tar/tgz) or zlib (for gzip).

Parameters

files object

This defines what files this task will compress and should contain key:value pairs.

The key (destination) should be an unique filepath (supports grunt.template) and the value (source) should be a filepath or an array of filepaths (supports minimatch).

options object

This controls how this task operates and should contain key:value pairs, see options below.

Options

mode string

This is used to define which mode to use, currently supports gzip, tar, tgz (tar gzip) and zip.

basePath string

This option adjusts internal filenames to be relative to provided path, within the resulting archive file.

flatten boolean

This option performs a flat copy that dumps all the files into the root of the destination file, overwriting files if they exist.

level integer (zip only)

This option sets the level of archive compression (defaults to 1).

Currently, gzip compression related options are not supported due to deficiencies in node's zlib library.

Config Example

compress: {
  zip: {
    options: {
      mode: "zip",
      basePath: "path/to",
      level: 1
    },
    files: {
      "path/to/result.zip": "path/to/source/*", // includes files in dir
      "path/to/another.gz": "path/to/source/**", // includes files in dir and subdirs
      "path/to/final.zip": ["path/to/sources/*.js", "path/to/more/*.js"], // include JS files in two diff dirs
      "path/to/project-<%= pkg.version %>.zip": "path/to/source/**" // variables in destination
    }
  }

  tar: {
    options: {
      mode: "tar",
      basePath: "path/to"
    },
    files: {
      "path/to/result.tar": "path/to/file.ext"
    }
  },

  tgz: {
    options: {
      mode: "tgz",
      basePath: "path/to"
    },
    files: {
      "path/to/result.tgz": "path/to/file.ext"
    }
  },

  gzip: {
    options: {
      mode: "gzip"
    },
    files: {
      "path/to/result.gz": "path/to/file.ext"
    }
  }
}