OpenAPI

OpenAPI の YAML および JSON から PDF を生成

はじめに OpenAPI の YAML や JSON から、openapi-generator-cli を使って、リファレンスを HTML や Markdown を出力したりしている。 ただ、リファレンスを PDF で配りたいという要望もあり、どうしたものかと思案中。 openapi-generator-cli だけでは、直…

openapi-generator の csharp-netcore ジェネレーターで HttpClient を使ったコードを生成する

--additional-properties=library=httpclient ではなく、--libary httpclient という罠。 openapi-generator-cli generate -i swagger.json \ -g csharp-netcore \ --library httpclient \ --additional-properties=packageName=MyApi \ -o temp/csharp-netc…

OpenAPI Specification の JSON から PDF を生成する

はじめに OpenAPI Specification の JSON から、API の PDF ドキュメントを生成したい。 openapi-generator で直接 PDF を出力することはできないけど、AsciiDoc を挟むことで、最終的に PDF ドキュメントを生成できそうだったので試してみた。 OpenAPI Gene…

openapi-generator-cli でカスタムテンプレートを使う

openapi-generator-cli は jar ファイルをダウンロード。 Invoke-WebRequest -OutFile openapi-generator-cli.jar https://repo1.maven.org/maven2/org/openapitools/openapi-generator-cli/5.1.0/openapi-generator-cli-5.1.0.jar html2 ジェネレーターのテ…