Uses babel (babylon) to extract JavaScript code comments from a JavaScript string or file.
npm install babel-extract-comments> Uses babel (babylon) to extract JavaScript code comments from a JavaScript string or file.
Please consider following this project's author, Jon Schlinkert, and consider starring the project to show your :heart: and support.
Install with npm:
``sh`
$ npm install --save babel-extract-comments
Add to your Node.js/JavaScript project with the following line of code:
`js`
const extract = require('babel-extract-comments');
Extract code comments from the given string.
Params
* string {String}: String of javascriptreturns
* {Array}: Array of code comment objects.
Example
`js`
var extract = require('babel-extract-comments');
console.log(extract('// this is a code comment'));
// [{ type: 'CommentBlock',
// value: '!\n babel-extract-comments
// Copyright (c) 2014-2018, Jon Schlinkert.\n * Released under the MIT License.\n ',
// start: 0,
// end: 173,
// loc: SourceLocation { start: [Position], end: [Position] } }]
Extract code comments from a JavaScript file.
Params
* file {String}: Filepath to the file to parse.options
* {Object}: Options to pass to esprima.returns
* {Array}: Array of code comment objects.
Example
`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 } } } ]
Contributing
Pull requests and stars are always welcome. For bugs and feature requests, please create an issue.
Running Tests
Running and reviewing unit tests is a great way to get familiarized with a library and its API. You can install dependencies and run tests with the following command:
`sh`
$ npm install && npm test
Building docs
_(This project's readme.md is generated by verb, please don't edit the readme directly. Any changes to the readme must be made in the .verb.md readme template.)_
To generate the readme, run the following command:
`sh``
$ npm install -g verbose/verb#dev verb-generate-readme && verb
You might also be interested in these projects:
* esprima-extract-comments: Extract code comments from string or from a glob of files using esprima. | homepage
* extract-comments: Uses esprima to extract line and block comments from a string of JavaScript. Also optionally… more | homepage.")
* js-comments: Parse JavaScript code comments and generate API documentation. | homepage
* parse-comments: Parse code comments from JavaScript or any language that uses the same format. | homepage
| Commits | Contributor |
| --- | --- |
| 4 | jonschlinkert |
| 1 | eventualbuddha |
Jon Schlinkert
* linkedin/in/jonschlinkert
* github/jonschlinkert
* twitter/jonschlinkert
Copyright © 2018, Jon Schlinkert.
Released under the MIT License.
*
_This file was generated by verb-generate-readme, v0.6.0, on February 12, 2018._