CssDeadwood 0.2.7

Tool to search CSS files for unused CSS selectors.

CssDeadwood is a tool to search for unused CSS selectors by scanning given CSS files for CSS selectors and matching these against HTML files (and optionally PHP/Python/Ruby/templates source code).

Installation

The easiest way to install CssDeadwood is with pip:

pip install cssdeadwood

or easy_install:

easy_install cssdeadwood

These will install (among others) the cssdeadwood script in a bin folder corresponding with the used installation procedure.

Note that CssDeadwood depends on lxml, which may take a while to install/compile if it is not available on your system already.

Development

Or, if you want to go for the development version, clone CssDeadwood from https://github.com/soxofaan/CssDeadwood/

Usage

Basic usage of the cssdeadwood tool is pretty simple: just provide pass it one or more CSS files and one or more HTML files and let it do its job:

cssdeadwood style.css index.html

For example, CssDeadwood comes with a demo mode:

cssdeadwood --example

--------------------------------------------------------------------------------
Running CssDeadwood in example mode with following CSS and HTML file as input:
/path/to/cssdeadwood/test/files/css/css001.css
/path/to/cssdeadwood/test/files/html/html001.html
--------------------------------------------------------------------------------
INFO:cssdeadwood:Working with 1 CSS files.
INFO:cssdeadwood:Working with 1 HTML files.
INFO:cssdeadwood:Working with 0 source files.
INFO:cssdeadwood:Analysing CSS selectors from '/path/to/cssdeadwood/test/files/css/css001.css'
INFO:cssdeadwood:Extracted 5 CSS selectors from '/path/to/cssdeadwood/test/files/css/css001.css'.
INFO:cssdeadwood:DOM matching 5 CSS selectors: 3 matches, 2 unmatched with DOM from '/path/to/cssdeadwood/test/files/html/html001.html'
/path/to/cssdeadwood/test/files/css/css001.css
Could not determine usage of the following 2 CSS selectors (from 5 in total: 40.00%):
#content div.ad
a.premium