diff options
Diffstat (limited to 'node_modules/babel-extract-comments/index.js')
| -rw-r--r-- | node_modules/babel-extract-comments/index.js | 63 |
1 files changed, 63 insertions, 0 deletions
diff --git a/node_modules/babel-extract-comments/index.js b/node_modules/babel-extract-comments/index.js new file mode 100644 index 00000000..0b9d142a --- /dev/null +++ b/node_modules/babel-extract-comments/index.js @@ -0,0 +1,63 @@ +/*! + * babel-extract-comments <https://github.com/jonschlinkert/babel-extract-comments> + * + * Copyright (c) 2014-2018, Jon Schlinkert. + * Released under the MIT License. + */ + +'use strict'; + +const fs = require('fs'); +const path = require('path'); +const babylon = require('babylon'); + +/** + * Extract code comments from the given `string`. + * + * ```js + * var extract = require('babel-extract-comments'); + * console.log(extract('// this is a code comment')); + * // [{ type: 'CommentBlock', + * // value: '!\n * babel-extract-comments <https://github.com/jonschlinkert/babel-extract-comments>\n *\n * + * // Copyright (c) 2014-2018, Jon Schlinkert.\n * Released under the MIT License.\n ', + * // start: 0, + * // end: 173, + * // loc: SourceLocation { start: [Position], end: [Position] } }] + * ``` + * @param {String} `string` String of javascript + * @return {Array} Array of code comment objects. + * @api public + */ + +function extract(str, options) { + const res = babylon.parse(str, options); + return res.comments; +} + +/** + * Extract code comments from a JavaScript file. + * + * ```js + * console.log(extract.file('some-file.js'), { cwd: 'some/path' }); + * // [ { type: 'Line', + * // value: ' this is a line comment', + * // range: [ 0, 25 ], + * // loc: { start: { line: 1, column: 0 }, end: { line: 1, column: 25 } } } ] + * ``` + * @param {String} `file` Filepath to the file to parse. + * @param {Object} `options` Options to pass to [esprima][]. + * @return {Array} Array of code comment objects. + * @api public + */ + +extract.file = function(file, options) { + const opts = Object.assign({ cwd: process.cwd() }, options); + const str = fs.readFileSync(path.resolve(opts.cwd, file), 'utf8'); + return extract(str, options); +}; + +/** + * Expose `extract` + */ + +module.exports = extract; |
