Validates C++ files with cpplint
npm install node-cpplintValidates CPP files with Google's cpplint
This module has been built for usage with Node scripts, to run from the command
line, and to be used as a Grunt task.
All methods of using this module allow for these specific configuration options:
- reporter The reporter to use ( spec | json | plain-text ); defaults
to spec.
- counting The counting-type ( total | toplevel | detailed ); defaults
to total. The total number of errors found is always printed. If toplevel
is provided, then the count of errors in each of the top-level categories likebuild and whitespace will also be printed. If detailed is provided, then
a count is provided for each category like build/class.
- verbose The verbosity level; defaults to 1. A number 0-5 to restrict
errors to certain verbosity levels.
- filters Enable/disable filtering for specific errors.
- extensions List of file extensions to lint.
- linelength The allowed line length.
A list of files is also expected.
Using the spec reporter, disabling whitespace/braces errors and linting file1.
``bash`
bin/cpplint --reporter spec --filter whitespace-braces file1
Setting verbosity to 3, line length to 120, and the counting-type to detailed while linting file1 and file2.
`bash`
bin/cpplint --verbose 3 --counting detailed --linelength 120 file2 file3
Using the plain-text reporter, ignoring build/deprecated errors and linting file1.
`bash`
bin/cpplint --filter build-deprecated --reporter plain-text file1
Using the cc and hpp extensions and linting source1.cc and source1.hpp.
`bash`
bin/cpplint --extensions cc,hpp source1.cc source1.hpp
Using the spec reporter
`javascript
var cpplint = require('lib/index.js');
var reporter = require('lib/reporters').spec;
var options = {
files: [
'/path/to/some/files.cc'
]
};
cpplint(options, reporter);
`
Using a custom reporter, disabling whitespace/braces and enabling whitespace/include_alpha
`javascript
var cpplint = require('lib/index');
var options = {
files: [
'/path/to/some/files.cc'
],
filters: {
'whitespace': {
'braces': false,
'include_alpha': true
}
},
// This could be an array of strings or a comma separated string
extensions: [
'cc',
'hpp'
]
};
cpplint(options, function (err, report) {
// your reporting logic
});
`
`javascript
grunt.loadNpmTasks('node-cpplint');
grunt.initConfig({
cpplint: {
files: [
'src/*/.cc',
'src/*/.cpp'
],
reporter: 'spec',
verbosity: 1
},
filters: {
'whitespace': {
'braces': false,
'include_alpha': true
}
},
linelength: 120,
// This could be an array of strings or a comma separated string
extensions: [
'cc',
'hpp'
]
});
`
Future plans (in no particular order):
- better test coverage
- xunit-xml reporter
In lieu of a formal styleguide, take care to maintain the existing coding
style. Add unit tests (using vows) for
any new or changed functionality. Lint and test your code using grunt jslintgrunt vows
and verify that all unit tests are passing with .
- add support for the linelength option
- update cpplint
- update cpplint
- added extensions option for overriding what file extensions to lint
- more windows compability fixes (line-endings) (@zcbenz)
- bug fix in filters support (@kevinsawicki)
- update grunt task to work with grunt 0.4 (@kevinsawicki)
- update dev dependencies (grunt-jslint, vows, ...)
- added npm test` support
- first public version
- provides a few simple options for validating CPP files