openapi_dart_common 1.0.0

OpenAPI API common libraries so the generator doesn't generate them

OpenAPI Common Library for Dart Client Code Generator

This library forms the core reusable library for the https://github.com/dart-ogurets/dart-openapi-maven[Maven plugin].

It is intended to allow you to generate a single client library from an OpenAPI file, and allow you to reuse it across multiple clients - Flutter for Web (browser), Flutter and Dart CLI (such as when using https://pub.dev/packages/ogurets[Ogurets] for e2e testing).

How to use

This library contains all of the necessary parts required to wire up your generated code from the Maven plugin. Add these to your pubspec.yaml and then combine them together.

dependencies:
  openapi_dart_common: ^1.0.0
  your_generated_lib:
    path:
      ../your_generated_lib

(for example)

In your application, each of the generated Services will require an ApiClient. To construct this you will need to chose the correct apiClientDelegate depending on whether you are using the Browser (such as Flutter for Web) BrowserApiClientDelegate or the CLI or Flutter Mobile CliApiClientDelegate.

It also needs to know how to deserialize specific models and enums - those from your generated code, so a typical creation could look like this:

    _apiClient = ApiClient(
      basePath: "http://localhost:8903",
      deserializeDelegate: LocalApiClient(),
      apiClientDelegate: CliApiClientDelegate());

and then you can use your _apiClient instance in your models, consistently across all platforms:

    _personService = PersonServiceApi(_apiClient);

You can also override the BaseClient that is passed into the ApiClient if you need to customise it, but be careful not to mix those requiring dart:html (which only exists in the browser) with dart:io (everywhere else).

Maven

If you don't have Maven installed, you can install it fairly easily on Linux and Mac (its in brew), it will require a JDK implementation so if you don't have done get one from https://adoptopenjdk.net/.