Build consistent and versioned styleguides by including and running consistent lint files across projects.
Your styleguide should be verisoned and consistent across all of your projects. This means that you should only have ONE .jshintrc
and/or .jscsrc
file anywhere. But how can this be accomplished easily? By making your own styleguide using fashion-show
.
A fully working example at indexzero/styleguide. Basically it happens in a few steps:
- 1. Make a new repository,
your-styleguide
- 2. Add your
.jshintrc
and.jscsrc
files:
cd your-styleguide
mkdir dist
mkdir dotfiles
touch dotfiles/.jshintrc
touch dotfiles/.jscsrc
- 3. Install
fashion-show
and your favorite linters:jscs
,eslint
andjshint
are supported.
npm install fashion-show jscs eslint --save
- 4. "Build" your dotfiles on prepublish (i.e. remove comments)
"scripts": {
"prepublish": "./node_modules/.bin/fashion-show-build"
}
- 5. Write a simple wrapper script to "lint"
var path = require('path');
require('fashion-show')({
commands: ['jscs', 'eslint'],
rc: path.join(__dirname, '..', 'dist')
}, function (err, code) {
if (err) { return process.exit(1); }
process.exit(code);
});
- 6. Expose that script as a "bin" in
your-styleguide
"bin": {
"your-styleguide": "./bin/your-styleguide"
}
- 7. Depend on
your-styleguide
cd your-styleguide
npm publish
cd some/other/project
npm install your-styleguide --save-dev
- 8. Use the bin you created on "pretest"
"scripts": {
"pretest": "your-styleguide lib test"
}
At its core fashion-show
will run the CLI versions of the lint tools you choose to use it with. A comparison of JavaScript lint CLI options is available if you're interested in exploring this in depth, but fashion-show
has gone to length to pick the best tool for the job where applicable so when you run:
require('fashion-show')(options, function (err, code) {
if (err) { return process.exit(1); }
process.exit(code);
});
The list of all available options
is:
option name | example | jshint | jscs | eslint |
---|---|---|---|---|
commands |
['jscs', 'eslint'] |
--- |
--- |
--- |
targets |
['lib/', 'test/'] |
...args |
...args |
...args |
rc |
['../rc'] |
--config |
--config |
--config |
fix |
true |
--- |
--fix |
--- |
exts |
['.jsx'] |
--extra-ext |
--- |
--ext .js |
reporter |
'checkstyle' |
--reporter |
--reporter |
--reporter |
global |
['my-global'] |
--prereq |
--- |
--global |
All of these options are also configurable through the binary scripts that you define in Step 5 above:
CLI option | option name | Sample usage |
---|---|---|
...args |
targets |
lib/ test/ |
-c,--command |
commands |
--c jscs |
-r,--rc |
rc |
--d ~/.lintrcs |
-f,--fix |
fix |
--fix |
-e,--ext |
exts |
--ext .jsx |
-r,--reporter |
reporter |
--r checkstyle |
-g,--global |
global |
--g my-global |
Array of commands to actually run against. Each item in the Array can be a string command or an object:
{
'command': 'jscs',
'args': ['extra', 'jscs', 'specific', 'args']
}
The set of targets to run the given commands against.
Directory where all of your lint files is located. It will be default look for .{command}rc
: .jscsrc
, .jshintrc
, .eslintrc
Reporter passed to the linters that you are running.
If enabled will turn on auto fixing in jscs
(Currently whitespace rules, EOF rule, and validateIndentation)
Set of additional extensions that you want to include running lint(s) against.
Set of additional globals that you wish to enable
Tests are written with mocha
and code coverage is provided by istanbul
:
npm test