dtrodrigues / homebrew-livecheck

🖖 External command for Homebrew that checks for newer versions of formulae from upstream.

homebrew-livecheck

External command for Homebrew that checks for newer version of formulae in the upstream.

Install

brew tap homebrew/livecheck

That's it. You don't even need to install the formula. And it will autoupdate whenever you do a brew update.

Usage

The most useful way to use the command is by invoking

$ brew livecheck
==> git : 2.1.2 ==> 2.1.2
==> sqlmap : 0.9 ==> 0.9
==> pebble-sdk : 2.6 ==> 2.7
...

which shows (with colors!) the formulae in your watchlist (default: ~/.brew_livecheck_watchlist) that are outdated. You can set your own watchlist file in the HOMEBREW_LIVECHECK_WATCHLIST env variable.

brew livecheck
brew livecheck formula1 formula2 ...
brew livecheck [-i|--installed]
brew livecheck [-a|--all]
brew livecheck [-h|--help]

Usage:
Check if a formula is outdated. If no argument is passed, the list of
formulae to check is taken from /Users/youtux/.brew_livecheck_watchlist.

Options:
-h, --help        show this help message and exit
-n, --newer-only  show the latest version only if it's newer than the formula
                  in Homebrew
-v, --verbose     be more verbose :)
-q, --quieter     be more quiet (do not show errors)
-d, --debug       show debugging info

Some of the formulae can be checked out-of-the-box (like sqlmap), but others need to some attention to make 'em work. If you find a formula that can't be checked, please help the project by writing the Livecheckable version and make a pull request!

In order to make a formula compatible with homebrew-livecheck, it is sufficient to extend the formulae class and place it into the Livecheckables directory.

The only requirement is that a Livecheckable formula must implement the latest method, that can be easily made by calling the livecheck function available from formula.rb.

Here's an example from python.rb:

class A52dec
  livecheck do
    url "http://liba52.sourceforge.net/downloads.html"
    regex(/href=.*?a52dec-(\d+(?:\.\d+)+)\.t/)
  end
end

You can look at Livecheckables to get the idea.

Contributing

The homebrew-livecheck repository is currently in a state of transition and we are discouraging contributions for a brief period of time while we do some important and time-sensitive work.

Existing livecheckables are being brought up to our current standards and then they will be integrated into their respective formulae in homebrew-core. After this point, livecheckable files will no longer be necessary and new livecheck blocks will simply be added to formulae directly.

Similarly, we're working on refactoring some of livecheck's internal files to ready it for its own migration. After the homebrew-core migration is finished, the brew livecheck command and its related files will be integrated into Homebrew/brew.

After these migrations are completed, related contributions can be resumed in the homebrew-core and Homebrew/brew repositories. We hope to see you again in the future and we appreciate your understanding in the interim time.

Changelog

See the git log. An old changelog (not maintained) is available at CHANGELOG.md.