feat: add default_author (#181)
* feat: add deafult_author and start using actions-toolkit * fix: go back to @actions/core for logs * chore: add debug after fetching user * test: keep build not minified * fix: don't use tools.exit * fix: author_displayname * fix: check github_token * fix: back to minified builds * fix: fetch email too * fix: change option names * docs: document changes * docs: update "github-actions" example
This commit is contained in:
21
README.md
21
README.md
@@ -20,11 +20,11 @@ Add a step like this to your workflow:
|
||||
add: 'src'
|
||||
|
||||
# The name of the user that will be displayed as the author of the commit
|
||||
# Default: author of the commit that triggered the run
|
||||
# Default: depends on the default_author input
|
||||
author_name: Your Name
|
||||
|
||||
# The email of the user that will be displayed as the author of the commit
|
||||
# Default: author of the commit that triggered the run
|
||||
# Default: depends on the default_author input
|
||||
author_email: mail@example.com
|
||||
|
||||
# Name of the branch to use, if different from the one that triggered the workflow
|
||||
@@ -35,6 +35,13 @@ Add a step like this to your workflow:
|
||||
# Default: '.'
|
||||
cwd: './path/to/the/repo'
|
||||
|
||||
# Determines the way the action fills missing author name and email. Three options are available:
|
||||
# - github_actor -> UserName <UserName@users.noreply.github.com>
|
||||
# - user_info -> Your Display Name <your-actual@email.com>
|
||||
# - github_actions -> github-actions <email associated with the github logo>
|
||||
# Default:
|
||||
default_author: github_actor
|
||||
|
||||
# The message for the commit
|
||||
# Default: 'Commit from GitHub Actions (name of the workflow)'
|
||||
message: 'Your commit message'
|
||||
@@ -97,6 +104,8 @@ You can use the `tag` option to enter the arguments for a `git add` command. In
|
||||
When pushing, the action uses the token that the local git repository has been configured with: that means that if you want to change it you'll need to do it in the steps that run before this action. For example: if you set up your repo with [`actions/checkout`](https://github.com/actions/checkout/) then you have to add the token there.
|
||||
Changing the token with which the repo is configured can be useful if you want to run CI checks on the commit pushed by this action; anyway, it has to be set up outside of this action.
|
||||
|
||||
The action automatically gets the GitHub token from a `github_token` input: this input should not be modified by the user, since it doesn't affect the commits as it's only used to access the GitHub API to get user info, in case they selected that option for the commit author.
|
||||
|
||||
### About `actions/checkout`
|
||||
|
||||
The token you use when setting up the repo with this action will determine what token `add-and-commit` will use.
|
||||
@@ -120,7 +129,9 @@ For more info on how to use outputs, see ["Context and expression syntax"](https
|
||||
|
||||
### Examples:
|
||||
|
||||
If you don't want to use your GitHub username for the CI commits, you can [also use the user provided by GitHub for this task](https://github.com/actions/checkout/#push-a-commit-using-the-built-in-token):
|
||||
If you don't want to use your GitHub username for the CI commits, you can use the `default_author` option to make it appear as if it was made by "github-actions"
|
||||
|
||||
<img src="https://user-images.githubusercontent.com/26386270/115738624-80b51780-a38d-11eb-9bbe-77461654274c.png" height=40/>
|
||||
|
||||
```yaml
|
||||
on: push
|
||||
@@ -130,11 +141,9 @@ jobs:
|
||||
steps:
|
||||
- uses: EndBug/add-and-commit@v7.0.0
|
||||
with:
|
||||
author_name: github-actions
|
||||
author_email: 41898282+github-actions[bot]@users.noreply.github.com
|
||||
default_author: github_actions
|
||||
```
|
||||
|
||||
`41898282+github-actions[bot]@users.noreply.github.com` is the mail of the original GitHub Actions bot. If you use that, [the GitHub avatar is shown for the commits](https://github.community/t/github-actions-bot-email-address/17204).
|
||||
|
||||
Do you want to lint your JavaScript files, located in the `src` folder, with ESLint, so that fixable changes are done without your intervention? You can use a workflow like this:
|
||||
|
||||
|
||||
Reference in New Issue
Block a user