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 }}
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.
The following inputs are required
commit_message
: The commit message used when changes are availablebranch
: Branch name where changes should be pushed to
The GITHUB_TOKEN
secret is required. It is automatically available in your repository. You have to add it to the configuration though.
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 }}
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
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.