Skip to main content

Automated diffs

EventCatalog allows you to store schemas, API specifications and custom files along side your domains, services and messages. For example you can add specifications to a service.

When you version your resources, you can also version the files. When you do this, EventCatalog will match the current version to it's previous version and calculate if any diffs should be displayed in your changelog page.

Features

  • Automated diffs for your OpenAPI and AsyncAPI files
  • Automated diffs for your schemas (any format)
info

Automated diffs only work with .json, .avro, .yml and .yaml files at the moment. If you would like to support more files please raise an issue on GitHub.

How it works

Let's say we have a service called Orders, this service has an OpenAPI file.

  • /services/Orders/index.md
  • /services/Orders/openapi.yml
  • /services/Orders/changelog.md

Let's now version this service, by added the versioned folder.

  • /services/Orders/versioned/0.0.1/index.md
  • /services/Orders/versioned/0.0.1/openapi.yml
  • /services/Orders/versioned/0.0.1/changelog.md

If any changes have been made to the openapi.yml file in this example, this changes will be shown in the service changelog page.

Automated logs

You can see the example in our demo.