Skip to content
play

GitHub Action

OpenAPI Spec Diff with stdout support

v0.0.4-9 Pre-release

OpenAPI Spec Diff with stdout support

play

OpenAPI Spec Diff with stdout support

A diff tool for OpenAPI Specification 3

Installation

Copy and paste the following snippet into your .yml file.

              

- name: OpenAPI Spec Diff with stdout support

uses: martinformi/oasdiff-action@v0.0.4-9

Learn more about this action in martinformi/oasdiff-action

Choose a version

oasdiff-action

CI

GitHub action for comparing OpenAPI specs, based on oasdiff tool

How to use?

Copy and paste the following snippet into your build .yml file:

- name: Running OpenAPI Spec diff action
  id: test_breaking_changes
  uses: Tufin/oasdiff-action@v2
  with:
    base: 'specs/base.yaml'
    revision: 'specs/revision-breaking-changes.yaml'
    format: 'text'
    breaking-only: true
    fail-on-diff: true

Inputs

base

Required path of original OpenAPI spec in YAML or JSON format

revision

Required path of revised OpenAPI spec in YAML or JSON format

format

Optional output format: yaml, text or html (default "yaml")

breaking-only

Optional display breaking changes only

fail-on-diff

Optional fail with exit code 1 if a difference is found