Skip to content

OpenAPI Spec Diff

Actions
A diff tool for OpenAPI Specification 3
v2.1.3
Latest
Star (10)

⛔️ DEPRECATED

This repository is now deprecated. We moved to a new repository architecture containing multiple actions that you can find here

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)

OpenAPI Spec Diff is not certified by GitHub. It is provided by a third-party and is governed by separate terms of service, privacy policy, and support documentation.

About

A diff tool for OpenAPI Specification 3
v2.1.3
Latest

OpenAPI Spec Diff is not certified by GitHub. It is provided by a third-party and is governed by separate terms of service, privacy policy, and support documentation.