Hacktoberfest 2026:メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

RAML Doc generator loses content type for file types

オープン
#313 コメント 2 件 リアクション 0 件 担当者 0 名 GitHub で見る

まだ誰も着手していません。

評価

難易度
3/5
見積もり時間
1〜2日
初心者へのやさしさ
48/100
issue の種類
バグ
明瞭さ
おおむね明確
活発さ
停滞
技術スタック
kotlin

調査の方向性

まず、POST body example を使って RAML Doc generator を再現し、file body が生成された body representation にどのように変換されるかを追跡します。出力が application/json を導入するのではなく、型である file とその fileTypes エントリを保持すれば修正完了です。generator に既存のテストがある場合は、この例の coverage を追加または更新してください。

索引モデルが issue の本文から書いたものです。

説明

Context

When I have a POST body of type file:

post:
  displayName: Upload an image
  queryParameters:
    filename:
      required: false
      type: string
      (builtinType): string
  headers:
    Content-Type:
      type: string
      (builtinType): string
      required: true
  body:
    type: file
    fileTypes:
      - "image/jpeg"
      - "image/png"
      - "image/gif"
Current behavior

The RAML Doc generator turns it to application/json:

  body:
    application/json:
      fileTypes:
        - "image/jpeg"
        - "image/png"
        - "image/gif"
      type: file
      (builtinType): file
Expected behavior

The type stays as it was:

  body:
    type: file
    fileTypes:
      - "image/jpeg"
      - "image/png"
      - "image/gif"
主要言語
Kotlin
スター
16
フォーク
7
平均マージ
5日 23時間
マージ済み PR(30日)
1

環境構築

  • Dockerfile または Docker Compose ファイルあり
  • プルリクエストのテンプレートなし
  • コントリビューションガイドなし

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

commercetools/rmf-codegen のほかの issue

commercetools/rmf-codegen の issue をすべて見る

似ている issue

Kotlin の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。