lastversion 0.0.8

A CLI tool to fetch last GitHub release version

lastversion

A tiny command line utility that helps to answer one simple question:

What is the latest released version for a GitHub project?

GitHub has an API endpoint here. But if you're here, then you know how it sucks.

A release would show up in this API response only if it was filed formally using GitHub release interface. Thus, you can find many (if not most) GitHub projects whose Releases are simply not visible through the API, but only through the actual Releases page.

But we want to get last version on the command line, without looking at Releases page :). Meet lastversion.

Synopsys

lastversion apache/incubator-pagespeed-ngx

1.13.35.2

That repository specifically, is a good example. Because using only API on it will yield an ancient release.

 lastversion --nosniff apache/incubator-pagespeed-ngx

1.9.32.10

Why is because at some point the maintainers of the repository did a formal UI release, but later used the standard approach.

Usage

usage: lastversion [-h] [--nosniff] [--novalidate] R

Get latest release from GitHub.

positional arguments:
  R             GitHub repository in format owner/name

optional arguments:
  -h, --help    show this help message and exit
  --nosniff
  --novalidate

The --nosniff will disable the magic and only API will be used (yuck).

The --novalidate will disable validation of fetched version.

Installation for CentOS 7

yum install https://extras.getpagespeed.com/release-el7-latest.rpm
yum install python2-lastversion

Installation for other systems

The script requires Python 2.7 and few dependencies. Pip should take of those:

pip install lastversion

Tips

If you're planning to fetch versions for a whole lot of projects, setup your GitHub API token in ~/.bashrc like this:

export GITHUB_API_TOKEN=xxxxxxxxxxxxxxx

So lastversion will use it to get larger API calls allowance from GitHub.