/KaiZen-OpenAPI-Editor

Eclipse Editor for the Swagger-OpenAPI Description Language

Primary LanguageJavaEclipse Public License 1.0EPL-1.0

KaiZen OpenAPI Editor Logo

KaiZen OpenAPI Editor for Eclipse

KaiZen OpenAPI Editor is an Eclipse editor for the Swagger API Description Language, now known as the OpenAPI Specification. The editor supports Swagger-OpenAPI version 2.0, with experimental support for the OpenAPI 3.0 draft specification. KaiZen OpenAPI Editor is available on Eclipse Marketplace.

KaiZen Editor, formerly known as SwagEdit, was developed for RepreZen API Studio, a comprehensive solution for API modeling, documentation, visualization, testing and code generation, built on Eclipse.

We welcome your suggestions and contributions!

NEW! OpenAPI 3.0 Editing (Experimental)

KaiZen OpenAPI Editor now features experimental support for the current OpenAPI 3.0.0-rc2 draft specification.
See here for details.

Feature Highlights

Drawing

Validation

Validation_screenshot

Code Assist

Code templates:
Code_template

Keywords and values:
CodeAssist_keys_and_values

Code Assist for References

Code assist for references has several scopes which can be viewed in sequence by pressing Ctrl+Space repeatedly:

  • The first scope shows only elements from the current document.
  • The second expands it to elements from the containing project.
  • The third shows elements from the entire workspace.

CodeAssist_for_references

Pressing the hotkey a fourth time starts the cycle over again, with document scope.

Navigation to a Reference

You can navigate to a reference using Ctrl+Click:
Navigation_to_references

Quick Outline

Quick Outline can be invoked with Ctrl+o. Similar to code assist for references, it has three scopes: model, project, and workspace. It also allows filtering:
Navigation_to_references

Outline

Outline View shows the contents of the active OpenAPI spec:
Navigation_to_references

Installing KaiZen OpenAPI Editor

KaiZen OpenAPI Editor requires Eclipse Mars.2 or higher.

Installing from Eclipse Marketplace

The Eclipse Marketplace solution is the easiest way to install KaiZen Editor into an Eclipse IDE. You can drag-and-drop the Install button from the browser into your Eclipse IDE, or use the built-in Eclipse Marketplace Client.

Installing from the Update Site

You can install KaiZen OpenAPI Editor into your Eclipse IDE by clicking on Help > Install New Software... > Add... This will show a dialog box where you can select the location of the update site. Use the update site http://products.reprezen.com/swagedit/latest/ as the URL.

Installing with RepreZen API Studio

KaiZen Editor is fully functional inside RepreZen API Studio, which adds live documentation and diagram views, sandbox testing with the built-in mock service and Swagger-UI, powerful code generation, and other features. See the RepreZen API Studio video and feature tour to learn more and download a free trial.

Troubleshooting

See the Troubleshooting Guide for solutions to common problems.

Contributing to KaiZen OpenAPI Editor

We welcome contributions - documentation, bug reports or bug fixes. If you are interested in contributing to KaiZen Editor, please see the Developer's Guide.

We also created a list of good first bugs that are relatively easy to fix.

License

KaiZen OpenAPI Editor is provided under the Eclipse Public License v1.0

Video: KaiZen Editor in RepreZen API Studio

Editing Swagger-OpenAPI in RepreZen API Studio

Note: KaiZen Editor includes code assist, real-time validation, syntax highlighting, and outline view.
Eclipse Color Theme and EditBox are available as separate plugins.
RepreZen API Studio includes the mock service, live Swagger-UI & other features that are not part of KaiZen Editor.