The actions updater will make it easy to update actions:
- 🥑 updated syntax and commands
- 🥑 versions of actions, either for releases or commits
- 🥑 preview, write to new file, or write in place!
- 🥑 run as a GitHub action workflow for annual checks!
You can see the ⭐️ Documentation ⭐️ for complete details!
The module is available in pypi as action-updater, and to install we first recommend some kind of virtual environment:
$ python -m venv env
$ source env/bin/activate
And then install from pypi using pip:
$ pip install action-updater
For all commands below, the actions updater can accept a directory with yaml files, or a single yaml file that matches the GitHub actions schema.
View updaters available (and descriptions)
$ action-updater list-updaters
You should likely detect (to preview) before you write the changes to file.
# Run all updaters
$ action-updater detect .github/workfows/main.yaml
# Only detect for the setoutput updater
$ action-updater detect -u setoutput .github/workfows/main.yaml
And finally, write updates to file!
$ action-updater update .github/workfows/main.yaml
If a file has updates, it will print to the terminal the updated file for preview.
And after you run update
(described below) you will see all green!
Running across many files:
And that's it! The action comes with several updaters that will look for particular aspects to lint or update. If you have a request for a new updated, please open an issue.
This could be fairly easy to extend to allow for more "linting" style actions to reflect preferences in style, e.g:
$ action-updater lint .github/workflows/main.yaml
If this sounds interesting to you, please open an issue to discuss further! We currently do some basic linting, as the yaml loading library has preferences for saving with respect to spacing, etc.
We use the all-contributors tool to generate a contributors graphic below.
Vanessasaurus 💻 |
Mike Henry 💻 |
This code is licensed under the MPL 2.0 LICENSE.