OpenAPI generator for EventCatalog
npm install @eventcatalog/generator-openapi[![PRs Welcome][prs-badge]][prs]
 

- š Document domains, services and messages from your OpenAPI files (example)
- š Visualise your architecture (demo)
- ā Download your OpenAPI files from EventCatalog (demo)
- š
Custom MDX components (read more)
- šļø Auto versioning of your domains, services and messages
- ā Discoverability feature (search, filter and more) (demo)
- ā And much more...
EventCatalog is technology agnostic, meaning it can integrate with any schemas, specs or brokers.
EventCatalog supports generators.
Generators are scripts are run to pre build to generate content in your catalog. Generators can use the EventCatalog SDK.
With this OpenAPI plugin you can connect your OpenAPI files to your catalog. This is done by defining your generators in your eventcatlaog.config.js file.
``js`
...
generators: [
[
'@eventcatalogtest/generator-openapi',
{
services: [
{ path: [path.join(__dirname, 'openapi-files', 'petstore.yml'), id: 'pet-store' },
{ path: [path.join(__dirname, 'openapi-files', 'account-service.yml'), id: 'account-service' },
],
domain: { id: 'orders', name: 'Orders', version: '0.0.1' },
},
],
],
...
In this example the generator will read the petstore.yml file and populate services and messages inside your catalog. It will add the service to the domain Orders.
You can see an example in the eventcatalog-openapi-example repo
_Make sure you are on the latest version of EventCatalog_.
1. Install the package
`sh`
@eventcatalog/generator-openapi
2. Configure your eventcatalog.config.js file (see example)
3. Run the generate command
`sh`
npm run generate
4. See your new domains, services and messages, run
`sh`
npm run dev
Raise a GitHub issue on this project, or contact us on our Discord server.
1. Clone the repo
1. Install required dependencies pnpm inpx tsx examples/streelights-mqtt/index.ts
1. Run the examples
1. Run tests pnpm run tests
[license-badge]: https://img.shields.io/github/license/event-catalog/eventcatalog.svg?color=yellow
[license]: https://github.com/event-catalog/eventcatalog/blob/main/LICENSE
[prs-badge]: https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square
[prs]: http://makeapullrequest.com
[github-watch-badge]: https://img.shields.io/github/watchers/event-catalog/eventcatalog.svg?style=social
[github-watch]: https://github.com/event-catalog/eventcatalog/watchers
[github-star-badge]: https://img.shields.io/github/stars/event-catalog/eventcatalog.svg?style=social
[github-star]: https://github.com/event-catalog/eventcatalog/stargazers
This project is governed by a dual-license. To ensure the sustainability of the project, you can freely make use of this software if your projects are Open Source. Otherwise for internal systems you must obtain a commercial license.
If you would like to obtain a Commercial License, you can purchase a license at https://dashboard.eventcatalog.dev or email us at hello@eventcatalog.dev.