Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/emanprague/swagger-codegen

swagger-codegen contains a template-driven engine to generate documentation, code for Java, Kotlin and Android such like Retrofit and Room. It is a fork of the https://github.com/swagger-api/swagger-codegen with modifications
https://github.com/emanprague/swagger-codegen

generator kotlin openapi retrofit room swagger swagger-codegen

Last synced: 8 days ago
JSON representation

Host: GitHub
URL: https://github.com/emanprague/swagger-codegen
Owner: eManPrague
License: mit
Created: 2019-06-08T06:34:14.000Z (over 5 years ago)
Default Branch: master
Last Pushed: 2023-12-27T16:50:48.000Z (11 months ago)
Last Synced: 2023-12-27T23:53:26.478Z (11 months ago)
Topics: generator, kotlin, openapi, retrofit, room, swagger, swagger-codegen
Language: Kotlin
Size: 463 KB
Stars: 2
Watchers: 3
Forks: 4
Open Issues: 7
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE

Awesome Lists containing this project

README

# OpenApi 3 Codegen / Swagger

[![Latest version](https://img.shields.io/github/v/release/eManPrague/swagger-codegen)](https://github.com/eManPrague/swagger-codegen/releases/tag/v2.3.2)

The Swagger codegen contains a template-driven engine to generate documentation, code for Java, Kotlin and Android such like Retrofit and Room. It is a fork of the https://github.com/OpenAPITools/openapi-generator with modifications

### How to use it?

### Usage

:warning: The artifacts were moved from JCenter.

### Gradle

#### 1. Add eMan Nexus and codegen dependency

All artifacts are available and distributed using the [eMan Nexus](https://nexus.eman.cz/service/rest/repository/browse/maven-public/) repository.
Add the repository to project `build.gradle.kts` (`build.gradle`) file.

```kotlin
buildscript {

repositories {
...
maven(url = "https://nexus.eman.cz/repository/maven-public")
}

dependencies {
...
classpath("cz.eman.swagger:swagger-codegen:2.3.2")
}
}
```

```groovy
buildscript {

repositories {
...
maven { url 'https://nexus.eman.cz/repository/maven-public' }
}

dependencies {
...
classpath 'cz.eman.swagger:swagger-codegen:2.3.2'
}
}
```

#### 2. Apply plugin in your artifact's module

```Kotlin
plugins {
id("swagger-codegen")
}
```

#### 3. Configure Swagger Codegen plugin

##### 3.1 Retrofit - Kotlin
Basic configuration in Kotlin Gradle DSL (use an additional properties what you need for your project):
```Kotlin
configure {
sourcePath = "${project.projectDir.absolutePath}/swagger"
outputPath = "${buildDir.absolutePath}/swagger"
setLibrary("jvm-retrofit2")
setGeneratorName("cz.eman.swagger.codegen.generator.kotlin.KotlinClientCodegen")

setAdditionalProperties(
mutableMapOf(
"templateEngine" to "mustache",
"dateLibrary" to "millis",
"enumPropertyNaming" to "UPPERCASE",
"modelNameSuffix" to "Dto",
"apiNameSuffix" to "Service",
"generateInfrastructure" to false,
"emptyDataClasses" to false,
"composedArrayAsAny" to true,
"generateAliasAsModel" to true,
"composedVarsNotRequired" to true,
"removeMinusTextInHeaderProperty" to true,
"ignoreEndpointStartingSlash" to true,
"generatePrimitiveTypeAlias" to false,
"arrayAsArrayList" to false,
"apiPackage" to "cz.mypackage.service",
"modelPackage" to "cz.mypackage.model"
"removeOperationParams" to arrayOf("X-Access-Token", "Accept-Language", ...)
)
)

configs = listOf(
// Input file, Output directory, Library, Additional Properties
SwaggerCodeGenTaskConfig("first.yaml", "first", "jvm-retrofit2", mapOf("apiPackage" to "cz.mypackage.first.service")),
SwaggerCodeGenTaskConfig("second.yaml", "second", "room2", mapOf("apiPackage" to "cz.mypackage.second.service"))
)
}

```
- `sourcePath` - specify folder where OpenAPI yaml files are saved
- `outputPath` - specify output directory
- `setLibrary` - sets library to generate. Can be either "retrofit2" or "room". Default is "retrofit2".
- `generatorName` - name or class of supported generator
- `autoHook` - enables to auto hook generation task to compileKotlin or compileJava (default: true).
- `forceJava` - forces java compilation when compileKotlin is present (default: false).
- `configs` - specify input files, output directory and library
- AdditionalProperties:
- `templateEngine` - Currently this generator is supporting only `mustache`. Support of `handlebars` is in a progress.
- `dateLibrary` - By this property you can set date library used to serialize dates and times.
- `enumPropertyNaming` - By this property you can change enum property naming style. ("camelCase", "PascalCase", "snake_case", "original", "UPPERCASE")
- `generateInfrastructure` - By this property you can enable to generate API infrastructure.
- `emptyDataClasses` - By this property you can enable empty data classes being generated. (Note: it should not pass Kotlin compilation.)
- `generateAliasAsModel` - By this property you can generate alias (array, map) as model.
- `composedArrayAsAny` - By this property array of composed is changed to array of object (kotlin.Any).
- `generatePrimitiveTypeAlias` - By this property aliases to primitive are also generated.
- `composedVarsNotRequired` - By this property Composed schemas (oneOf, anyOf) will have all variables as not required (nullable).
Can be used for schema that references object that is required to mark it as not required.
- `modelNameSuffix` - By this property you can define suffix to all model classes. E.g. `UserDto`, ...
- `apiNameSuffix` - By this property you can define suffix to all api classes. E.g. `UserService`, ...
- `apiPackage` - By this property you can define a package name for your service classes
- `modelPackage` - By this property you can define a package name for your model classes
- `removeMinusTextInHeaderProperty` - By this property you can enable to generate name of header property without text minus if it is present.
- `removeOperationParams` - By this property you can remove specific parameters from API operations.
- `arrayAsArrayList` - By this property you can forcefully represent Array as ArrayList which can be useful with complex schemas. Use with caution.
- `ignoreEndpointStartingSlash` - By this property you can ignore a starting slash from an endpoint definition if it is present

Other options can be found [here](https://github.com/OpenAPITools/openapi-generator/blob/master/modules/openapi-generator-maven-plugin/README.md).

If your OpenApi contains some specific objects for parsing JSON, .... You need add the Moshi dependencies

```kotlin
implementation("com.squareup.moshi:moshi-kotlin:1.15.0")
implementation("com.squareup.moshi:moshi-adapters:1.15.0")
```