About

Get latest release tag(s) for GitHub repositories

This utility pulls the GitHub repository tags webpage via the reqwest asynchronous API. It does not pull subsequent pages, so it only presents the latest tags appearing on the first page. By default tags containing rc, pre, or canary are ignored, and only the first / latest tag is shown, but these behaviors can be modified via the -e and -a options, respectively.

If you need a more general / flexible utility, please try git ls-remote -t REPO, which can query remote git repositories at GitHub and elsewhere via any supported protocol, and will print all tags.

Usage

$ github-latest -V
github-latest 0.2.1

$ github-latest -h
Get latest tag(s) for GitHub repositories

Usage: github-latest [OPTIONS] [REPO]...

Arguments:
  [REPO]...  One or more GitHub repositories (`qtfkwk/github-latest`)

Options:
  -e <EXCLUDE>      Exclude tags with [default: rc,pre,canary]
  -a                Show all tags (on the first tags page)
  -h, --help        Print help
  -V, --version     Print version

Examples

$ github-latest qtfkwk/github-latest
| Repository           | Latest |
|----------------------|--------|
| qtfkwk/github-latest | 0.2.0  |

$ github-latest qtfkwk/github-latest -a
| Repository           | Latest              |
|----------------------|---------------------|
| qtfkwk/github-latest | 0.2.0, 0.1.1, 0.1.0 |

Changelog

• 0.1.0 (2024-01-18): Initial release
  • 0.1.1 (2024-01-18): Remove scraper dependency
• 0.2.0 (2024-01-24): Pull the /tags page instead of the main repo page; URL decoding via urlencoding; -e and -a options; improve doc; update dependencies
  • 0.2.1 (2024-03-11): Update dependencies