Skip to content
This repository has been archived by the owner on Aug 12, 2024. It is now read-only.
/ web-puc Public archive

Validate your web project uses the latest CSS & JS includes

License

Notifications You must be signed in to change notification settings

fulldecent/web-puc

Repository files navigation

Warning

This project is no longer maintained. Going forward, please see the GitHub Pages template project for best practices and checkers when publishing (static) web pages. And specifically see the packages checker in that project that replaces web-puc.

Web Package Update Checker Ruby

We find old Bootstrap, JQuery, etc. references in your web projects and tell you to update them.

Use web-puc in your unit testing or continuous integration testing to confirm that you are not using outdated packages. We support packages that are included via CDN as well as mix-ins and Javascript/CSS/Fonts that are subsetted or compiled into your own files! We support ANY web front-end including HTML, PHP, Ruby, ASP, Cold Fusion.

For a full example of using web-puc with Travis CI for integration testing, please see https://github.com/fulldecent/sourcespeak and its .travis.yml file.

Synopsis

web-puc [-e glob] [-s] [-u] target ...

The following options are available:

Option Short Description
--exclude GLOB -e GLOB Exclude from consideration all files matching GLOB
--allow-supported -s Allow supported versions even if not latest
--update -u Update web package database

Return status is zero for success and non-zero if errors are found.

Output format:

web-puc 0.4.1
hello.html:15:Old version Bootstrap v3.0.0 (http://getbootstrap.com)

Ruby

Or access this tool using the web-puc Ruby gem.

Project layout

  • web-puc - the main executable
  • packages/ - database of package information
  • package-spiders/ - tools for updating the packages/ directory
  • tests/ - unit tests

Package recognition

We recognize packages by three types of matching:

  • CDN: is an inclusion (like <script src="..."> or <link href="...">) to a file on a popular content distribution network. For example, when this was written, //netdna.bootstrapcdn.com/bootstrap/3.0.0/css/bootstrap.min.css was an old version, but //netdna.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css was current

  • Identifier: is a string like Bootstrap v3.0.0 (http://getbootstrap.com) which would indicate a file in your project contains specific code (web-puc gleans information from your files' contents, not names)

  • Content Matcher: is a string like .form-control{position:relative;z-index:2;float:left; that would indicate, for example, that are using Twitter Bootstrap 3.1.1 even if you later minify and package all your CSS files together

Project roadmap

Please Star (or Watch!) this project for updates and to get involved. Following is a roadmap:

  • Create more package-updaters for all MaxCDN packages and JQuery
  • Store packages/ and package-spiders/ in a separate repository and have web-puc use git pull to update
  • Have web-put.sh warn if packages/ was updated too long ago (like Composer)
  • Advertise the availability of this project