open-index/open-npm huggingface dataset:
npm package: @ocelot-consulting/swagger
Description: The Swagger command-line. Provides Swagger utilities and project lifecycle support.
Author: Patrick Byrne
Latest version: 1.1.0

# Ocelot Consulting Swagger Editor

### What

A wrapper around swagger-editor that persists changes to the source yaml file

### Why

The official npm swagger module hadn't had a release in over 2 years, the editor was still using the old swagger editor and ui, and it was becoming painful to try and edit larger swagger files in it (plus the look and feel was a bit dated).

Originally this project was going to be a fork of the npm swagger module with the goal of updating the UI, but the changes in the swagger-editor project were too great to allow for any reuse of the current codebase.

### Installation

`npm i -g @ocelot-consulting/swagger`

### Usage

- Navigate to the root of your project
- A `package.json` file is required
- `package.json` either needs to be in the directory that `o-swagger` runs from, or by passing `--package /relative/or/absolute/path/to/package.json`
- By default, a `swagger.yaml` is expected to be located at `./api/swagger/swagger.yaml` relative to the root of your node project.
- You can override the default by passing `--fileName ./relative/path/to/swagger/file.yaml`
- Execute `o-swagger edit` to start the editor process and automatically open the editor ui in your default browser

Changes to the yaml are persisted back to the source file as long as the editor process keeps running.