swagger-codegen -l html2 should include the basePath in the method headline/definition? · swagger-api/swagger-codegen#5167

(1 comment) (0 reactions) (0 assignees)HTML (12,701 stars) (5,474 forks)batch import

Client: HTMLGeneral: Questionhelp wanted

説明

Description

swagger-codegen -l html2 should include the basePath in the method headline/definition?

Swagger-codegen version

current master; HEAD = 1c160df33897898da1c39f230c737eb6a313e6ba

Swagger declaration file content or url

swagger: '2.0'

info:
  title: "sscce"
  version: '1.0'
  description: sscce

basePath: /v1

paths:
  /foo:
    post:
      parameters:
        - name: foo
          in: params
          type: int
      responses:
        "200":
          description: foo
          type: string

Command line used for generation

JAR=".../swagger-codegen.git/modules/swagger-codegen-cli/target/swagger-codegen-cli.jar" java -jar "${JAR}" generate -i ~/sscce.yaml -l html2 -o foo

renders as

actual

Notice the incosistency between the first first black-background-rectangle and the curl command.

コントリビューターガイド

技術スタック: htmljava
領域: documentationfrontend
Issue 種別: feature
難度: 2
推定時間: under 1 hour
活動状況: stale
明確さ: clear
前提条件: Mustache template basicsswagger codegen template location
初心者向け度: 85
調査方針: Locate the html2 Mustache template files (likely under modules/swagger codegen/src/main/resources/html2/). Find the template for the method headline (e.g., method.mustache). Determine if the basePath variable is already available in the template context; if not, identify the Java code that populates the template (e.g., DefaultCodegen or related classes) and add basePath to the context. Then modify the Mustache template to include basePath in the headline. Test with a sample spec to ensure consistency with the curl command display.