@@ -14,8 +14,10 @@ A GitHub Action to create signed and verified commits as the
1414accomplished via the GitHub [ REST API] by using the [ Blob] and [ Tree] endpoints
1515to build the commit and update the original Ref to point to it. [ ^ 1 ]
1616
17- The resulting commit will be signed and verified using
18- [ GitHub's public PGP key] ( https://github.com/web-flow.gpg ) !
17+ After using this Action your local branch will be updated to point to the newly
18+ created commit, which will be signed and verified using
19+ [ GitHub's public PGP key] ( https://github.com/web-flow.gpg ) ! Files that were not
20+ committed by the Action will be left staged.
1921
2022> [ !IMPORTANT]
2123>
@@ -37,6 +39,7 @@ The resulting commit will be signed and verified using
3739 README.md
3840 *.txt
3941 src/**/tests/*
42+ !test-data/dont-include-this
4043 test-data/**
4144` ` `
4245
@@ -52,19 +55,21 @@ The resulting commit will be signed and verified using
5255> example.txt
5356> ```
5457
55- | Name | Type | Description | Default |
56- | ----------------- | ------ | ------------------------------------------------ | ------------------------- |
57- | `ref` | String | The ref to push the commit to | `${{ github.ref }}` |
58- | `files` | List | Files/[Glob] patterns to include with the commit | _required_ |
59- | `message` | String | Message for the commit [1] | _optional_ |
60- | `message-file` | String | File to use for the commit message [1] | _optional_ |
61- | `force-push` | String | Force push the commit | `false` |
62- | `follow-symlinks` | String | Follow symbolic links when globbing files | `true` |
63- | `workspace` | String | Directory containing checked out files | `${{ github.workspace }}` |
64- | `token` | String | GitHub Token for REST API access [2] | `${{ github.token }}` |
65-
66- > 1. You must include either `message` or `message-file` (which takes priority).
67- > 2. This Action is intended to work with the default `GITHUB_TOKEN`. See the
58+ | Name | Type | Description | Default |
59+ | ----------------- | ------- | ---------------------------------------------------- | ------------------------- |
60+ | `ref` | String | The ref to push the commit to | `${{ github.ref }}` |
61+ | `files` | List | Files/[Glob] patterns to include with the commit [1] | _required_ |
62+ | `message` | String | Message for the commit [2] | _optional_ |
63+ | `message-file` | String | File to use for the commit message [2] | _optional_ |
64+ | `force-push` | Boolean | Force push the commit | `false` |
65+ | `follow-symlinks` | Boolean | Follow symbolic links when globbing files | `true` |
66+ | `workspace` | String | Directory containing checked out files | `${{ github.workspace }}` |
67+ | `token` | String | GitHub Token for REST API access [3] | `${{ github.token }}` |
68+
69+ > 1. Files within your `.gitignore` will not be included. You can also negate
70+ > any files by prefixing it with `!`
71+ > 2. You must include either `message` or `message-file` (which takes priority).
72+ > 3. This Action is intended to work with the default `GITHUB_TOKEN`. See the
6873> [notice](#verified-bot-commit-action) and [limitations](#limitations)
6974
7075# ## Outputs
0 commit comments