npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

grunt-strip-code

v1.0.12

Published

Remove dev and test only code in production builds

Downloads

24,849

Readme

grunt-strip-code

The grunt-strip-code plugin is used to remove sections of code from production builds that are only needed in development and test environments. grunt-strip-code uses start and end comments to identify the code sections to strip out. For example:

/* test-code */
removeMeInProduction();
/* end-test-code */

doNotRemoveMe();

A use-case for this practice is to make private JavaScript functions accessible to unit tests without exposing them in production builds. This blog post goes into more detail about the concept and implementation.

Stats

Travis CI

| Branch | CI | Tests | | :------------ |:--------------- | :--------------- | | master | Build Status | Coverage Status | | develop | Build Status | Coverage Status |

AppVeyor

| Branch | CI | | :------------ |:--------------- | | master | Build Status | | develop | Build Status |

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-strip-code --save-dev

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

grunt.loadNpmTasks('grunt-strip-code');

The "strip_code" task

Overview

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

grunt.initConfig({
  strip_code: {
    options: {
      // Task-specific options go here.
    },
    your_target: {
      // Target-specific file lists and/or options go here.
    },
  },
})

Options

options.blocks

Type: Array Default value:

blocks: [
    {
        start_block: "/* test-code */",
        end_block: "/* end-test-code */"
    }
]

The blocks array contains one or more objects which define the boundaries of the text blocks to be deleted.

options.blocks.start_block

Type: String Default value: /* test-code */

The text of the opening comment used to identify code to strip.

options.blocks.end_block

Type: String Default value: /* end-test-code */

The text of the closing comment used to identify code to strip.

options.patterns

Type: array Default value: []

You can also supply your own RegExps to match against.

options.parityCheck

Type: boolean Default value: false

Turns on check that makes sure if you blocks have same amount of start/end pairs in your code.

options.intersectionCheck

Type: boolean Default value: false

Turns on check that makes sure if you blocks does not intersect between each other.

options.eol

Type: String Choices: 'lf', 'cr', 'crlf' Default value: ''

Unless one of the choices is explicitly specified, end-of-line defaults to the operating system specific character(s).

Usage Examples

The following source code exposes the bar function to the public API for testing, but the bar function should not be accessible in the released library. grunt-strip-code (with the default options) will remove the comment blocks from the example below keeping the bar function private in production:

(function() {

  function bar() {
    doSomething();
  }

  var api = {
    foo: function() {
      bar();
      return "foo";
    }
  }

  /* test-code */
  api._bar = bar;
  /* end-test-code */

  return api;
}());

Specifying different start and end comment values

The following configuration will strip out code that begins with the /* start-test-block */ comment and ends with the /* end-test-block */ comment, and code that begins with the <!-- start-html-test-code --> comment and ends with the <!-- end-html-test-code --> comment from all .js files in the dist/ folder.

grunt.initConfig({
  strip_code: {
    options: {
      blocks: [
        {
          start_block: "/* start-test-block */",
          end_block: "/* end-test-block */"
        },
        {
          start_block: "<!-- start-html-test-code -->",
          end_block: "<!-- end-html-test-code -->"
        }
      ]
    },
    your_target: {
        src: 'dist/*.js'
    }
  },
})

Using your own patterns

The following configuration will remove log() statements from all .js files in the dist/ folder

grunt.initConfig({
  strip_code: {
    options: {
      patterns: /log\(\)/g
    },
    your_target: {
        src: 'dist/*.js'
    }
  },
})

The patterns property can also take arrays of RegExp objects.

grunt.initConfig({
  strip_code: {
    options: {
      patterns: [/log\(\)/g, / *console\.log\([\w\S ]+\);?\n?/g]
    },
    your_target: {
        src: 'dist/*.js'
    }
  },
})

Specifying source and destination.

The normal behavior is to strip out code in the source files and then save those files with the same name. If you need to save them to a different name, you can specify a dest option as well.

grunt.initConfig({
  strip_code: {
    options: { },
    your_target: {
      files: [
        {src: 'tmp/my-app.js', dest: 'dist/my-app.js'},
        {src: 'tmp/my-lib.js', dest: 'dist/my-lib.js'}
      ]
    }
  },
})

Specifying Multiple strip_code Tasks.

grunt.initConfig({
  strip_code: {
    strip_html_and_js_: {
      options: {
        blocks: [{
          start_block: "/* start-test-block */",
          end_block: "/* end-test-block */"
        }, {
          start_block: "<!-- start-html-test-code -->",
          end_block: "<!-- end-html-test-code -->"
        }]
      },
      src: 'src/*.html'

    },
    strip_php: {
      options: {
        blocks: [{
          start_block: "/* start-test-block */",
          end_block: "/* end-test-block */"
        }]
      },
      src: ['src/file1.php', 'src/file2.php']
    },
    strip_log_: {
      options: {
        patterns: /log\(\)/g
      },
      files: [{
        src: 'src/src-test.js',
        dest: 'dest/src-test.js'
      }, {
        src: 'src/src-test2.js',
        dest: 'dest/src-test2.js'
      }]

    }
  },
})

Backward Compatibility with Version 0.1.2

Specifying different start and end comment values

The following configuration will strip out code that begins with the /* start-test-block */ comment and ends with the /* end-test-block */ comment from all .js files in the dist/ folder.

grunt.initConfig({
  strip_code: {
    options: {
      start_comment: 'start-test-block',
      end_comment: 'end-test-block',
    },
    your_target: {
        src: 'dist/*.js'
    }
  },
})

Using your own pattern

Note: if legacy pattern is declared, it will supercede legacy start_comment and end_comment.

The following configuration will remove log() statements from all .js files in the dist/ folder

grunt.initConfig({
  strip_code: {
    options: {
      pattern: /log\(\)/g
    },
    your_target: {
        src: 'dist/*.js'
    }
  },
})

Contributing

In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code using Grunt.

Release History

1.0.12

  • Updated grunt and ejs dependencies.

1.0.10 - 1.0.11

  • Updated security dev dependencies.
  • Updated travis-ci badges
  • Updated Read Me

1.0.9

  • Fixed Coveralls dependency error for test coverage report
  • Updated Read Me

1.0.8

  • Write to disk only if the file contents were changed, or if the file destination is different from the source.
  • Updated Read Me

1.0.7

  • Upgraded to travis-ci.com
  • Log only number of changed files, you have to use grunt verbose (--verbose, -v) to get verbose logs.

1.0.6

  • Added Windows tests on AppVeyor.
  • Removed custom line endings.

1.0.5

Custom line endings contributed.

1.0.4

Added Coveralls.

1.0.1 - 1.0.3

Documentation changes.

1.0.0

  • Added options.blocks to take arrays of different start and end capture blocks.
  • Added flag for intersectionCheck.
  • Added flag for parityCheck.
  • Major updates to package.json.
  • Added Travis CI
  • Added backward compatibility.

0.1.2

  • Minor updates to package.json.

0.1.1

  • Fix a bug so it only overwrites a file is there was stripped code.

0.1.0

  • Initial Release