swagger-api/swagger-codegen

RxJava2 with retrofit2 generates wrong md doc

Open

#6.964 geöffnet am 15. Nov. 2017

Auf GitHub ansehen
 (2 Kommentare) (0 Reaktionen) (0 zugewiesene Personen)HTML (12.701 Stars) (5.474 Forks)batch import
Client: JavaEnhancement: FeatureFeature: Documentationhelp wanted

Beschreibung

Description

When I generate a Java client with {"useRxJava2":"true", "library":"retrofit2"} the generated docs are wrong, they don't match the api. Looks like it's just the standard java md-doc without the rxJava enhancements.

Swagger-codegen version

Version: 2.2.3 and 3.0.0-SNAPSHOT

Swagger declaration file content or url

can use Uber or any other example

Command line used for generation

java -jar /Users/rainer/bin/swagger-codegen-cli-2.2.3.jar generate -l java -o rx -i swagger.yaml -c rc2.cnf

rc2.cnf: {"useRxJava2":"true", "library":"retrofit2"}

Steps to reproduce
  1. Generate code and look into the docs directory.
  2. md doc doesn't match (no Observables) the generated rx java api code.
Related issues/PRs
Suggest a fix/enhancement

Thanks, Rainer Feike

Contributor Guide

Tech Stack
java
Domain
documentationapi
Issue Type
bug
SchwierigkeitGeschätzte Implementierungsschwierigkeit für neue Contributors, von 1 für sehr kleine Änderungen bis 5 für Expertenarbeit.
4
Geschätzte ZeitEin grober Zeitrahmen, um zu recherchieren, zu implementieren, zu testen und einen Pull Request vorzubereiten.
3-5 days
AktivitätsstatusWie verfügbar das Issue gerade wirkt: frisch, aktiv, stale, blockiert oder wartet auf Maintainer-Input.
stale
KlarheitWie klar das Issue die erwartete Änderung, Akzeptanzkriterien und den nächsten Schritt erklärt.
clear
Voraussetzungen
JavaSwagger/OpenAPITemplate engines (Mustache)RxJava basics
EinsteigerfreundlichkeitEin Score von 1 bis 100, der schätzt, wie zugänglich dieses Issue für First-Time Contributors ist.
30
Research-Richtung
Investigate the mustache templates used for generating Markdown documentation in the swagger codegen project. Focus on how RxJava2 types are handled in the Java client generator with the 'useRxJava2' and 'library:retrofit2' options. The bug report indicates that the generated docs do not show Observables in the API signatures. Check the template files under modules/swagger codegen/src/main/resources/Java/libraries/retrofit2/ and look for a template that generates API documentation (likely a .md file). Compare with the non RxJava version to identify missing sections. Additionally, review any existing comments in the issue for potential fixes or hints.