Will add a comment to the start of the transpiled code. Since transpiling via Babel is becoming one of the last steps of the build process it's handy to add some tooling around this final step. For instance could be used:
- to add in license info
- add in version numbers to builds
$ npm install babel-plugin-add-header-comment
The following is an example
.babelrc file. Using the following settings the comment will be created using 3 different features:
- Adding a hardcoded string (
"This string will be inserted in")
- By executing a script and injecting the output (
- By reading in the contents of a file (
"presets": "es2015""plugins":"add-header-comment""header":"This string will be inserted in a comment header""!node executeThisOutputAddedToHeader.js""?readInTheContentsOfThisFile.txt"
Sometimes you may want to just add headers to specific files. In this case you can do the following:
"presets": "es2015""plugins":"add-header-comment""files":"src/index.js":"header":"This string will be inserted in a comment header"
newLineChar- This is the newline char that should be used by the plugin. Default value:
cache- This is a string which represents what type of operations should be cached. For instance if you wanted to cache both read and command executions you could pass in
?!. Default value:
commentStart- This is a string which describes how the comment is started/opened. For instance if you'd like you're comment to start with
/*COMMENT STARTpass in
'COMMENT START'. Default value:
commentEnd- This is a string which describes how the comment is ended/closed. For example if you'd like your comment to end with
COMMENT END*/pass in
'COMMENT END'. Default value:
commentLineStart- A string which is the leading charachter before a comment. Default value:
MIT, see LICENSE.md for details.