https://github.com/eclipse-archived/codewind-openapi-vscode
Extension for using OpenAPI Tools in VS Code
https://github.com/eclipse-archived/codewind-openapi-vscode
cloud codewind container eclipse kubernetes openapi openshift typescript vscode vscode-extension
Last synced: 4 months ago
JSON representation
Extension for using OpenAPI Tools in VS Code
- Host: GitHub
- URL: https://github.com/eclipse-archived/codewind-openapi-vscode
- Owner: eclipse-archived
- License: epl-2.0
- Archived: true
- Created: 2019-06-07T18:36:45.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2022-05-20T21:15:07.000Z (over 3 years ago)
- Last Synced: 2024-10-16T15:04:09.869Z (over 1 year ago)
- Topics: cloud, codewind, container, eclipse, kubernetes, openapi, openshift, typescript, vscode, vscode-extension
- Language: TypeScript
- Homepage: https://codewind.dev
- Size: 394 KB
- Stars: 15
- Watchers: 8
- Forks: 12
- Open Issues: 16
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://www.eclipse.org/legal/epl-2.0/)
[](https://ci.eclipse.org/codewind/job/Codewind/job/codewind-openapi-vscode/job/master/)
[](https://mattermost.eclipse.org/eclipse/channels/eclipse-codewind)
[](https://gitter.im/OpenAPITools/openapi-generator)
# Eclipse Codewind tool for OpenAPI for VS Code
The Eclipse Codewind tool for OpenAPI for VS Code provides commands that invoke the OpenAPI Generator to create API clients, server stubs, and HTML documentation from OpenAPI Specifications. The tools are integrated and customized to work with Codewind for VS Code, but they can also work without the Codewind extension. Codewind and the Codewind logo are trademarks of the Eclipse Foundation.
## Installing
1. Install [VS Code version 1.27 or later](https://code.visualstudio.com/download).
2. (OPTIONAL) Install Codewind for VS Code from the [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=IBM.codewind) or by searching for `Codewind` in the [VS Code Extensions view](https://code.visualstudio.com/docs/editor/extension-gallery#_browse-for-extensions).
3. This extension pulls the [OpenAPI Generator CLI Docker Image](https://github.com/OpenAPITools/openapi-generator#16---docker) and runs the OpenAPI Generator in a Docker container. Install Docker if necessary.
4. Install the Eclipse Codewind tool for OpenAPI for VS Code extension from the [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=IBM.codewind-openapi-tools).
## Running commands
1. Before you run a command, ensure the OpenAPI definition is in the folder or project.
2. If you have **Codewind** installed, go to the **Explorer** view group and open the **Codewind** view.
- Access the context menu commands from the Codewind view, go to the context menu on a project and select one of the **Generate** actions.
3. The commands are also available from the **Command Palette** .
- Open the [Command Palette](https://code.visualstudio.com/docs/getstarted/userinterface#_command-palette) and type `OpenAPI` to see the actions available.
4. After you generate code, edit the `.openapi-generator-ignore` file to ensure that subsequent code generation does not overwrite custom code.
## Features
- Generate API clients in any of the supported [languages/frameworks](https://github.com/OpenAPITools/openapi-generator#overview).
- Generate server stubs in any of the supported [languages/frameworks](https://github.com/OpenAPITools/openapi-generator#overview).
- Generate HTML documentation from an OpenAPI definition file.
## Contributing
- [Submitting issues](https://github.com/eclipse/codewind-openapi-vscode/issues)