With the release of Super-Linter 7.0.0, Prettier has become the standard for many file formats, ensuring consistent code styling across your projects. Embrace this change and keep your codebase looking sharp by integrating Prettier directly into your workflow. While you can still rely on your favorite IDE to apply Prettier's formatting, why not automate the process with this GitHub Action using vanilla Prettier?
- Automatically formats code using Prettier.
- Creates a new branch (prefixed with
prettier/fix
) if changes are required, making it easy to review and merge. Or you can set the input parametercommit-changes: true
to commit to the current branch. - Allows for customizable commit messages via the
commit-message
input. - Provides the branch name as an output for downstream workflows.
- Issues warnings for manual changes needed in
.github/workflows
files.
To automate Prettier, simply add the provided YAML configuration to your repository.
By default, if needed, a new branch with a name starting with prettier/fix
will be created, making it easy to review and merge the fixes into your main branch.
Note: This action is not blocking, so the status remains green even if changes are proposed in the form of a new branch. Then it’s up to you to either create a pull request to merge the changes or delete the branch.
Input | Description | Default |
---|---|---|
node-version |
Node.js version to use | "20" |
commit-changes |
If true , commits changes to the current branch instead of creating a new one |
false |
skip-package-setup |
If true , skips npm init and dependency installation steps |
false |
commit-message |
Commit message for the changes | "Prettier fixes applied automatically" |
Note: it would be possible to use git-user-name
and git-user-email
as inputs to set-up the info about the author of the commits, but for clarity actions/checkout recommends
git config user.name "github-actions[bot]"
git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
Btw: GitHub displays name according to a known email.
Output | Description |
---|---|
branch-name |
The name of the branch created/used |
If the changes involve files within the .github/workflows/
directory, these cannot be done automatically and need to be updated manually.
So, it also checks for any changes made to the .github/workflows
directory and issues a warning if changes are detected, advising you to manually review and fix these to avoid conflicts with Super-Linter.
After making the necessary adjustments, simply create a pull request to finalize the changes and keep your repository in top shape.