golangコメント付きスワッガー仕様の生成

Question

Swaggerを使用してgolangで作成されたREST APIのドキュメントを作成しようとしています。私はこのガイドに従っています：https://goswagger.io/generate/spec.htmlこれを行うには私のメインファイルで私のコメントからjsonファイルを作成することができましたが、私は実際の掃除仕様に変換する.yamlファイルを作成する方法はわかりません。私はページの指示に従い、私のメインファイルに//go:generate swagger generate specを含めました。誰でも.yamlファイルを作成する方法を知っていますか？

Answer 1

生成された仕様は、この段階ではjsonではないyamlですが、yamlを行うことはできませんが、現在はjsonしか生成していません。

あなたがあなたのメインパッケージに注釈を付けることができます：あなたがメインパッケージのフォルダ内にあるときにgo generate：その後、あなたが仕様を生成することができます//go:generate swagger generate spec -o swagger.json

。あなたのメインパッケージがプロジェクトルートではなく、$project_root/cmd/my-serverのようなものなら、go generate ./cmd/my-serverをプロジェクトルートから実行できます。