{"id":15673253,"url":"https://github.com/mckael/ghreleasechecker","last_synced_at":"2025-05-06T22:25:37.585Z","repository":{"id":57602443,"uuid":"127665707","full_name":"McKael/ghreleasechecker","owner":"McKael","description":"Github repository CLI Release Checker","archived":false,"fork":false,"pushed_at":"2023-02-25T19:09:04.000Z","size":36,"stargazers_count":15,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-31T03:32:26.509Z","etag":null,"topics":["cli","cron-script","github","github-api","github-releases","go","golang","release-checker","releases"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/McKael.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-04-01T19:44:10.000Z","updated_at":"2024-06-01T04:50:21.000Z","dependencies_parsed_at":"2024-06-19T17:37:26.269Z","dependency_job_id":"48997514-f589-460a-b767-f6ea90715f6a","html_url":"https://github.com/McKael/ghreleasechecker","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/McKael%2Fghreleasechecker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/McKael%2Fghreleasechecker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/McKael%2Fghreleasechecker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/McKael%2Fghreleasechecker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/McKael","download_url":"https://codeload.github.com/McKael/ghreleasechecker/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252777951,"owners_count":21802675,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","cron-script","github","github-api","github-releases","go","golang","release-checker","releases"],"created_at":"2024-10-03T15:38:47.147Z","updated_at":"2025-05-06T22:25:37.544Z","avatar_url":"https://github.com/McKael.png","language":"Go","readme":"# gh_release_checker\n\nghReleaseChecker is a small CLI utility that uses the Github API to\nperiodically check a list of projects for new releases.\n\n[![license](https://img.shields.io/badge/license-MIT-blue.svg?style=flat)](https://raw.githubusercontent.com/McKael/ghreleasechecker/master/LICENSE)\n[![Build Status](https://travis-ci.org/McKael/ghreleasechecker.svg?branch=master)](https://travis-ci.org/McKael/ghreleasechecker)\n[![Go Report Card](https://goreportcard.com/badge/github.com/McKael/ghreleasechecker)](https://goreportcard.com/report/github.com/McKael/ghreleasechecker)\n\n## Installation\n\nPre-built binaries of the command line utility are available from the\n[Release page](https://github.com/McKael/ghreleasechecker/releases).\n\nIt can also be built from source and installed with the usual command:\n\n```\ngo get -u github.com/McKael/ghreleasechecker\n```\n\nBuilds are tested with Travis for Go versions 1.7+.\n\n## Usage\n\nBy default, ghReleaseChecker outputs the new versions to stdout, which might be\nsuitable for a cron job, but it is possible to use a simple (Go) template or a\nJSON/YAML format that can be used for automation.\n\nA YAML configuration file is required; you can find a sample in the repository\nroot directory.\n\nghReleaseChecker uses a JSON state file, which path should be defined in the\nconfiguration file.\n\n\nHere's a sample use case:\n```\n% ghreleasechecker --config ./ghreleasechecker.yaml -o plain\nNew release for kubernetes/kubernetes: v1.10.0\n  Tag: v1.10.0\n  Date: 2018-03-27 01:57:17 +0200 CEST\nNew release for BurntSushi/ripgrep: 0.8.1\n  Tag: 0.8.1\n  Date: 2018-02-21 03:11:44 +0100 CET\nNew release for restic/restic: restic 0.8.3\n  Tag: v0.8.3\n  Date: 2018-02-26 21:41:52 +0100 CET\n```\n\nThe output can be customized with templates, here's an example with the\ndefault configuration file:\n```\n% ghreleasechecker --config ghreleasechecker.yaml\nMcKael/ghreleasechecker ghReleaseChecker 0.0.1 -- Initial release v0.0.1 2018-04-02 00:06:03 +0200 CEST\nkubernetes/kubernetes v1.10.0 v1.10.0 2018-03-27 01:57:17 +0200 CEST\nBurntSushi/ripgrep 0.8.1 0.8.1 2018-02-21 03:11:44 +0100 CET\nrestic/restic restic 0.8.3 v0.8.3 2018-02-26 21:41:52 +0100 CET\n```\n\nColors can be used on terminals supporting ANSI sequences.\n\n![Screenshot](ghreleasechecker_template.png \"Screenshot\")\n\nPlease check the commented [YAML sample configuration file](ghreleasechecker.yaml)\nprovided with the source code for the details and the online help for CLI usage,\navailable with the `--help` flag:\n\n```\n% ghreleasechecker --help\nghReleaseChecker is a release watcher for Github projects.\n\n(...)\n\nUsage:\n  ghreleasechecker [flags]\n\nFlags:\n      --color string      Color mode (auto|on|off; for output=template)\n      --config string     config file (default is $HOME/.config/ghreleasechecker/ghreleasechecker.yaml)\n      --debug             Display debugging details\n  -h, --help              help for ghreleasechecker\n  -o, --output string     Output handler (default: plain)\n      --read-only         Do not update the state file\n      --show-body         Display release body (for output=plain)\n      --template string   Go template (for output=template)\n  -t, --token string      Github API user token\n      --version           Display version\n      --wait              Wait when rate limit is exceeded\n```\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmckael%2Fghreleasechecker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmckael%2Fghreleasechecker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmckael%2Fghreleasechecker/lists"}