grunt-replacer

Replace strings in files

npm install grunt-replacer
1 downloads in the last day
7 downloads in the last week
26 downloads in the last month

grunt-replacer Build Status

Grunt replacer - replace string in files

Getting Started

This plugin requires Grunt ~0.4.0

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-replacer --save-dev

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

grunt.loadNpmTasks('grunt-replacer');

This plugin was designed to work with Grunt 0.4.x. If you're still using grunt v0.3.x it's strongly recommended that you upgrade, but in case you can't please use v0.3.2.

Replacer Task

Run this task with the grunt replacer command.

Task targets, files and options may be specified according to the grunt Configuring tasks guide.

Options

variables

Type: replace

This option is used to define code which has to be replaced by other one.

options : {
    replace: {
        '<!-- to-replace -->'  : 'was replaced',
        'something to replace' : 'was replaced on this',
        '<!-- build-version -->: 'ver 0.1.0'
    }
}

Type: reportError

This option is used to trow error to grunt log. Default is "false"

options : {
    reportError: true
}

Usage Examples

Replace string in file

replacer: {
    index: {
        options : {
            replace: {
                '<!-- to-replace -->' : 'was replaced'
            }
        },
        files : [
            {src: ['path/to/file'], dest: 'path/to/output.file'}
        ]
    }
}

Replace string in file using function response

function(content) { return 'text'; } // @param string - content of replacing file
replacer: {
    index: {
        options : {
            replace: {
                '<!-- to-replace -->' : function(content) {
                    return 'was replaced';
                }
            }
        },
        files : [
            {src: ['path/to/file'], dest: 'path/to/output.file'}
        ]
    }
}

Release History

  • 2013-07-19 v0.1.0 First version of replacer. Replace string in selected files
  • 2013-10-20 v0.4.0 New features: colors, reportError and function as "to" param

Task submitted by Tomasz Czechowski

This file was generated on Fri July 19 2013 12:40:00.

npm loves you