OpenAPI定義ファイルを再更新

[y-chan]

内容

• 題のとおりです、 OpenAPI定義ファイルの更新と、表示の調整 #1344 の修正では、nullableではない値がnullableとして扱われていたので、それを修正するためにOpenAPI Generatorに私が作成したパッチを当てたもの(Add convert process of empty model name OpenAPITools/openapi-generator#15943)を使用します。
  • パッチが必要な理由として、最新のOpenAPI GeneratorはallOf/anyOf/oneOf/not系の定義に対し、新たに独自スキーマを定義して解釈することで、Union型などに対応する仕様があります。
    • 例として、allOfが使われているAccentPhraseスキーマの1部を取上げます

    "components":{
          "schemas":{
             "AccentPhrase":{
                "title":"AccentPhrase",
                "required":[],
                "type":"object",
                "properties":{
                   "pause_mora":{
                      "title":"後ろに無音を付けるかどうか",
                      "allOf":[
                         {
                            "$ref":"#/components/schemas/Mora"
                         }
                      ]
                   },
                },
                "description":"アクセント句ごとの情報"
             }
         }
    }
    

  • 例えば、pause_moraに対しては、titleを用いた新しい型後ろに無音を付けるかどうかを生成しようとします。
  • しかし、実際にはtitleのascii文字列以外をすべて_で置き換える処理が存在し、それによりunicodeが全て_に置き換えられて_____________という型が生成されます。
  • 実際にTypeScriptファイルを生成する際は、_はすべてパスカルケース化の影響で消し飛び、無の名前の型/型定義ファイルが生成されます。
    • 
  • それを解消するパッチを作成し、pauseMora?: Moraという型が正しく生成されるようにしました。
• 非常に手順としては面倒ですが、npmモジュール版のopenapi-generator-cliを用いずに、javaコンパイラーを実行して得たopenapi-generator-cli.jarを、READMEと同じオプションで直接実行しています。
• 新しいバージョンがリリースされればちゃんとした手段に戻したいですが、一旦この手法で定義ファイルを更新したいです(でなければライブラリ管理機能の開発が若干苦しいです)。
• ちなみに、OpenAPI Generatorの更新により、話者のisInitializeが正しくbooleanとして認識されるようになりました。

[Hiroshiba]

LGTM！！

openapi-generatorが改造版が必要な点に関して、OSSなので別の方が迷わないような道標があると良さそうかもです。

READMEの↓で、このPRをリンクして更新が難しい状態になっていることをちょっと案内するのはどうでしょう･･･？
https://github.com/VOICEVOX/voicevox/tree/a2c7784446ea32a1a58f9ffb5a0dd58c2dd73de7#openapi-generator

案内はこんな感じとか。

2023/07/02現在、openapi-generatorのパッチ修正版を使わないと更新できない状態になっています。  
詳細は[こちら](https://github.com/VOICEVOX/voicevox/pull/1361)

[y-chan]

そうですね！
案内を追加してみました！

[Hiroshiba]

"true"になってしまうとこも治ってよかった！！