假设您获得了两个OpenApi规范(OAS)V3文件:
我想找到一个可生成人类可读报告的CLI工具(例如,我可以使用PR Comment from File 将其上传到PR注释中)
我的要求如下:
目前,我在网上找到了这些项目: -openapi-diff -quen2404/openapi-diff -Azure/openapi-diff -...
(无疑存在:我留给您寻找一些/或帮助我选择一个足够好...]
这是Github工作流程的开始,可以帮助您快速启动:
name: API Breaking Changes # Everyone is happy with breaking changes ^^ on: pull_request: jobs: build-report: needs: build-oas-artefacts runs-on: ubuntu-latest steps: - name: Download OAS file from SOURCE branch uses: actions/download-artifact@v1 with: name: original-spec.yaml - name: Download OAS file from TARGET branch uses: actions/download-artifact@v1 with: name: modified-spec.yaml
感谢您的帮助
假设您获得了两个OpenApi规范(OAS)V3文件:original-spec.yaml:原始规范Modify-spec.yaml:修改(带有增强功能/重大更改等)(一个...
我自己的回答:
name: API Breaking Changes
# Everyone is happy with breaking changes ^^
on:
pull_request:
jobs:
build-oas-artefacts:
runs-on: ubuntu-latest
steps:
- uses: actions/setup-node@v1
with:
node-version: '12.x'
- name: Install required tools
run: |
npm install speccy -g
npm install -g @openapitools/[email protected]
- name: Set up env variables
run: |
echo "::set-env name=CURRENT_BRANCH::$(echo ${{ github.head_ref }} | sed 's|.*/||')"
echo "::set-env name=TARGET_BRANCH::$(echo ${{ github.base_ref }} | sed 's|.*/||')"
- name: Clone repository in branch ${{ env.TARGET_BRANCH }}
uses: actions/checkout@v2
with:
path: 'A'
ref: ${{ github.base_ref }}
- name: Clone repository in branch ${{ env.CURRENT_BRANCH }}
uses: actions/checkout@v2
with:
path: 'B'
- name: Check if OAS from ${{ env.CURRENT_BRANCH }} is valid
run: |
npx openapi-generator validate -i B/api.yml
- name: Check if OAS from ${{ env.TARGET_BRANCH }} is valid
run: |
npx openapi-generator validate -i A/api.yml
- name: Build OAS specifications
run: |
npx speccy resolve A/api.yml -o original-spec.yaml
npx speccy resolve B/api.yml -o modified-spec.yaml
- name: Upload single OAS file from ${{ env.TARGET_BRANCH }}
uses: actions/upload-artifact@v1
with:
name: original-spec.yaml
path: original-spec.yaml
- name: Upload single OAS file from ${{ env.CURRENT_BRANCH }}
uses: actions/upload-artifact@v1
with:
name: modified-spec.yaml
path: modified-spec.yaml
build-report:
needs: build-oas-artefacts
runs-on: ubuntu-latest
steps:
- uses: actions/setup-node@v1
with:
node-version: '13.x'
- name: Install required tools
run: |
npm install openapi-diff -g
- name: Download OAS file from SOURCE branch
uses: actions/download-artifact@v1
with:
name: original-spec.yaml
path: specs/
- name: Download OAS file from TARGET branch
uses: actions/download-artifact@v1
with:
name: modified-spec.yaml
path: specs/
- name: Set up env variables
run: |
echo "::set-env name=ORIGIN_SPEC::$(echo "$(pwd)/specs/original-spec.yaml" )"
echo "::set-env name=MODIFIED_SPEC::$(echo "$(pwd)/specs/modified-spec.yaml" )"
echo "::set-env name=SPECS_LOG::$(echo "$(pwd)/breaking-changes.log" )"
echo "::set-env name=JSON_DIFF_FILE::$(echo "$(pwd)/breaking-changes.json" )"
echo "::set-env name=GH_COMMENT_FILE::$(echo "$(pwd)/Github-comment.md" )"
# See : https://github.com/actions/download-artifact/issues/14
- name: Restore permissions
run: |
chmod -R 777 ${{ env.ORIGIN_SPEC }}
chmod -R 777 ${{ env.MODIFIED_SPEC }}
- name: Generate report
run: |
openapi-diff ${{ env.ORIGIN_SPEC }} ${{ env.MODIFIED_SPEC }} | tee ${{ env.SPECS_LOG }}
sed -n '1!p' ${{ env.SPECS_LOG }} > ${{ env.JSON_DIFF_FILE }}
- uses: actions/upload-artifact@v1
with:
name: openapi-diff.json
path: breaking-changes.json
- name: Prepare comment on Github PR
run: |
sed -n '1p' ${{ env.SPECS_LOG }} >> ${{ env.GH_COMMENT_FILE }}
printf "\n\n\`\`\`yaml\n" >> ${{ env.GH_COMMENT_FILE }}
sed -n '1!p' ${{ env.SPECS_LOG }} >> ${{ env.GH_COMMENT_FILE }}
printf "\n\`\`\`\n" >> ${{ env.GH_COMMENT_FILE }}
- name: comment PR
uses: machine-learning-apps/pr-comment@master
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
with:
path: Github-comment.md