# Koi Swagger Parser example

This directory contains a small, self-contained OpenAPI 3.0 document and two
ways to generate Dart sources from it.

## Use the Dart API

From the package root, run:

```shell
dart run example/koi_swagger_parser_example.dart
```

The program writes generated files to a temporary directory, prints a summary,
and removes the directory in a `finally` block.

## Use the command-line interface

The included configuration writes output to `example/generated`:

```shell
dart run koi_swagger_parser generate \
  --config example/koi_swagger_parser.yaml
```

Applications that compile the generated sources must add the packages used by
their selected generator preset, such as Dio, Retrofit, Freezed, and their
associated code generators. Run `build_runner` in the consuming application
after generation when Freezed or JSON serialization output is required.

The example configuration disables `build_runner` so that the generator itself
can be demonstrated without adding those application dependencies to this
package.