cssi

cssi: CSS Selector Scene Investigation. Analyses a git codebase for unused CSS selectors

Getting Started

Install the module with: npm -g install cssi

https://www.npmjs.org/package/cssi

Documentation

cssi
Usage: cssi --css bla.css --repo /path/to/repo [options]

--css:     file | dir | url - css to be parsed
--repo:    /full/path/to/local/repo - local repo where git-grep will search for css
--reverse: finds not the last, but the first commit where the selector was changed
--exclude: "string" or ["array", "of", "strings"] - exclude selectors that contains these strings, to avoid known false positives like icon fonts
--tpl:     "*.ext" - glob of files that should be checked for selectors. Default = "'*.tmpl' '*.inc' '*.js'"
--debug:   shows extra debug information
--out:     filename.html - different report filename. Default is a normalized version of css_path-filename.html
--link:    "https://github.com/bitbonsai/cssi/commit/{sha}" - link to web git show. Can be any valid URL, {sha} is replaced with commit hash
--config:  file.json - load or replace arguments from config file (must be valid json)

Examples

• cssi --css css/sample_gen_profile.css --repo /Users/local_repo/ --exclude bicon
• cssi --css css/ --repo /Users/local_repo/
• cssi --css css/ --repo /Users/local_repo/ --tpl "'*.html' '*.php'" --out myreportname.html --reverse
• cssi --css css/ --repo /Users/local_repo/ --config filename.json
• cssi --css http://example.com/site.css --repo /Users/local_repo/ --debug

Contributing

In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code using Grunt.

Release History

• 0.5.x - --exclude now accepts string or array of strings to ignore
• 0.4.x - Added counter and report for original_selectors
• 0.3.x - Added --link, js sort to table, selector count
• 0.2.x - Added option to load config file
• 0.1.x - BrazilJS 2014 version

License

Copyright (c) 2014 Mauricio Wolff
Licensed under the MIT license.