This GitHub Action automatically commits files which have been changed during a Workflow run and pushes the Commit back to GitHub. The Committer is "GitHub Actions [email protected]" and the Author of the Commit is "Your GitHub Username [email protected].
If no changes are available, the Actions does nothing.
This Action has been inspired and adapted from the auto-commit-Action of the Canadian Digital Service and the commit-Action by Eric Johnson.
Add the following step at the end of your job.
- uses: stefanzweifel/[email protected]
with:
commit_message: Apply automatic changes
branch: ${{ github.head_ref }}
# Optional glob pattern of files which should be added to the commit
file_pattern: src/\*.js
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}You do not have to create a new secret called GITHUB_TOKEN in your repository. GITHUB_TOKEN is a special token GitHub creates automatically during an Action run. (See the documentation for details)
The Action will only commit files back, if changes are available. The resulting commit will not trigger another GitHub Actions Workflow run!
It is recommended to use this Action in Workflows which listen to the pull_request event. If you want to use the Action on other events, you have to hardcode the value for branch as github.head_ref is only available in Pull Requests.
This Action will only work, if the job in your workflow changes project files. The most common use case for this, is when you're running a Linter or Code-Style fixer on GitHub Actions.
In this example I'm running php-cs-fixer in a PHP project.
name: php-cs-fixer
on:
pull_request:
paths:
- '**.php'
jobs:
php-cs-fixer:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v1
with:
fetch-depth: 1
- name: Run php-cs-fixer
uses: docker://oskarstark/php-cs-fixer-ga
- name: Commit changed files
uses: stefanzweifel/[email protected]
with:
commit_message: Apply php-cs-fixer changes
branch: ${{ github.head_ref }}
file_pattern: src/\*.php
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
Checkout actions.yml for a full list of supported inputs.
We use SemVer for versioning. For the versions available, see the tags on this repository.
This project is licensed under the MIT License - see the LICENSE file for details.