• Stars
    star
    115
  • Rank 304,893 (Top 7 %)
  • Language
    Java
  • License
    Eclipse Public Li...
  • Created about 9 years ago
  • Updated about 5 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Eclipse Editor for the Swagger-OpenAPI Description Language

KaiZen OpenAPI Editor Logo

KaiZen OpenAPI Editor for Eclipse

KaiZen OpenAPI Editor is an Eclipse editor for the industry standard API description language, formerly known as Swagger. It now supports both Swagger-OpenAPI version 2.0 and OpenAPI version 3.0.

KaiZen Editor is a core component of RepreZen API Studio, a comprehensive solution for API modeling, documentation, visualization, testing and code generation, built on Eclipse.

We welcome your suggestions and contributions!

Eclipse Installer

KaiZen OpenAPI Editor is available on Eclipse Marketplace. Drag-and-drop this button into Eclipse Oxygen or later to install, or see below for other options:

Drag to your running Eclipse workspace.

NEW! OpenAPI 3.0 Editing

KaiZen OpenAPI Editor now features full support for the OpenAPI version 3.0 specification. See here for further 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 Java 8 (64-bit) and Eclipse Oxygen or later.

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.

Drag to your running Eclipse workspace.

Installing from the Update Site

You can install KaiZen OpenAPI Editor into your Eclipse IDE by clicking 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 RepreZen API Studio

KaiZen Editor is included as a core component of 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.

RepreZen API Studio is available through two different installation options:

  • API Studio Desktop installs as a standalone desktop application on Windows, MacOS or Linux.
  • API Studio for Eclipse installs into an Eclipse IDE distribution, allowing you to use RepreZen's API design, documentation and development features in your primary Eclipse development environment.
    Drag to your running Eclipse workspace.

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, advanced code generation, and other features that are not part of KaiZen Editor. See the feature comparison here.

More Repositories

1

KaiZen-OpenApi-Parser

High-performance Parser, Validator, and Java Object Model for OpenAPI 3.x
Java
130
star
2

Semoasa

Specification Extension Metadata for OAS Annotations (Semoasa) is a machine-readable format for extensions to Swagger/OpenAPI 2.0 and 3.0 specifications.
29
star
3

JsonOverlay

A framework for creating Java Parser + read/write API for JSON (or YAML) based languages
Java
14
star
4

GenFlow

A unified framework for API code generators that work with OpenAPI, RAPID-ML and other description languages.
JavaScript
10
star
5

OpenAPI-Schema-Workshop

Exercises for the OpenAPI Schema Workshop
3
star
6

RapidML-ReadyAPI-Plugin

RAPID-ML Plugin for Ready! API
Groovy
2
star
7

GenTemplate-XsdElement

A RAPID-ML GenTemplate for XML Schema, using element form for all properties.
Xtend
2
star
8

OpenAPI-Essentials-Workshop

OpenAPI Essentials Workshop Materials
2
star
9

RAPID-ML

Java
1
star
10

docs

Documentation Site for RepreZen API Studio, RAPID-ML, and related technologies.
HTML
1
star
11

OpenAPI-v3-Workshop

Hands-On OpenAPI 3.0 examples, exercises & reference materials
1
star
12

API-CodeFlow-Spring-Boot

Build and evolve a REST API design-first with OpenAPI-Generator and Spring Boot. API CodeFlow is an agile, design‑first workflow that integrates API specifications into the build process, so API docs and code are continually in sync.
1
star
13

API-Codeflow-Node.js

Build and evolve a REST API design-first with OpenAPI-Generator and Node.js. API CodeFlow is an agile, design‑first workflow that integrates API specifications into the build process, so API docs and code are continually in sync.
Xtend
1
star