Create CLI

[adamghill]

• Make a usable CLI similar to other Node tools, e.g. purgecss
• It should not require Django or django-compressor (but, should support DLT/Jinja with a flag?)
• First arg is CSS file path and return a cleaned CSS file (stdin/stdout? but, flag for output?)
• Flag to specify a directory of HTML
• Flag to retrieve and print out the list of CSS classes, ids, elements in all templates
• Flag to point to a website URL instead of HTML template files

[benjaoming]

Firstly, congratulations with a super nice project! Indeed, stale CSS rules can make a whole project feel overwhelming to clean up in.

Responding to your Fediverse post:

Yes indeed it could be straightforward to create a pre-commit hook from CLI... where straightforward is subject to subjectivity :) I think pre-commit's prime feature is that it accepts a list of files that have been changed, so it's possible for linters and other tools to minimize their work load.

Say:

-   id: refreshcss-scss-compile
    repo: https://github.com/adamghill/refreshcss/
    name: refreshcss - checking for stale CSS rules
    language: python
    types_or: [html, css, scss]
    entry: refreshcss --check
    args: [--compile-from my_scss_source.scss]

The idea here would be that there was a hook for each css compiler that refreshcss knows how to run. I suppose compiling the CSS comes with some additonal Python dependency. The refreshcss command needs to know what it's supposed to compile and which HTML files to look at. This is probably best to achieved by the calling user defining args: [...] in their pre-commit configuration?

Another option is to leave it to the user to install the compilation dependencies and configure the correct entry. It's not so self-contained, though. Would need to be reproduced both locally and in CI.

I think having a CLI to begin with is a natural starting point, then maybe someone that really likes this would add a pre-commit hook configuration ❤️

[adamghill]

0.4.0 is released and refreshcss now has a CLI thanks to @tobiasmboelz!