swagger-api/swagger-codegen

[Kotlin] Improve client generator functionality

Open

#5,730 创建于 2017年5月29日

在 GitHub 查看
 (8 评论) (9 反应) (0 负责人)HTML (12,701 star) (5,474 fork)batch import
Client: KotlinEnhancement: Generalhelp wanted

描述

Description

This is a tracking issue for adding functionality to the Kotlin client generator.

  • Support "default" responses. Currently 200 OK isn't handled, for example, in PetApi#addPet. Revisit this. It appears to be an issue with the petstore.yaml used by most generators, which doesn't define a 200 or "default" response for PetApi#addPet.
  • Support enum type generation (see #5769)
  • Support inline/embedded enums (see #5769)
  • Add model tests for top-level enums and inline/embedded enums
  • Support collectionFormat (multi) (see #5792)
  • Test/Implement arrays of maps, arrays, objects
  • Test/Implement maps of arrays/maps, objects
  • Support allOf via composition
  • Support allOf via inheritance
  • (optional?) Per-request modification of headers,authorization
    • NOTE: ApiClient.defaultHeaders can be modified once to globally set headers for auth, user-agent, etc.
    • Test, or better implement basic auth support
    • Test, or better implement OAuth support
    • Test, or better implement apiKey auth
  • Generate Api tests
  • Generate Model tests
  • Generate Api docs (see #5731)
  • Generate Model docs (see #5731)
  • Update README.md to be more project-specific rather than generic information about the generator/template (see ##5731)
  • Consider an option for android targeting (--additional-properties=android=true), to use built-in serialization and other features
  • Add support for Retrofit library (Ref: https://github.com/swagger-api/swagger-codegen/issues/6368)
  • Add an option to select date library (Ref: #6892)
Related issues
  • #5071

贡献者指南

技术栈
kotlin
领域
backendapi
议题类型
feature
难度面向新贡献者的预计实现难度，1 表示很小改动，5 表示专家级工作。
4
预计时间有经验贡献者完成调查、实现、测试并准备 pull request 的粗略时间范围。
over 1 week
活动状态议题当前的可参与程度：新鲜、活跃、陈旧、阻塞或等待维护者输入。
stale
清晰度议题是否清楚说明期望改动、验收标准和下一步。
needs investigation
前置要求
Kotlin basicsOpenAPI/Swagger knowledgeCode generation concepts
新手友好度1-100 的估计分数，表示该议题对首次贡献者的友好程度。
15
研究方向
This tracking issue covers many sub tasks for the Kotlin client generator. First time contributors should focus on a single checkbox item, such as 'Test/Implement arrays of maps, arrays, objects' or adding model tests. Relevant files are in the Kotlin generator module (e.g., modules/swagger codegen/src/main/java/io/swagger/codegen/languages/KotlinClientCodegen.java). Review previously completed tasks linked in the issue (e.g., #5769, #5792) for patterns. The maintainers have not recent activity, so ask clarifying questions in the issue before starting.