使用 GitHub Actions 获取 git 差异
Read this in other languages: English, 日本語.
GitHub actions to get git diff.
You can get the differences via env or action output.
Details
generated with TOC Generator
Example workflow
Skip
Basic Usage
on: pull_request
name: CI
jobs:
eslint:
name: ESLint
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v2
- uses: technote-space/get-diff-action@v6
with:
PATTERNS: |
+(src|__tests__)/**/*.ts
!src/exclude.ts
FILES: |
yarn.lock
.eslintrc
- name: Install Package dependencies
run: yarn install
if: env.GIT_DIFF
- name: Check code style
# Check only if there are differences in the source code
run: yarn lint
if: env.GIT_DIFFDetails of the patterns that can be specified
src/main.tssrc/utils/abc.ts__tests__/test.tsyarn.lock.eslintrcanywhere/yarn.lockmain.tssrc/xyz.txtsrc/exclude.ts| name | value |
|---|---|
GIT_DIFF |
'src/main.ts' 'src/utils/abc.ts' '__tests__/test.ts' 'yarn.lock' '.eslintrc' 'anywhere/yarn.lock' |
GIT_DIFF_FILTERED |
'src/main.ts' 'src/utils/abc.ts' '__tests__/test.ts' |
MATCHED_FILES |
'yarn.lock' '.eslintrc' 'anywhere/yarn.lock' |
Specify a little more detail
…If there is no difference in the source code below, this workflow will skip the code style check
src/**/*.ts__tests__/**/*.tsGet git diff
git diff ${FROM}${DOT}${TO} '--diff-filter=${DIFF_FILTER}' --name-onlye.g. (default)
DOT: '...'
DIFF_FILTER: 'AMRC'=>
git diff ${FROM}...${TO} '--diff-filter=AMRC' --name-only=>
.github/workflows/ci.yml
__tests__/utils/command.test.ts
package.json
src/main.ts
src/utils/command.ts
src/docs.md
yarn.lockFiltered by PATTERNS option
e.g.
PATTERNS: |
src/**/*.+(ts|md)
!src/utils/*=>
src/main.ts
src/docs.mdFiltered by FILES option
e.g.
FILES: package.json=>
package.json
anywhere/package.jsonMapped to absolute if ABSOLUTE option is true (default: false)
e.g.
/home/runner/work/my-repo-name/my-repo-name/src/main.ts
/home/runner/work/my-repo-name/my-repo-name/src/docs.mdCombined by SEPARATOR option
e.g. (default)
SEPARATOR: ' '=>
/home/runner/work/my-repo-name/my-repo-name/src/main.ts /home/runner/work/my-repo-name/my-repo-name/src/docs.md| name | description | e.g. |
|---|---|---|
| diff | The results of diff file names. | |
If inputs SET_ENV_NAME(default: GIT_DIFF) is set, an environment variable is set with that name. |
src/main.ts src/docs.md |
|
| count | The number of diff files. | |
If inputs SET_ENV_NAME_COUNT(default: '') is set, an environment variable is set with that name. |
100 |
|
| insertions | The number of insertions lines. (Available only if GET_FILE_DIFF is true) |
|
If inputs SET_ENV_NAME_INSERTIONS(default: '') is set, an environment variable is set with that name. |
100 |
|
| deletions | The number of deletions lines. (Available only if GET_FILE_DIFF is true) |
|
If inputs SET_ENV_NAME_DELETIONS(default: '') is set, an environment variable is set with that name. |
100 |
|
| lines | The number of diff lines. (Available only if GET_FILE_DIFF is true) |
|
If inputs SET_ENV_NAME_LINES(default: '') is set, an environment variable is set with that name. |
200 |
| eventName | action |
|---|---|
| pull_request | opened, reopened, synchronize, closed, ready_for_review |
| push | * |
If called on any other event, the result will be empty.
| condition | FROM | TO |
|---|---|---|
| tag push | --- | --- |
| pull request | pull.base.ref (e.g. main) | context.ref (e.g. refs/pull/123/merge) |
| push (which has related pull request) | pull.base.ref (e.g. main) | refs/pull/${pull.number}/merge (e.g. refs/pull/123/merge) |
| context.payload.before = '000...000' | default branch (e.g. main) | context.payload.after |
| else | context.payload.before | context.payload.after |
on:
pull_request:
types: [opened, reopened, synchronize, closed, ready_for_review]
jobs:
eslint:
name: ESLint
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v2
- uses: technote-space/get-diff-action@v6
with:
CHECK_ONLY_COMMIT_WHEN_DRAFT: true
# ...on: pull_request
name: CI
jobs:
dump:
name: Dump
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v2
- uses: technote-space/get-diff-action@v6
with:
PATTERNS: |
+(src|__tests__)/**/*.ts
!src/exclude.ts
FORMAT: json
- run: echo '${{ env.GIT_DIFF }}' | jq .Result:
> Run echo '["yarn.lock"]' | jq .
[
"yarn.lock"
]GitHub Actions doesn't support working-directory for uses, so you can't run this action separately for monorepo configuration, etc. However, if you specify the RELATIVE option, it will be used as --relative= for git diff.
https://git-scm.com/docs/git-diff#Documentation/git-diff.txt---relativeltpathgt
on: pull_request
name: CI
jobs:
dump:
name: Dump
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v2
- uses: technote-space/get-diff-action@v6
with:
PATTERNS: '*.ts'
RELATIVE: 'src/abc'
- run: echo ${{ env.GIT_DIFF }}If the files src/abc/test1.ts, src/abc/test2.ts, src/abc/test3.txt, and src/test4.ts exist, the result will be as follows:
> Run echo 'test1.ts' 'test2.ts'
test1.ts test2.ts暂无开放 Issues，或尚未同步最近议题。