https://github.com/dtan4/ghrls
List & Describe GitHub Releases
https://github.com/dtan4/ghrls
github github-releases
Last synced: 9 months ago
JSON representation
List & Describe GitHub Releases
- Host: GitHub
- URL: https://github.com/dtan4/ghrls
- Owner: dtan4
- License: mit
- Created: 2017-01-17T07:15:17.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2023-03-01T08:56:37.000Z (almost 3 years ago)
- Last Synced: 2025-03-31T09:11:21.413Z (11 months ago)
- Topics: github, github-releases
- Language: Go
- Homepage:
- Size: 127 KB
- Stars: 11
- Watchers: 1
- Forks: 2
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# ghrls(1)
[](https://github.com/dtan4/ghrls/actions?query=workflow%3ATest+branch%3Amaster)
List & Describe GitHub Releases
```bash
$ ghrls list kubernetes/kubernetes | head
TAG TYPE CREATEDAT NAME
v1.6.0-alpha.0 TAG
v1.5.3-beta.0 TAG
v1.5.2 TAG+RELEASE 2017-01-12 13:51:15 +0900 JST v1.5.2
v1.5.2-beta.0 TAG
v1.5.1 TAG+RELEASE 2016-12-14 09:50:36 +0900 JST v1.5.1
v1.5.1-beta.0 TAG
v1.5.0 TAG+RELEASE 2016-12-13 08:29:43 +0900 JST v1.5.0
v1.5.0-beta.3 TAG+RELEASE 2016-12-09 06:52:35 +0900 JST v1.5.0-beta.3
v1.5.0-beta.2 TAG+RELEASE 2016-11-25 07:29:04 +0900 JST v1.5.0-beta.2
```
## Installation
### Using Homebrew (OS X only)
Formula is available at [dtan4/homebrew-tools](https://github.com/dtan4/homebrew-tools).
```bash
$ brew tap dtan4/tools
$ brew install ghrls
```
### Precompiled binary
Precompiled binaries for Windows, OS X, Linux are available at [Releases](https://github.com/dtan4/ghrls/releases).
### From source
```bash
$ go get -d github.com/dtan4/ghrls
$ cd $GOPATH/src/github.com/dtan4/ghrls
$ make install
```
## Usage
### (Recommended) Set `GITHUB_TOKEN` environment variable
`ghrls` can be used without any special token as default.
However, according to [GitHub API Rate Limiting](https://developer.github.com/v3/#rate-limiting), unauthenticated user is allowed to make up to 60 requests per hour.
In contrast, authenticated user (using `GITHUB_TOKEN`) can make up to 5,000 requests per hour.
Authentication is required to access to yourt private repositories, of course.
I strongly recommend to set `GITHUB_TOKEN` in your shell. `GITHUB_TOKEN` can be obtained from [here](https://github.com/settings/tokens).
```bash
export GITHUB_TOKEN=xxxxxxxxxxxxxxxxxxxx
```
### `ghrls get`
Describe release information
```bash
$ ghrls get kubernetes/kubernetes v1.5.2
Tag: v1.5.2
Commit: 08e099554f3c31f6e6f07b448ab3ed78d0520507
Name: v1.5.2
Author: saad-ali
CreatedAt: 2017-01-12 13:51:15 +0900 JST
PublishedAt: 2017-01-12 16:25:50 +0900 JST
URL: https://github.com/kubernetes/kubernetes/releases/tag/v1.5.2
Assets: https://github.com/kubernetes/kubernetes/releases/download/v1.5.2/kubernetes.tar.gz
See [kubernetes-announce@](https://groups.google.com/forum/#!forum/kubernetes-announce) and [CHANGELOG](https://github.com/kubernetes/kubernetes/blob/master/CHANGELOG.md#v152) for details.
SHA256 for `kubernetes.tar.gz`: `67344958325a70348db5c4e35e59f9c3552232cdc34defb8a0a799ed91c671a3`
Additional binary downloads are linked in the [CHANGELOG](https://github.com/kubernetes/kubernetes/blob/master/CHANGELOG.md#downloads-for-v152).
```
### `ghrls list`
List releases
```bash
$ ghrls list kubernetes/kubernetes | head
TAG TYPE CREATEDAT NAME
v1.6.0-alpha.0 TAG
v1.5.3-beta.0 TAG
v1.5.2 TAG+RELEASE 2017-01-12 13:51:15 +0900 JST v1.5.2
v1.5.2-beta.0 TAG
v1.5.1 TAG+RELEASE 2016-12-14 09:50:36 +0900 JST v1.5.1
v1.5.1-beta.0 TAG
v1.5.0 TAG+RELEASE 2016-12-13 08:29:43 +0900 JST v1.5.0
v1.5.0-beta.3 TAG+RELEASE 2016-12-09 06:52:35 +0900 JST v1.5.0-beta.3
v1.5.0-beta.2 TAG+RELEASE 2016-11-25 07:29:04 +0900 JST v1.5.0-beta.2
```
## Development
Retrieve this repository and build using `make`.
```bash
$ go get -d github.com/dtan4/ghrls
$ cd $GOPATH/src/github.com/dtan4/ghrls
$ make
```
## Author
Daisuke Fujita ([@dtan4](https://github.com/dtan4))
## License
[](LICENSE)