Home

Awesome

:warning: This project is deprecated and no longer maintained starting from 2022/11/18. Please use dependabot CLI instead, an official tool made by GitHub.

<p align="center"><a href="https://github.com/fabasoad/ghacu"><img src="https://raw.githubusercontent.com/fabasoad/ghacu/main/resources/ghacu-logo-png-img.png" alt="ghacu logo" height="120"/></a></p> <h1 align="center">ghacu</h1> <p align="center">Keep your GitHub Actions up-to-date.</p> <p align="center"> <a href="https://github.com/fabasoad/ghacu/actions?query=workflow%3A%22CI+%28main%29%22"><img src="https://github.com/fabasoad/ghacu/workflows/CI%20(main)/badge.svg" /></a> <a href="https://github.com/fabasoad/ghacu/actions?query=workflow%3A%22CI+%28latest%29%22"><img src="https://github.com/fabasoad/ghacu/workflows/CI%20(latest)/badge.svg" /></a> <a href="https://github.com/fabasoad/ghacu/actions?query=workflow%3A%22Security+Tests%22"><img src="https://github.com/fabasoad/ghacu/workflows/Security%20Tests/badge.svg" /></a> <a href="https://github.com/fabasoad/ghacu/actions?query=workflow%3A%22YAML+Lint%22"><img src="https://github.com/fabasoad/ghacu/workflows/YAML%20Lint/badge.svg" /></a> <a href="https://github.com/fabasoad/ghacu/actions?query=workflow%3A%22PowerShell+Lint%22"><img src="https://github.com/fabasoad/ghacu/workflows/PowerShell%20Lint/badge.svg" /></a> <a href="https://choosealicense.com/licenses/mit/"><img src="https://img.shields.io/github/license/fabasoad/ghacu" /></a> </p><br/><br/> <p align="center"><a href="https://github.com/fabasoad/ghacu"><img src="https://raw.githubusercontent.com/fabasoad/ghacu/main/resources/ghacu-demo.gif" width="60%"/></a></p><br/>

:page_with_curl: Description

CLI tool that checks versions of GitHub Actions that used in a repository. Please read documentation for more details.

:shipit: Commands

--no-cache     Disable cache.
--no-colors    Disable colors.
--log-level    (Default: Information) Set log level. Possible values: Trace, Debug, Information, Warning, Error, Critical, None.
--output-type  (Default: Console) Information output type. Possible values: Console, Logger, Silent.
--repository   Path to the root of a project.
--token        GitHub token to work with actions repositories.
--upgrade      Upgrade versions to the latest one.
--help         Display this help screen.
--version      Display version information.

All commands are optional and can be run by purpose.

:key: GitHub Token

There are 2 ways to pass GitHub token to ghacu:

  1. Using --token parameter:
ghacu --token abc123 --repository "C:\Projects\business-card"
  1. Defining GHACU_GITHUB_TOKEN environment variable:
export GHACU_GITHUB_TOKEN=abc123
ghacu --repository "C:\Projects\business-card"

Program argument way takes precedence over the environment variable way. So the program looks at program argument first, if it's not present it looks at GHACU_GITHUB_TOKEN environment variable and if it's not present as well then ghacu will work as unauthenticated user.

:crystal_ball: Examples

PS C:\Projects\business-card> ghacu
> CI (.github\workflows\ci.yml)
actions/checkout                 v1  »  v2.1.0
bahmutov/npm-install             v1  »  v1.4.0
crazy-max/ghaction-github-pages  v1  »  v1.3.0

> Milestone Closure (.github\workflows\release-notes.yml)
actions/checkout                          master  »  v2.1.0
decathlon/release-notes-generator-action   2.0.0  »  v2.0.1

Run ghacu --upgrade to upgrade the actions.
<p align="center"><a href="https://github.com/fabasoad/ghacu#ghacu">:top:</a></p>