{ "_args": [ [ { "raw": "babel-plugin-istanbul@^4.1.5", "scope": null, "escapedName": "babel-plugin-istanbul", "name": "babel-plugin-istanbul", "rawSpec": "^4.1.5", "spec": ">=4.1.5 <5.0.0", "type": "range" }, "/home/jdaugherty/work/GT2/GT2-Android/node_modules/babel-jest" ] ], "_from": "babel-plugin-istanbul@>=4.1.5 <5.0.0", "_id": "babel-plugin-istanbul@4.1.5", "_inCache": true, "_location": "/babel-plugin-istanbul", "_nodeVersion": "7.1.0", "_npmOperationalInternal": { "host": "s3://npm-registry-packages", "tmp": "tmp/babel-plugin-istanbul-4.1.5.tgz_1505578014391_0.4694260179530829" }, "_npmUser": { "name": "bcoe", "email": "ben@npmjs.com" }, "_npmVersion": "4.6.1", "_phantomChildren": {}, "_requested": { "raw": "babel-plugin-istanbul@^4.1.5", "scope": null, "escapedName": "babel-plugin-istanbul", "name": "babel-plugin-istanbul", "rawSpec": "^4.1.5", "spec": ">=4.1.5 <5.0.0", "type": "range" }, "_requiredBy": [ "/babel-jest", "/jest-runtime" ], "_resolved": "https://registry.npmjs.org/babel-plugin-istanbul/-/babel-plugin-istanbul-4.1.5.tgz", "_shasum": "6760cdd977f411d3e175bb064f2bc327d99b2b6e", "_shrinkwrap": null, "_spec": "babel-plugin-istanbul@^4.1.5", "_where": "/home/jdaugherty/work/GT2/GT2-Android/node_modules/babel-jest", "author": { "name": "Thai Pangsakulyanont @dtinth" }, "bugs": { "url": "https://github.com/istanbuljs/babel-plugin-istanbul/issues" }, "dependencies": { "find-up": "^2.1.0", "istanbul-lib-instrument": "^1.7.5", "test-exclude": "^4.1.1" }, "description": "A babel plugin that adds istanbul instrumentation to ES6 code", "devDependencies": { "babel-cli": "^6.18.0", "babel-core": "^6.24.0", "babel-preset-es2015": "^6.18.0", "babel-register": "^6.24.0", "chai": "^4.1.0", "coveralls": "^2.11.16", "cross-env": "^3.1.4", "mocha": "^3.2.0", "nyc": "^11.1.0", "pmock": "^0.2.3", "standard": "^9.0.2", "standard-version": "^4.0.0" }, "directories": {}, "dist": { "shasum": "6760cdd977f411d3e175bb064f2bc327d99b2b6e", "tarball": "https://registry.npmjs.org/babel-plugin-istanbul/-/babel-plugin-istanbul-4.1.5.tgz" }, "files": [ "lib" ], "gitHead": "34c4c726dbd72d0b944bcf816fd68be48ee02ed6", "greenkeeper": { "ignore": [ "find-up", "cross-env" ] }, "homepage": "https://github.com/istanbuljs/babel-plugin-istanbul#readme", "keywords": [ "istanbul", "babel", "plugin", "instrumentation" ], "license": "BSD-3-Clause", "main": "lib/index.js", "maintainers": [ { "name": "bcoe", "email": "ben@npmjs.com" }, { "name": "gotwarlost", "email": "kananthmail-github@yahoo.com" } ], "name": "babel-plugin-istanbul", "nyc": { "include": [ "src/*.js", "fixtures/should-cover.js" ], "require": [ "babel-register" ], "sourceMap": false, "instrument": false }, "optionalDependencies": {}, "readme": "# babel-plugin-istanbul\n\n[![Greenkeeper badge](https://badges.greenkeeper.io/istanbuljs/babel-plugin-istanbul.svg)](https://greenkeeper.io/)\n[![Build Status](https://travis-ci.org/istanbuljs/babel-plugin-istanbul.svg?branch=master)](https://travis-ci.org/istanbuljs/babel-plugin-istanbul)\n[![Coverage Status](https://coveralls.io/repos/github/istanbuljs/babel-plugin-istanbul/badge.svg?branch=master)](https://coveralls.io/github/istanbuljs/babel-plugin-istanbul?branch=master)\n[![Conventional Commits](https://img.shields.io/badge/Conventional%20Commits-1.0.0-yellow.svg)](https://conventionalcommits.org)\n[![community slack](http://devtoolscommunity.herokuapp.com/badge.svg)](http://devtoolscommunity.herokuapp.com)\n\n_Having problems? want to contribute? join our [community slack](http://devtoolscommunity.herokuapp.com)_.\n\nA Babel plugin that instruments your code with Istanbul coverage.\nIt can instantly be used with [karma-coverage](https://github.com/karma-runner/karma-coverage) and mocha on Node.js (through [nyc](https://github.com/bcoe/nyc)).\n\n__Note:__ This plugin does not generate any report or save any data to any file;\nit only adds instrumenting code to your JavaScript source code.\nTo integrate with testing tools, please see the [Integrations](#integrations) section.\n\n## Usage\n\nInstall it:\n\n```\nnpm install --save-dev babel-plugin-istanbul\n```\n\nAdd it to `.babelrc` in test mode:\n\n```js\n{\n \"env\": {\n \"test\": {\n \"plugins\": [ \"istanbul\" ]\n }\n }\n}\n```\n\nOptionally, use [cross-env](https://www.npmjs.com/package/cross-env) to set\n`NODE_ENV=test`:\n\n```json\n{\n \"scripts\": {\n \"test\": \"cross-env NODE_ENV=test nyc --reporter=lcov --reporter=text mocha test/*.js\"\n }\n}\n```\n\n## Integrations\n\n### karma\n\nIt _just works_ with Karma. First, make sure that the code is already transpiled by Babel (either using `karma-babel-preprocessor`, `karma-webpack`, or `karma-browserify`). Then, simply set up [karma-coverage](https://github.com/karma-runner/karma-coverage) according to the docs, but __don’t add the `coverage` preprocessor.__ This plugin has already instrumented your code, and Karma should pick it up automatically.\n\nIt has been tested with [bemusic/bemuse](https://codecov.io/github/bemusic/bemuse) project, which contains ~2400 statements.\n\n### mocha on node.js (through nyc)\n\nConfigure Mocha to transpile JavaScript code using Babel, then you can run your tests with [`nyc`](https://github.com/bcoe/nyc), which will collect all the coverage report.\n\nbabel-plugin-istanbul respects the `include`/`exclude` configuration options from nyc,\nbut you also need to __configure NYC not to instrument your code__ by adding these settings in your `package.json`:\n\n```js\n \"nyc\": {\n \"sourceMap\": false,\n \"instrument\": false\n },\n```\n\n## Ignoring files\n\nYou don't want to cover your test files as this will skew your coverage results. You can configure this by providing plugin options matching nyc's [`exclude`/`include` rules](https://github.com/bcoe/nyc#excluding-files):\n\n```json\n{\n \"env\": {\n \"test\": {\n \"plugins\": [\n [\"istanbul\", {\n \"exclude\": [\n \"**/*.spec.js\"\n ]\n }]\n ]\n }\n }\n}\n```\n\nIf you don't provide options in your Babel config, the plugin will look for `exclude`/`include` config under an `\"nyc\"` key in `package.json`.\n\nYou can also use [istanbul's ignore hints](https://github.com/gotwarlost/istanbul/blob/master/ignoring-code-for-coverage.md#ignoring-code-for-coverage-purposes) to specify specific lines of code to skip instrumenting.\n\n## Source Maps\n\nBy default, this plugin will pick up inline source maps and attach them to the instrumented code such that code coverage can be remapped back to the original source, even for multi-step build processes. This can be memory intensive. Set `useInlineSourceMaps` to prevent this behavior.\n\n```json\n{\n \"env\": {\n \"test\": {\n \"plugins\": [\n [\"istanbul\", {\n \"useInlineSourceMaps\": false\n }]\n ]\n }\n }\n}\n```\n\nIf you're instrumenting code programatically, you can pass a source map explicitly.\n```js\nimport babelPluginIstanbul from 'babel-plugin-istanbul';\n\nfunction instrument(sourceCode, sourceMap, fileName) {\n return babel.transform(sourceCode, {\n filename,\n plugins: [\n [babelPluginIstanbul, {\n inputSourceMap: sourceMap\n }]\n ]\n })\n}\n```\n\n## Credit where credit is due\n\nThe approach used in `babel-plugin-istanbul` was inspired by [Thai Pangsakulyanont](https://github.com/dtinth)'s original library [`babel-plugin-__coverage__`](https://github.com/dtinth/babel-plugin-__coverage__).\n", "readmeFilename": "README.md", "repository": { "type": "git", "url": "git+https://github.com/istanbuljs/babel-plugin-istanbul.git" }, "scripts": { "coverage": "nyc report --reporter=text-lcov | coveralls", "prepublish": "npm test && npm run release", "pretest": "standard && npm run release", "release": "babel src --out-dir lib", "test": "cross-env NODE_ENV=test nyc --reporter=lcov --reporter=text mocha test/*.js", "version": "standard-version" }, "standard": { "ignore": [ "fixtures/has-inline-source-map.js" ] }, "version": "4.1.5" }