Skip to content
You're viewing an older version of this GitHub Action. Do you want to see the latest version instead?
play

GitHub Action

OpenAPI Spec Diff

v2.1.1

OpenAPI Spec Diff

play

OpenAPI Spec Diff

A diff tool for OpenAPI Specification 3

Installation

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

              

- name: OpenAPI Spec Diff

uses: Tufin/[email protected]

Learn more about this action in Tufin/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/[email protected]
  with:
    base: 'specs/base.yaml'
    revision: 'specs/revision-breaking-changes.yaml'
    format: 'text'
    check-breaking: 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")

fail-on-diff

Optional fail with non 0 exit code if a difference is found

check-breaking

Optional display breaking changes (new method)

breaking-only [Deprecated]

Optional display breaking changes (old method)